# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-09-04T17:55:01.333Z ## Página - Título: Integrar uma conta do WhatsApp pela Meta - URL humana: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/integrar-whatsapp-meta - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Escolha o modo de integração, autorize a conta na Meta e prepare o número do WhatsApp para atendimento na Agilize. ## Seções - Antes de começar - Escolha como o número vai operar - Autorize a conta na Meta - Configure o número integrado - Valide antes de divulgar - Problemas comuns - O botão fica em “Abrindo a Meta”, mas a janela não aparece - A Meta autorizou, mas a Agilize não concluiu ## Conteúdo da página # Integrar uma conta do WhatsApp pela Meta Use este guia para conectar um novo número pela integração oficial da Meta. A autorização acontece em uma janela da Meta e, quando concluída, cria ou atualiza na Agilize a conta empresarial e os números liberados por ela. ## Antes de começar Confirme que: - você é administrador na Agilize; - possui acesso administrativo ao negócio e à conta do WhatsApp na Meta; - o número que será conectado está disponível e elegível para o modo escolhido; - o navegador permite abrir pop-ups da Agilize e da Meta; - você fez backup no aplicativo quando existe histórico que precisa permanecer disponível no celular. Acesse :ScreenEntry{href="https://my.agilize.app/messenger/meta/phone" label="https://my.agilize.app/messenger/meta/phone" path="sidebar lateral > módulo Mensageria > Configurações > tree interna Canais Integrados > Contas do WhatsApp. Depois clique em Integrar Novo WhatsApp."}. Acesso pela tela: sidebar lateral > módulo **Mensageria** > **Configurações** > tree interna **Canais Integrados** > **Contas do WhatsApp**. Depois clique em **Integrar Novo WhatsApp**. ## Escolha como o número vai operar O modal **Integrar WhatsApp** oferece dois modos: | Modo | Quando usar | Cuidados | | --- | --- | --- | | **Total em nuvem** | Para uma operação centralizada, estável e sem dependência do celular. É a opção recomendada para equipes e escala. | A conta do número precisa ser removida do aplicativo antes da integração. | | **Com coexistência** | Quando o WhatsApp Business precisa continuar funcionando no celular em paralelo à API oficial. | Há menos controle central sobre mensagens e acessos. O histórico que permanecer no aplicativo não é importado para a Agilize. | A Agilize passa a registrar as novas conversas recebidas depois da conexão. O histórico antigo não é sincronizado para a plataforma. ## Autorize a conta na Meta 1. Selecione **Total em nuvem** ou **Com coexistência**. 2. Clique em **Integrar com a Meta**. 3. Na janela da Meta, entre com o usuário que possui acesso administrativo. 4. Selecione ou crie o negócio e a conta do WhatsApp solicitados pelo fluxo oficial. 5. Escolha o número que será compartilhado com a Agilize. 6. Revise as permissões apresentadas pela Meta e conclua a autorização. 7. Aguarde a confirmação **Integração realizada com sucesso** na Agilize. Se a janela não abrir, libere pop-ups para a Agilize e tente o botão novamente. Se você fechar ou cancelar a autorização na Meta, nenhuma integração é concluída e o processo pode ser reiniciado com segurança. ## Configure o número integrado Depois da autorização, volte para **Contas do WhatsApp** e abra o número criado. Revise principalmente: - **Nome de exibição** e telefone conectados; - **Fluxo Atendimento - ChatBot**, quando a conversa deve iniciar com automação; - **Departamento Padrão**, para definir a área que receberá as conversas; - **Enviar Nome do Agente**, quando a identificação do atendente deve acompanhar a mensagem; - **Gerar Protocolo**, se a operação utiliza protocolo de atendimento; - **Restrito aos Usuários**, quando somente pessoas específicas podem iniciar conversas pelo número. Conectar o número sem definir destino, fluxo e responsáveis pode deixar novas conversas fora da rotina esperada. ## Valide antes de divulgar Faça um teste completo: 1. Envie uma mensagem de outro telefone para o número integrado. 2. Confirme se a conversa foi criada na Agilize. 3. Verifique se o fluxo e o departamento configurados foram aplicados. 4. Confirme se a conversa chegou ao Flow do usuário responsável. 5. Responda pela Agilize e valide a entrega no WhatsApp. 6. Conclua a conversa e confira se o histórico ficou preservado. Para mensagens iniciadas pela empresa fora da janela livre, prepare também [modelos de mensagem WhatsApp](/docs/configuracao/canais-whatsapp-integracoes/cadastro-de-modelos-de-mensagem-whatsapp). ## Problemas comuns ### O botão fica em “Abrindo a Meta”, mas a janela não aparece Permita pop-ups no navegador para `my.agilize.app` e `facebook.com`, feche o modal e abra-o novamente. Extensões de privacidade também podem impedir a abertura da autorização. ### A Meta autorizou, mas a Agilize não concluiu Tente novamente sem trocar de negócio, conta ou número durante o processo. Se o erro persistir, informe ao suporte qual modo foi escolhido e em qual etapa a Meta encerrou a autorização, sem enviar senhas, códigos ou tokens. ### O número aparece, mas não recebe mensagens Abra o cadastro do número e revise seu estado, fluxo e departamento. Depois envie uma nova mensagem de teste. Se o problema começou após uma alteração na Meta, confirme se o número continua vinculado à mesma conta do WhatsApp e se as permissões da integração permanecem ativas. ## Próximos passos - Configure [departamentos e distribuição](/docs/configuracao/roteamento-distribuicao/regras-de-roteamento-e-distribuicao). - Prepare [fluxos do bot](/docs/configuracao/fluxos-automacoes/fluxos-do-bot) quando houver triagem automática. - Crie [modelos de mensagem WhatsApp](/docs/configuracao/canais-whatsapp-integracoes/cadastro-de-modelos-de-mensagem-whatsapp) para retomadas e envios ativos. - Execute o [checklist de go-live](/docs/configuracao/implantacao-go-live/checklist-go-live) antes de divulgar o número.