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 Abrir tela.
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
- Selecione Total em nuvem ou Com coexistência.
- Clique em Integrar com a Meta.
- Na janela da Meta, entre com o usuário que possui acesso administrativo.
- Selecione ou crie o negócio e a conta do WhatsApp solicitados pelo fluxo oficial.
- Escolha o número que será compartilhado com a Agilize.
- Revise as permissões apresentadas pela Meta e conclua a autorização.
- 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:
- Envie uma mensagem de outro telefone para o número integrado.
- Confirme se a conversa foi criada na Agilize.
- Verifique se o fluxo e o departamento configurados foram aplicados.
- Confirme se a conversa chegou ao Flow do usuário responsável.
- Responda pela Agilize e valide a entrega no WhatsApp.
- 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.
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.
- Prepare fluxos do bot quando houver triagem automática.
- Crie modelos de mensagem WhatsApp para retomadas e envios ativos.
- Execute o checklist de go-live antes de divulgar o número.