Todos os artigos

Como conectar a API oficial do WhatsApp e conferir se está tudo certo

Começar6 min de leitura

Vídeo relacionado do Rumo Academy · ver todas as trilhas

Para que serve: ligar um número da API oficial da Meta ao CRM para atender no inbox e disparar campanhas, e saber o que fazer quando as mensagens param de chegar.

O que você precisa

  • Plano: qualquer um. A API oficial está no Essencial, no Pro e no Business. No Essencial ela ocupa o único número do plano (Como conectar seu WhatsApp).

  • Permissão: só o gerente.

  • Antes: a conta do WhatsApp Business da sua empresa na Meta (WABA), com o número já cadastrado nela, e três dados:

    • o WABA ID;
    • o Phone Number ID do número;
    • um Access Token permanente (System User Token), gerado no Meta Business Suite com as permissões whatsapp_business_messaging e whatsapp_business_management.

    A conexão pela API oficial é feita pelo time Rumo: fale com a equipe antes de começar (Como tirar dúvidas e falar com o suporte dentro do CRM). Se o token for de um app próprio da sua empresa na Meta, as respostas dos clientes só chegam ao CRM depois que o time Rumo configurar.

Passo a passo

Quem conecta o número é o time Rumo. Os passos abaixo mostram o que ele faz na sua conta e o que você confere depois.

  1. Em Configurações, abra Integrações e a seção Canais. Vá ao card WhatsApp Cloud API (Meta) e clique em Adicionar Número Meta. Abre a janela Configurar WhatsApp Cloud API. Botão Adicionar Número MetaBotão Adicionar Número Meta

  2. Preencha Nome (opcional), WABA ID, Phone Number ID e Access Token e clique em Salvar e Conectar. O CRM confere o token com a Meta antes de salvar. Se você trocou o WABA ID e o Phone Number ID de lugar, ele corrige sozinho. Se o token não for do app do Rumo CRM, aparece o aviso "Conexão com app próprio da Meta: as respostas dos clientes só chegam se o time Rumo configurar. Fale com a equipe antes de usar." Formulário Configurar WhatsApp Cloud APIFormulário Configurar WhatsApp Cloud API

  3. Ao salvar, o CRM registra o número na Meta e inscreve o app na sua WABA, já apontando as mensagens para o CRM. O número aparece com os selos Meta API e Conectado. Clique em Testar: aparecem o nome verificado, o número e a nota de qualidade da Meta. Número oficial com o botão TestarNúmero oficial com o botão Testar

  4. Ligue o número ao inbox. Sem este passo, as conversas dele não entram em Conversas.

    1. No card Canais do Inbox, clique em Adicionar canal.
    2. Escolha Meta Cloud (oficial) e a aba Número já conectado.
    3. Selecione o número em Número Meta Cloud, dê um Nome do canal e clique em Conectar canal.

    Se o número não aparece na lista, é porque ele já está ligado ao inbox. Adicionar canal com Número já conectadoAdicionar canal com Número já conectado

  5. Depois do primeiro número, o card mostra a Webhook URL e, em cada número, o Verify Token. O CRM já faz essa configuração ao salvar. Use esses dois valores só se você for configurar o webhook do app à mão no painel da Meta. Webhook URL e Verify TokenWebhook URL e Verify Token

  6. Se as mensagens não chegam ou não saem, clique em Diagnóstico. O painel mostra:

    • Token: de qual app ele é, se é válido e quando expira;
    • WABA: nome, ID e status de revisão da conta na Meta;
    • Apps inscritos na WABA: o app do seu token aparece como Rumo CRM (correto). Os demais aparecem como remover.

    Clique em Inscrever app na WABA para refazer a inscrição e em Atualizar status para consultar a Meta de novo. Painel de Diagnóstico do númeroPainel de Diagnóstico do número

  7. Se o token venceu ou foi trocado na Meta, clique em Trocar Access Token, cole o novo token e clique em Validar e salvar. Se o número estiver Desconectado, clique em Reconectar.

  8. Em Conversas, as conversas desse número têm o selo META. Pela regra do WhatsApp, você escreve livremente até 24 horas depois da última mensagem do cliente. Passado esse prazo, só sai template aprovado, pelo botão Enviar template (Como atender uma conversa no inbox). Selo META na conversaSelo META na conversa

Se algo der errado

O que aparecePor que aconteceO que fazer
"O Access Token expirou ou foi revogado. Gere um novo System User Token permanente no Meta Business Suite e cole aqui."O token venceu ou foi revogado na MetaGere um token permanente e use Trocar Access Token
"O token não tem as permissões necessárias. Ao gerar o System User Token, marque os escopos whatsapp_business_messaging e whatsapp_business_management."Faltam permissões no tokenGere o token de novo com as duas permissões
"A Meta não encontrou esta WABA ou Phone Number ID, ou o token não tem acesso a eles. Confira se os IDs estão corretos e se o token pertence ao mesmo app dono desta WABA."ID errado ou token de outro appCopie os IDs de novo no Meta Business Suite e confira o token
"Mais de um app inscrito nesta WABA" (no Diagnóstico)Outro app recebe as mensagens no lugar do CRMRemova os outros apps no Meta Business Manager → WhatsApp → Configurações, deixando só o do CRM
"App do token não está inscrito na WABA" (no Diagnóstico)O app do token não recebe as mensagens da WABAClique em Inscrever app na WABA
"Conexão com app próprio da Meta: as respostas dos clientes só chegam se o time Rumo configurar. Fale com a equipe antes de usar."O token é de um app próprio da sua empresa na Meta. O CRM só recebe as respostas pelo app deleFale com a equipe antes de usar o número (Como tirar dúvidas e falar com o suporte dentro do CRM)
Você envia, mas as respostas dos clientes não chegamFalta o canal do inbox, outro app está inscrito ou o token é de um app próprio da MetaConfira o passo 4 e rode o Diagnóstico. Se o número mostra o aviso de app próprio, fale com a equipe
"Token inválido ou expirado. Gere um novo token no Meta Business Suite." (ao clicar em Testar)O token salvo não funciona maisUse Trocar Access Token
"O plano Essencial inclui 1 WhatsApp. Faça upgrade para o Pro ou Business para conectar até 10 números."O Essencial já tem 1 númeroMude de plano (Como mudar de plano e ajustar o número de assentos) ou remova o número atual

O que este recurso não faz

  • Não conecta pelo login do Facebook. A conexão é sempre pelo formulário, com WABA ID, Phone Number ID e Access Token.
  • Não recebe as respostas por um app próprio da sua empresa na Meta sem a configuração do time Rumo. Por isso a conexão é feita pela equipe.
  • Não traz conversas antigas do número. Só entram as mensagens que chegam depois da conexão.
  • Não sincroniza os contatos do celular: Sincronizar do WhatsApp funciona só com número de QR code.
  • Não libera texto livre fora da janela de 24h. Mandar um template também não abre a janela: ela abre quando o cliente responde.
  • Não cobra as mensagens pelo CRM. A Meta cobra os templates direto na conta da sua WABA.

Relacionados

Esse artigo te ajudou?

Para que serve no time de vendas

API oficial do WhatsApp no Rumo CRM

API oficial do WhatsApp (WhatsApp Business API) ligada ao CRM: o time atende o mesmo número, com chatbot e campanha por template aprovado.

Continuar lendo em Começar

Ainda com dúvida sobre isso?

Manda mensagem direto — sem fila, sem bot dando volta.

Artigo da Central de Ajuda Rumo CRM