Como conectar o WhatsApp na API oficial usando a Ola SecretarIA

Publicado em 20 de August de 2026

Como conectar o WhatsApp na API oficial usando a Ola SecretarIA

Como conectar o WhatsApp na API oficial usando a Ola SecretarIA

Conectar o seu número na API oficial é simples, mas é um processo que não perdoa desatenção. Um passo pulado e a conexão trava, ou pior: conecta e não envia mensagem nenhuma.

A boa notícia é que são poucos passos e todos previsíveis. Neste artigo você vai ver o caminho completo, incluindo a verificação que precisa acontecer antes de começar e o detalhe que mais deixa gente conectada sem conseguir disparar nada.

Antes de tudo, você precisa ter o WhatsApp Business instalado no aparelho com o número que vai ser conectado.

Passo 1: verifique se o número já está conectado em outra plataforma

Este é o passo que a maioria pula e depois não entende por que a conexão falha.

A Meta não permite que o mesmo número esteja conectado em duas plataformas ao mesmo tempo. Se o seu número já está ligado a algum outro sistema, a conexão simplesmente não avança.

Para verificar, no WhatsApp Business:

  1. Toque nos três pontinhos

  2. Vá em Configurações

  3. Entre em Conta

  4. Toque em Plataforma comercial

Se aparecer que o número está conectado a alguma plataforma, você precisa desconectar antes de seguir. Toque em desconectar, avance e confirme.

Com o número livre, pode começar.

Passo 2: inicie a conexão pela Ola SecretárIA

Dentro da Ola SecretárIA, procure por WhatsApp oficial e toque no botão configurar, no topo.

Isso abre uma tela do Facebook, e é lá que os próximos passos acontecem. Basicamente três decisões:

  • Qual empresa você vai conectar

  • Qual número você vai conectar

  • Escanear o QR code para efetivar a conexão

Toque em continuar para começar.

Passo 3: selecione a empresa e o tipo de conta

Primeiro você escolhe o BM do Facebook (o Gerenciador de Negócios) ao qual o número está vinculado. Selecione a empresa correta.

Depois vem o passo mais importante desta tela: você precisa selecionar a opção de conectar um app do WhatsApp Business, e não a conta comum do WhatsApp Business.

São opções parecidas, com ícones diferentes. Escolher a errada aqui é o motivo mais frequente de conexão que não funciona. Vale conferir duas vezes antes de avançar.

Passo 4: informe o número

Na tela seguinte, digite o número que vai ser conectado, com DDD, e avance.

Se aparecer o sinal de confirmação ao lado do número, é bom sinal. Isso indica que o número está liberado, ou seja, não está restrito, banido ou bloqueado, e a conexão pode prosseguir.

Toque em avançar.

Passo 5: escaneie o QR code do jeito certo

Aqui está a parte que mais confunde, então leia com atenção.

O Facebook vai gerar um QR code. Você precisa escanear esse QR code a partir de uma mensagem que o próprio Facebook envia para o seu WhatsApp, e não pela tela de dispositivos conectados.

Repetindo, porque é importante: não use dispositivos conectados. Essa é uma conexão com a API oficial e ela precisa ser iniciada pela mensagem do Facebook.

O caminho é:

  1. Abra a mensagem que o Facebook enviou no seu WhatsApp

  2. Toque na opção de conectar à plataforma comercial

  3. Escolha se quer ou não compartilhar as conversas, o que traz o histórico antigo para dentro da Ola SecretárIA

  4. Escaneie o QR code

O processo pode levar de um a três minutos, dependendo do volume de mensagens que existe naquele telefone. É normal, deixe rodando.

Passo 6: cadastre a forma de pagamento (não pule)

Conexão feita, mas o trabalho ainda não acabou.

Para a API oficial funcionar de verdade, ou seja, para você conseguir fazer disparos e enviar promoções para as suas clientes, é obrigatório ter uma forma de pagamento configurada no Facebook.

Três coisas que você precisa saber sobre isso:

É separada da forma de pagamento dos anúncios. Mesmo que você já rode tráfego pago e tenha cartão cadastrado lá, esta é outra configuração.

É específica por número. Se a sua empresa tem vários números e você vai conectar todos na API oficial, cada número precisa da própria forma de pagamento.

Sem cartão, não sai mensagem. O Facebook não permite o envio. A conexão vai aparecer como ativa, mas nada é entregue.

Para cadastrar, antes de fechar a tela de confirmação, toque em adicionar forma de pagamento. O Facebook abre a tela de configuração daquele número. Se não houver cartão ali, cadastre um.

Passo 7: confirme que deu certo

Ao voltar para a Ola SecretárIA, a plataforma solta uma animação de confete comemorando a conexão bem-sucedida. É o sinal visual de que deu tudo certo.

Para confirmar por outro caminho, volte no seu WhatsApp Business em Configurações > Conta > Plataforma comercial. Deve aparecer que a plataforma comercial está conectada.

Por que a API oficial vale a pena

Vale entender o que você ganha com essa conexão, além de poder disparar campanhas.

Quando você usa a API oficial, o seu número não ocupa um dos slots de dispositivos conectados. E, principalmente, ele não fica caindo. Conexões via dispositivos conectados desconectam sozinhas com frequência, e cada queda significa mensagem não respondida.

A conexão direta com a API oficial é bem mais estável. Para quem depende do WhatsApp para vender, isso é a diferença entre atendimento que funciona e atendimento que some no meio do dia.

Perguntas frequentes

Preciso trocar o número da minha empresa? Não. A conexão é feita com o número que você já usa no WhatsApp Business.

Meu número já está em outra plataforma. E agora? Você precisa desconectar antes. O caminho é Configurações > Conta > Plataforma comercial > desconectar.

Onde escaneio o QR code? Pela mensagem que o Facebook envia no seu WhatsApp, tocando na opção de conectar à plataforma comercial. Não use a tela de dispositivos conectados.

Posso trazer o histórico das conversas antigas? Sim. Durante a conexão aparece a opção de compartilhar as conversas. Você escolhe se quer ou não.

Por que preciso cadastrar um cartão? Porque o Facebook cobra pelas mensagens enviadas via API oficial. Sem forma de pagamento cadastrada, ele não autoriza os envios.

Tenho três números na empresa. Preciso cadastrar cartão em cada um? Sim. A forma de pagamento é específica por número.

Quanto tempo demora a conexão? O escaneamento costuma levar de um a três minutos, variando com o volume de mensagens no aparelho.

Quer automatizar os seus agendamentos?

Comece a utilizar a Ola SecretarIA

Cadastre-se agora

Veja também

Utilizamos cookies para melhorar a sua experiência, análise de tráfego, segurança e marketing. Ao continuar a utilizar nossos serviços, você concorda com nossos Termos de uso e Política de privacidade.