Inbox de WhatsApp

WhatsApp é o canal mais usado da plataforma. A conexão é sempre pela API oficial da Meta (Cloud API); não usamos intermediários.

O que você precisa

Uma conta META Business aprovada e um número de telefone dedicado. A Cloud API é grátis enquanto você está abaixo dos limites da META.

Passo a passo

1. Crie/conecte uma conta META Business

   Você precisa de:

   • Conta no business.facebook.com
   • Número de telefone dedicado (não pode estar em outro WhatsApp)
   • Verificação da empresa aprovada (CNPJ, documentos)
2. Adicione o WhatsApp Business no Meta

   Em Meta Business → Configurações da empresa → Contas → Contas do WhatsApp clique em Adicionar → Comprar um número (ou migrar um existente).

3. Pegue as 3 credenciais

   Você vai precisar de:

   • Phone Number ID — em WhatsApp → API Setup → From → ID do número
   • Business Account ID (WABA ID) — em Configurações → Conta WhatsApp Business
   • Access Token (permanente) — gere em Sistema → Usuários do sistema com permissões whatsapp_business_management e whatsapp_business_messaging
4. Conecte no Cosmobots

   No painel do Cosmobots, Configurações → Inboxes → + Nova Inbox → WhatsApp e cole as 3 credenciais.

5. Configure o webhook

   A própria plataforma gera a URL do webhook. Cole essa URL no Meta Business em WhatsApp → Configuração → Webhooks e use o Verify Token que aparece no painel.

Limites e regras importantes

Detalhes em Janela de 24 horas, Templates HSM e Opt-in / privacidade.

Capacidades suportadas

Texto, imagem, vídeo, áudio, documentos e arquivos, localização, contato (vCard), botões interativos, listas, reações com emoji, citar uma mensagem, templates HSM, status de leitura e disparos em massa.

Configurações específicas do WhatsApp

Depois de criada, a inbox WhatsApp tem campos extras em Configurações → [sua inbox]:

📇

Perfil de negócio

Nome, descrição, e-mail, telefone, endereço, site, categoria, foto. Aparece quando o cliente vê a empresa. Detalhes em perfil.

📨

Templates HSM

Aprovados pela Meta para mensagens fora da janela de 24h. Detalhes em templates.

🔁

Re-sincronizar perfil

Botão para puxar o perfil atual da Meta caso tenha mudado em outro lugar.

📷

Foto do perfil

Faça upload e o sistema sobe na Meta automaticamente.

Erros comuns

Erro	Causa provável	Como resolver
Token invalid	Token vencido (expira em cerca de 60 dias se for de usuário pessoal)	Gere um Token de Sistema permanente
Phone number not registered	Número não foi finalizado no Meta Business	Volte ao Meta e verifique o número via SMS/voz
Template not approved	Template foi rejeitado pela META	Ajuste o conteúdo e reenvie para aprovação
Mensagem não chega ao cliente	Janela 24h fechada e sem template aprovado	Use template ou peça pro cliente iniciar
Webhook não confirma	Verify Token errado ou URL incorreta	Re-cole o token exato do painel

Próximos passos

• Janela de 24 horas: a regra mais importante
• Templates HSM: como criar e usar
• Tipos de mensagem: botões, listas, mídia
• Disparos em massa: campanhas e broadcasts