WhatsApp API Oficial (Meta)
Além da conexão via QR Code, o Conversaas suporta a integração com a API Oficial do WhatsApp Business (Meta). Essa modalidade é recomendada para empresas que precisam de maior estabilidade, suporte oficial da Meta e acesso a recursos exclusivos como templates de mensagem aprovados.
Diferença entre QR Code e API Oficial
| QR Code | API Oficial (Meta) | |
|---|---|---|
| Configuração | Rápida, sem aprovação | Requer aprovação da Meta |
| Estabilidade | Depende do celular conectado | Infraestrutura da Meta |
| Templates | Não | Sim (HSM aprovados) |
| Limite de mensagens | Restrito | Alto volume |
| Suporte oficial Meta | Não | Sim |
| Ideal para | Testes e pequenos volumes | Produção em escala |
Pré-requisitos
Antes de conectar, você precisará ter:
- Uma conta no Meta Business Manager (business.facebook.com).
- Um número de telefone dedicado ao WhatsApp Business que ainda não esteja associado a nenhuma conta WhatsApp.
- Uma Página do Facebook vinculada ao seu negócio.
- Acesso aprovado à API do WhatsApp Business via Meta (o processo pode levar alguns dias).
Como conectar
- No menu lateral, acesse Canais > WhatsApp (API Oficial).
- Clique em "Conectar com o Facebook".
- Faça login com a conta do Meta Business Manager.
- Selecione o número de telefone que deseja conectar.
- Siga as etapas de verificação do número (código via SMS ou ligação).
- Após a verificação, o status mudará para Conectado.
Templates de Mensagem (HSM)
A API Oficial exige que mensagens iniciadas pela empresa (fora de uma conversa ativa) usem templates aprovados pela Meta, também chamados de HSM (Highly Structured Messages). Ao conectar um número, o Conversaas já cria 5 templates padrão prontos para revisão. Veja o guia completo em Templates de WhatsApp.
Janela de atendimento
Na API Oficial, quando um cliente envia uma mensagem, abre-se uma janela de 24 horas durante a qual você pode responder livremente (inclusive com IA gerando texto livre). Fora dessa janela, somente templates aprovados podem ser enviados.
O Conversaas gerencia essa janela automaticamente e de forma determinística — se o cliente estiver dentro da janela, o agente responde normalmente; fora dela, o sistema sempre usa um template aprovado, independente de qualquer configuração de IA. Veja o porquê e os detalhes em Templates de WhatsApp.
Modo de Coexistência com o aplicativo nativo
É possível usar a API Oficial no mesmo número que também está sendo usado no aplicativo nativo do WhatsApp Business no celular. Esse é o modo de coexistência, oferecido pela própria Meta.
Quando esse modo está ativo, se o dono da conta responder uma conversa diretamente pelo aplicativo do celular, o Conversaas detecta essa resposta automaticamente e pausa a IA naquela conversa — tratando como uma transferência para humano. Isso evita que o agente de IA e a pessoa respondam ao cliente ao mesmo tempo.
Dicas
- Use a API Oficial para operações de alto volume, campanhas e notificações transacionais.
- Mantenha ao menos um template de reengajamento aprovado para contatar clientes fora da janela de 24h.
- Fora do modo de coexistência, o número usado na API Oficial não pode ser usado simultaneamente em um celular — ele fica exclusivo para a API.