Skip to main content

​
Por que este canal importa

O WhatsApp é onde a maioria das pessoas já conversa com marcas, com suporte e com amigos. Integrar aqui significa entregar código de verificação, avisos de pedido, lembretes e atendimento no app que o cliente olha várias vezes ao dia — sem depender só de e-mail ou SMS. No Notifique, você não precisa se enrolar com protocolo de baixo nível da Meta no dia a dia: você cria uma instância (uma conexão com um número), escolhe para quem enviar e o tipo de mensagem, e a plataforma cuida da fila, retentativas e status.

​
O que você encontra no painel

  • Instâncias — criar conexões, ver QR Code para parear o celular, nomear e organizar por workspace.
  • Status da conexão — saber se o número está ativo, pendente de leitura do QR ou desconectado, para o seu time ou seu robô reagir (por exemplo, pedir novo pareamento).
  • API Keys e escopos — liberar só o que cada integração precisa (enviar, ler mensagens recebidas, gerir instâncias, etc.).
  • Webhooks — cadastrar uma URL para o Notifique avisar quando uma mensagem foi enviada, entregue, falhou ou quando alguém respondeu no WhatsApp.
Recursos experimentais de grupos (lista de grupos, participantes, convites) aparecem no painel quando o workspace tem o recurso ativado; a documentação dedicada está em Introdução — Grupos.

​
O que você encontra na API

  • Instâncias — criar, listar, consultar e desconectar (/v1/whatsapp/instances/...).
  • Envio de mensagens — texto, mídia, documentos, localização, contato, botões e lista interativa, com agendamento e idempotência quando fizer sentido para o seu fluxo.
  • Mensagens recebidas (inbound) — listar e consultar o que chegou na instância (com escopo de leitura adequado).
  • Grupos (opcional) — rotas específicas para grupos; envio para grupo usa a mesma rota de mensagens, com o destino em formato de JID de grupo (...@g.us).
Detalhes de rotas e modelos estão na especificação OpenAPI do canal WhatsApp e nos guias abaixo.

​
Webhooks: o mesmo padrão, nomes message.*

Quando algo importante acontece, o Notifique pode POSTar um JSON na URL que você configurou. No WhatsApp, os nomes dos eventos seguem o prefixo que você vê na documentação de eventos (por exemplo relacionados a mensagem e instância). O formato geral do corpo (workspace, instância, payload) é o descrito em Eventos dos Webhooks. Se você usa Telegram no mesmo projeto, lembre-se: lá os eventos começam com telegram.*; não confunda com message.* do WhatsApp ao montar filtros no seu backend.

​
Próximos passos