Pular para o conteúdo principal
Cada número conectado pode ter uma URL de webhook. Quando seu sistema faz uma requisição para essa URL, o blü envia a mensagem pelo WhatsApp desse número. Use para avisos de pedido, lembretes, confirmações de cadastro ou qualquer envio disparado por outra ferramenta, como Zapier, Make, n8n ou o seu próprio sistema.
O webhook envia uma mensagem por requisição, para um contato. Para enviar a mesma mensagem a uma lista, use as campanhas.

​
Gere a URL do webhook

  1. Em Números conectados, clique em Webhook no card do número que vai enviar as mensagens.
  2. Clique em Gerar token.
  3. Copie a URL do Webhook. A janela também mostra um Exemplo de uso (cURL) pronto para copiar.
A URL tem este formato:
Quem tiver a URL consegue enviar mensagens pelo seu número. Guarde-a como uma senha. Se ela vazar, clique em Gerar novo token: a URL anterior para de funcionar na hora, e você precisa atualizá-la nos sistemas que a usam.

​
Envie uma mensagem de texto

Faça um POST para a URL com um corpo JSON contendo o telefone e o texto:
* Envie message ou text, ou use um template, como mostrado abaixo.

​
Envie um template de campanha

Para enviar uma mensagem pronta, com imagens, áudio ou vídeo, use um template de campanha no lugar do texto.
  1. Abra o template em Templates de campanha e clique em Copiar link. O link termina com o ID do template: https://app.blu.direct/template/ID_DO_TEMPLATE.
  2. Envie o ID no campo templateId:

​
Personalize com variáveis

Os outros campos do corpo viram variáveis do template. No exemplo acima, um template com o texto Olá, {{nome}}! Seu pedido {{pedido}} foi enviado. chega como “Olá, Maria! Seu pedido 1234 foi enviado.”
  • Escreva a variável no template entre chaves duplas, com o mesmo nome do campo: {{nome}}.
  • Variáveis sem campo correspondente no corpo ficam vazias.
  • Para variar o texto entre envios, use opções entre chaves simples separadas por |: {Oi|Olá|Tudo bem}. Cada envio escolhe uma delas.
Os botões do template não são enviados pelo webhook; o texto e os anexos, sim.

​
Respostas

Uma resposta 200 confirma que o blü entregou a mensagem ao WhatsApp, não que ela chegou ao celular do contato. Confira o envio na conversa do contato em Conversas.

​
Boas práticas

  • Envie apenas para contatos que autorizaram receber mensagens do seu número. Muitos envios para quem não conhece o número aumentam o risco de bloqueio.
  • Espalhe envios em grande quantidade ao longo do tempo, em vez de disparar tudo de uma vez.
  • Se o contato responder, a conversa segue normalmente no número: com o atendimento humano, o agente de IA ou o fluxo de respostas configurado nele.
Para o caminho inverso, em que o agente de IA avisa o seu sistema durante uma conversa, veja webhooks do agente.