WhatsApp

O GetMyBot conecta o WhatsApp via WhatsApp Cloud API (Meta Graph API). Após a conexão, o bot recebe as mensagens de entrada do WhatsApp e aplica a elas as suas reações, e os operadores podem conduzir a conversa nos diálogos. A visão geral do recurso multicanal está na página Canais.

Conexão do canal WhatsApp

Para conectar, são necessárias cinco credenciais do seu aplicativo Meta (WhatsApp Cloud API). Todas são obrigatórias:

  • Phone number ID — identificador do número do WhatsApp Business.
  • WABA ID — identificador da WhatsApp Business Account.
  • Access token — token de acesso do aplicativo Meta.
  • Verify token — uma string arbitrária que você mesmo define. Ela é usada na verificação do webhook na Meta (veja abaixo).
  • App secret — segredo do aplicativo Meta. Necessário para verificar a assinatura HMAC dos webhooks de entrada (cabeçalho X-Hub-Signature-256).

Passos na interface:

  1. Abra Bots → "Adicionar canal" → WhatsApp.
  2. Preencha os cinco campos acima e, se quiser, o nome do canal (opcional).
  3. Clique em "Verificar" — o GetMyBot valida as credenciais via Meta.
  4. Clique em "Conectar".

Configuração do webhook na Meta

Após a conexão, o canal ganha um Callback URL no formato {endereço}/ch/{channelID} (na interface — o ícone de webhook 🔗). Ele, junto com o seu Verify token, precisa ser informado no aplicativo Meta: WhatsApp → Configuration → Webhook.

Como funciona:

  1. A Meta envia ao Callback URL uma requisição de verificação e compara o verify_token transmitido com o seu Verify token. Se coincidirem, o webhook é considerado confirmado.
  2. Em seguida, a Meta envia a esse endereço os eventos (mensagens de entrada, status de entrega, veredictos de moderação de templates).
  3. Cada requisição de entrada é assinada com o cabeçalho X-Hub-Signature-256; o GetMyBot verifica a assinatura usando o App secret — por isso essa credencial é exigida na conexão.

Janela de sessão de 24 horas

O WhatsApp restringe a conversa iniciada pelo bot: mensagens livres só podem ser enviadas ao usuário durante 24 horas após a última mensagem de entrada dele. Cada nova mensagem de entrada do usuário renova a janela.

Fora da janela de 24 horas não é possível enviar uma mensagem livre — a única forma de escrever novamente ao usuário (re-engage) é um template de mensagem aprovado. Por isso os templates são a ferramenta-chave para transmissões e lembretes no WhatsApp.

Templates de mensagem

Um template (message template) é uma mensagem previamente aprovada pela Meta que pode ser enviada fora da janela de sessão. O gerenciamento de templates fica na interface do GetMyBot.

Onde gerenciar os templates

Bots → no canal WhatsApp, o ícone "Templates de mensagem" (📄) → o diálogo "Templates do canal WhatsApp". No diálogo há botões:

  • "Criar template" — montar um novo template.
  • "Sincronizar" — puxar o catálogo de templates da Meta (atualizar status e lista).

Categorias de templates

  • MARKETING (Marketing) — promoções, anúncios, transmissões.
  • UTILITY (Serviço) — notificações sobre ações do usuário (status de pedidos, lembretes).
  • AUTHENTICATION (Autenticação) — códigos de confirmação.

Campos do template

  • Nome — letras latinas minúsculas, dígitos e _, até 512 caracteres.
  • Idioma — locale da Meta.
  • Categoria — uma das três acima.

Para as categorias Marketing e Serviço, adicionalmente:

  • Cabeçalho — nenhum / texto / imagem / vídeo / documento. Para cabeçalho de mídia, envia-se um arquivo de exemplo.
  • Corpo — obrigatório, até 1024 caracteres. As variáveis são indicadas por {{1}}, {{2}}, … estritamente em ordem, de 1 a N, sem lacunas.
  • Rodapé — até 60 caracteres.
  • Botões — até 10: resposta rápida, link (até 2), telefone (1), cópia de código (1).
  • Para cada variável {{n}} é preciso definir um valor de exemplo — é uma exigência da Meta para a moderação.

Para a categoria Autenticação, o corpo é fixado pela própria Meta; configuram-se: prazo de validade do código (1–90 minutos), recomendação de segurança e o texto do botão de cópia do código.

Moderação

O botão "Criar" envia o template imediatamente para a moderação da Meta — não há uma etapa separada de "enviar para revisão". O veredicto chega de forma assíncrona (via webhook), e a lista de templates é atualizada automaticamente. Status:

  • PENDING (Em revisão)
  • APPROVED (Aprovado)
  • REJECTED (Rejeitado) — com a indicação do motivo
  • e também PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

Podem ser editados os templates nos status APPROVED, REJECTED, PAUSED. Nome e idioma não podem ser alterados; em templates aprovados a categoria também fica bloqueada.

Uso do template em uma reação

Enviar um template é uma ação de reação:

  1. No construtor da reação, abra "Ações" → "Adicionar ação" → "Enviar template do WhatsApp".
  2. A ação só está disponível se o bot tiver um canal WhatsApp com suporte a templates.
  3. Seleciona-se apenas um template aprovado (APPROVED).
  4. Preenchem-se os parâmetros: valores das variáveis {{n}} no corpo, cabeçalho de texto, cabeçalho de mídia por link, parâmetros dos botões de URL. Nos parâmetros é possível usar substituições-variáveis.

O canal de envio real é determinado pelo canal do evento: se o evento veio do WhatsApp, o template será enviado ao WhatsApp.

Diálogos e anexos

O operador pode responder no diálogo do WhatsApp e enviar anexos — imagem, vídeo ou documento — respeitando a janela de 24 horas (fora da janela a conversa livre não está disponível). As mídias de entrada dos assinantes são carregadas via proxy e exibidas no diálogo.

Tarifação

O GetMyBot mantém o registro das conversas do WhatsApp (conversations) por categoria — marketing / utility / authentication / service. Na versão atual isso é apenas um registro para observabilidade (record-only): o saldo não é debitado pelas conversas.

Próximos passos