📱 Primeiros Passos

Como conectar o WhatsApp Cloud API ao Chatys

8 min de leitura Atualizado em Jan 2025

O Chatys utiliza a WhatsApp Cloud API oficial da Meta, que garante conformidade com os termos de uso, sem risco de banimento e com acesso a todas as funcionalidades mais recentes, incluindo botões interativos, listas, templates HSM e catálogos.

Pré-requisito: Você precisa de uma conta Meta Business Manager verificada e de um número de telefone exclusivo para o WhatsApp Business (que não esteja cadastrado em nenhum app WhatsApp no momento).

Passo 1 — Criar o App no Meta for Developers

1
Acesse developers.facebook.com e clique em "Meus Apps" → "Criar App".
2
Selecione o tipo "Business" e dê um nome ao seu app (ex: Chatys Atendimento).
3
Após criar, vá em "Adicionar Produto" e selecione WhatsApp.
4
Associe ao seu Meta Business Manager na tela de configuração do WhatsApp.

Passo 2 — Configurar o número de telefone

1
No painel do WhatsApp, clique em "Adicionar número de telefone".
2
Escolha um nome de exibição e categoria para seu negócio.
3
Insira o número de telefone e verifique com o código SMS ou ligação telefônica.
Atenção: O número deve estar livre de qualquer conta WhatsApp pessoal ou Business. Se já tiver uma conta ativa nesse número, você precisará excluí-la primeiro.

Passo 3 — Obter as credenciais da API

Você precisará de 3 informações do Meta para configurar no Chatys:

  • Phone Number ID — identificador único do seu número
  • WhatsApp Business Account ID (WABA ID)
  • Access Token permanente — gerado via System User no Business Manager
1
No painel do app, copie o Phone Number ID e o WhatsApp Business Account ID.
2
No Business Manager, crie um System User com papel de Admin e gere um token permanente com permissões whatsapp_business_messaging e whatsapp_business_management.

Passo 4 — Configurar no Chatys

1
No Chatys, vá em Configurações → Canais → WhatsApp.
2
Clique em "Adicionar Canal WhatsApp" e preencha:
  • Nome do Canal (ex: Suporte Principal)
  • Phone Number ID
  • WABA ID
  • Access Token
3
Copie a URL do Webhook gerada pelo Chatys e o Verify Token.

Passo 5 — Configurar o Webhook no Meta

1
No painel do app Meta, vá em WhatsApp → Configuração → Webhooks.
2
Cole a URL do Webhook e o Verify Token copiados do Chatys.
3
Clique em "Verificar e Salvar". O Meta vai fazer uma chamada de verificação ao Chatys — se tudo estiver certo, aparecerá um ✅ verde.
4
Assine os eventos: messages, message_deliveries, message_reads, messaging_handovers.
Pronto! Após salvar, envie uma mensagem de teste para o número configurado. Ela deve aparecer no Inbox do Chatys em poucos segundos. 🎉

Solução de problemas comuns

  • Webhook retorna erro 403 — O Verify Token está diferente entre Meta e Chatys. Verifique e repita.
  • Mensagens não chegam — Confirme que assinou o evento messages no webhook.
  • Token expirado — Tokens temporários expiram em 24h. Use sempre um System User para token permanente.
  • Número já em uso — Remova o número de qualquer conta WhatsApp antes de cadastrar na API.

Este artigo foi útil?