Ir para o conteúdo
AVYD Central

Passo 6

Ligar o WhatsApp do sistema (Meta Cloud API)

Quando o sistema precisa avisar o anfitrião que chegou visita e mandar os alertas das regras de automação pelo WhatsApp.

cerca de 110 sTela: /integracoesIntegrações

Antes de começar

  • Uma conta do WhatsApp Business já aprovada na Meta, com o Phone Number ID, o WABA ID e um Auth Token permanente em mãos.
  • O painel de desenvolvedores da Meta aberto em outra aba: é lá que você cadastra o webhook.
  • O endereço do sistema alcançável pela internet, porque é nele que a Meta entrega as respostas.

Passo a passo

  1. 01

    Na lista da esquerda, no grupo Comunicação, abra o WhatsApp. É por esse canal que o sistema avisa o anfitrião quando chega visita e manda os alertas das regras de automação.

  2. 02

    Ligue a chave Habilitar Disparos via WhatsApp. Enquanto ela estiver desligada, o sistema guarda a configuração mas não envia mensagem nenhuma.

  3. 03

    Em Provedor padrão (global), troque Umbler Talk por Meta Oficial (Cloud API). É o caminho oficial: a mensagem sai do número da empresa e não depende de nenhum celular ligado.

    Meta Oficial (Cloud API)
  4. 04

    Clique em Salvar, o botão que fica ao lado do seletor, ainda neste bloco de cima. Um Salvo verde aparece do lado.

  5. 05

    Logo abaixo, em Configuração por provedor, vá ao cartão Meta Oficial (Cloud API) e informe o Phone Number ID. Ele é o número de identificação que a Meta deu ao seu telefone, não o telefone em si.

    109876543210987
  6. 06

    Agora o WABA ID (WhatsApp Business Account), que identifica a conta comercial. Os dois ficam lado a lado na mesma tela da Meta.

    245678901234567
  7. 07

    Cole o Auth Token gerado na Meta. Ele é guardado cifrado e nunca mais volta a aparecer na tela — aqui na gravação eu digito um valor de mentira, você cola o seu.

  8. 08

    O Verify Token (do Webhook) é você que inventa: uma senha combinada entre o sistema e a Meta. Guarde essa mesma palavra, ela vai ser pedida daqui a pouco.

    avyd_portaria_2026
  9. 09

    No quadro pontilhado Painel de desenvolvedores da Meta, o sistema monta a URL de retorno (Callback URL) pronta e repete embaixo o Verify Token que você acabou de digitar. Copie os dois para o cadastro do webhook, lá na Meta: é por aí que as respostas do WhatsApp voltam para cá.

  10. 10

    Clique em Salvar, agora o botão de dentro do cartão do Meta. Os campos ficam em branco de novo: o que você digitou foi guardado cifrado.

  11. 11

    Como já havia uma configuração do Meta guardada, o sistema pergunta antes de trocar: Substituir configuração. Confirmo. É para isso que esse aviso existe — credencial salva não se troca por engano, se troca por decisão. Numa instalação nova ele não aparece, e o salvamento vai direto.

    So existe quando temConfig e verdadeiro. Numa .14 recem-instalada o passo e pulado. Ate 22/09 este passo era `opcional: true` (mostrava e nao clicava) e o dialogo ficava aberto por cima do fecho, com a narracao descrevendo o cartao verde que ninguem via. O dono autorizou a substituicao em 22/09.

  12. 12

    Com a configuração salva, nasce aqui o botão Testar. Ele manda uma mensagem de verdade pelo número da sua conta Meta — por isso não é clicado neste vídeo, que usa identificadores de exemplo. No seu sistema, é ele que prova que o número está falando.

Como conferir

No cartão Meta Oficial (Cloud API) a etiqueta cinza Sem configuração vira a verde Configurado, os campos voltam a ficar em branco e o botão Testar Conexão aparece ao lado de Salvar. Daí em diante o aviso de visitante e os alertas das regras saem pelo WhatsApp.

Se der errado
Testar Conexão responde Falha na conexão
Quase sempre é Auth Token vencido ou Phone Number ID de outro número. Gere um token permanente no painel da Meta e confira os dois identificadores.
A Meta não valida o webhook
A URL de retorno precisa ser alcançável pela internet, com certificado válido, e o Verify Token tem que ser exatamente o mesmo dos dois lados.
O sistema pergunta Substituir configuração
Já havia uma configuração salva para o Meta. Confirme para trocar pelos valores de agora; campo deixado em branco mantém o que estava guardado.
Salvou, mas ninguém recebe a mensagem
Confira se a chave Habilitar Disparos via WhatsApp ficou ligada e se o Provedor padrão (global) é o Meta Oficial (Cloud API). Fora da janela de 24 horas, a Meta só entrega mensagem por template aprovado.