WhatsApp Oficial (Cloud API)

Conecte um número ao Notfy pela API oficial do WhatsApp (Meta): crie a integração, informe as credenciais, configure o webhook e verifique a conexão.

A integração WhatsApp (Meta Oficial) conecta um número à API oficial do WhatsApp. Com ela você atende no chat, envia modelos de mensagem aprovados e faz campanhas dentro das regras da Meta.

​

Quando usar

Use para conectar o número principal da empresa de forma oficial. A quantidade de números que você pode conectar depende do plano e aparece em Configurações da empresa, aba Consumo, seção WhatsApp (Slots).

​

Antes de começar

• Uma conta no Meta Business Suite com acesso ao Meta for Developers.
• Um número dedicado ao WhatsApp Business na Cloud API.
• Um aplicativo criado no Meta for Developers com o produto WhatsApp.

​

Formas de conexão

Forma	Como funciona
Conexão Rápida	A Meta preenche os campos por você, com o botão Conectar com Meta (Embedded Signup)
Conexão Manual	Você informa os IDs e o token gerados no Meta for Developers

A Conexão Rápida só aparece depois que a integração é salva e quando o cadastro ainda não tem credenciais manuais. Se ela não estiver disponível, use a Conexão Manual.

​

Conectar manualmente

1. Crie a integração

   Em Ajustes, Integrações, crie uma integração. Em Tipo de integração, escolha WhatsApp (Meta Oficial), informe o Nome da integração (por exemplo, WhatsApp Vendas) e salve. As abas específicas só aparecem depois de salvar.

2. Abra a aba do WhatsApp

   Na integração salva, abra a aba WhatsApp (Meta Oficial).

3. Preencha a Conexão Manual

   Informe os dados do Meta for Developers e salve.

4. Configure o webhook na Meta

   Em Configuração de Webhook, copie a Webhook Callback URL. Clique no ícone de gerar token para criar o Webhook Verify Token e salve. Depois, no Meta for Developers, abra WhatsApp, Configuração, Webhooks, cole a URL e o token e assine o evento de mensagens.

5. Verifique a conexão

   Em Credenciais Meta Cloud, clique em Verificar Conexão. Se tudo estiver certo, aparece Conexão Bem-sucedida! e o status muda para Conectado.

​

Campos da Conexão Manual

Campo	Onde encontrar na Meta
Phone Number ID	WhatsApp, Configuração da API
WhatsApp Business Account ID	Topo da mesma página de configuração da API
Permanent Access Token	Token permanente gerado nas configurações do aplicativo
App Secret	Configurações, Básico, “Chave secreta do app”. Valida cada mensagem recebida

O token e o App Secret não são exibidos depois de salvos. Ao editar, deixe em branco para manter os valores atuais.

​

Ativar o número (migração)

O botão Ativar Número (Registro) é necessário apenas se você migrou um número que já estava no aplicativo WhatsApp Business. Ele pede o PIN de 6 dígitos da verificação em duas etapas, que não é o código recebido por SMS.

Tentativas com PIN incorreto podem bloquear o número temporariamente. Se você esqueceu o PIN, redefina-o no painel da Meta.

​

Mensagens e janela de atendimento

O canal aceita mensagens de texto, imagem, áudio, documento, vídeo, localização e modelos de mensagem. Fora da janela de 24 horas após a última mensagem do cliente, o WhatsApp não aceita texto livre: use um modelo aprovado pela Meta.

O Notfy envia a mensagem, mas a Meta pode recusá-la por regras do canal, modelo não aprovado, conteúdo inválido ou falha de mídia. Quando isso acontece, confira o status da mensagem no chat e corrija o conteúdo ou o modelo.

Alguns contatos podem chegar identificados por um identificador comercial do WhatsApp, sem número de telefone. O Notfy usa essa identidade para localizar o contato e responder; portanto, a ausência de telefone não significa necessariamente que a mensagem foi perdida.

Se a conta tiver mais de um número oficial ativo, o recebimento pode ser associado ao primeiro número ativo encontrado para a empresa. Para evitar roteamento inesperado, mantenha apenas o número necessário ativo ou confirme a configuração com o administrador.

​

Comportamento do canal

Na seção Comportamento Oficial:

Campo	Descrição
Modo de Atendimento	Inteligência Artificial, ou Fluxo Fixo (construtor visual, sem IA). Aparece quando a empresa define a IA por canal
Ativar IA neste número	Liga a IA no número. Usa provedores de IA nos EUA e exige concordar com a transferência internacional de dados
Abrir Editor de Fluxo	Abre o construtor visual, quando o modo é Fluxo Fixo
Criação Automática de Leads	Cria o lead no funil quando um novo contato escreve

​

Perguntas frequentes

As mensagens dos clientes não chegam

Confirme que a URL e o token de verificação foram colados no Meta for Developers e que o evento de mensagens está assinado. Depois clique em Verificar Conexão.

A conexão falhou

Confira o Phone Number ID, o WhatsApp Business Account ID e o token. O aviso pede para revisar esses dados.

Não consigo enviar mensagem a um cliente

Fora da janela de 24 horas após a última mensagem do cliente, só é possível enviar modelos de mensagem aprovados.

Posso enviar áudio, documento ou localização?

Sim. O canal suporta áudio, documentos, imagens, vídeos e localização, além de texto e modelos. A Meta ainda pode aplicar limites e validações próprios para cada mídia.

Modelos de mensagem

Crie e acompanhe os modelos aprovados.

Chat de atendimento

Atenda as conversas do canal.

Instagram Direct

Conecte também o Instagram.