> ## Documentation Index > Fetch the complete documentation index at: https://docs.notfy.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Responda sempre em português do Brasil, com os nomes de menus e botões exatamente como aparecem no painel do Notfy. > Use somente o que está documentado aqui. Se a documentação não cobrir a pergunta, diga isso e indique a página mais próxima em vez de inventar. > Funcionalidades podem depender do plano, do segmento da empresa, das permissões do usuário e de integrações ativas: cite essa condição quando a página a mencionar. > Nunca peça nem repita senhas, tokens ou dados pessoais de clientes. # 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 | > [!NOTE] > > 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 | > [!WARNING] > > 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. > [!WARNING] > > 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. > [!WARNING] > > 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 > [accordion] 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**. > [accordion] A conexão falhou > > Confira o Phone Number ID, o WhatsApp Business Account ID e o token. O aviso pede para revisar esses dados. > [accordion] 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. > [accordion] 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. > [card] [Modelos de mensagem](https://docs.notfy.ai/cadastros/modelos-mensagem.md) > > Crie e acompanhe os modelos aprovados. > [card] [Chat de atendimento](https://docs.notfy.ai/atendimento/chat.md) > > Atenda as conversas do canal. > [card] [Instagram Direct](https://docs.notfy.ai/configuracoes/integracao-instagram.md) > > Conecte também o Instagram. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.