Inbox de WhatsApp

WhatsApp é o canal mais usado da plataforma. Você pode conectar via 4 provedores diferentes — todos chegam no mesmo Help Desk e seguem as mesmas regras da META.

Qual provedor escolher?

☁️

Cloud API (META) recomendado

Direto da Meta, sem intermediário. Mais barato, mais estável, sem limite de provider.

🟣

Twilio

Para quem já é cliente Twilio ou usa SMS Twilio em paralelo.

🟠

Gupshup

Provedor BR popular. Bom suporte local, mas com taxas adicionais.

🔵

360Dialog

Provedor europeu, foca em deliverability. Recomendado para volumes muito altos.

Não sabe qual escolher?

Comece com Cloud API. É grátis enquanto você está abaixo dos limites da META e só exige uma conta META Business aprovada.

Cloud API — 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 → Cloud API 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

Recurso	Cloud API	Twilio	Gupshup	360Dialog
Texto, imagem, vídeo, áudio	✅	✅	✅	✅
Documentos / arquivos	✅	✅	✅	✅
Localização	✅	✅	✅	✅
Contato (vCard)	✅	✅	✅	✅
Botões interativos	✅	✅	✅	✅
Listas	✅	✅	✅	✅
Reações com emoji	✅	✅	✅	✅
Quote / citar mensagem	✅	✅	✅	✅
Templates HSM	✅	✅	✅	✅
Status de leitura	✅	✅	✅	✅
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 ~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