Webhooks & API — Conecte o WA Web Plus aos Seus Sistemas

Webhooks & API — Conecte o WA Web Plus aos Seus Sistemas

O WA Web Plus suporta integração bidirecional com sistemas externos via webhooks. Você pode receber requisições de API de entrada para acionar ações dentro do WhatsApp, ou enviar requisições de saída para o seu servidor sempre que um evento ocorrer.

Webhooks de Entrada (REST API)

Os webhooks de entrada permitem enviar requisições HTTP autorizadas ao WA Web Plus para executar ações — como enviar mensagens, rodar broadcasts ou etiquetar chats — diretamente do seu sistema, CRM ou ferramenta de automação.

Cada requisição deve incluir seu token de autorização nos headers. O corpo é um objeto JSON com um campo action que define o que fazer.

Enviar mensagem de texto

{
  "action": "send-message",
  "type": "text",
  "content": "Bem-vindo ao WA Web Plus",
  "phone": "905366365288"
}

Enviar mensagem de mídia

{
  "action": "send-message",
  "type": "media",
  "content": "Bem-vindo ao WA Web Plus",
  "phone": "905366365288",
  "attachments": ["https://example.com/image.jpg"]
}

Enviar um modelo salvo

{
  "action": "send-template",
  "template": "Mensagem de Boas-vindas",
  "phone": "120363020166629872@g.us"
}

Use o sufixo @g.us para grupos.

Etiquetar um chat

{
  "action": "label-chat",
  "label": "Cliente Interessado",
  "phone": "905366365288"
}

Remover etiqueta

{
  "action": "unlabel-chat",
  "label": "Descadastrado",
  "phone": "905366365288"
}

Bloquear contato

{
  "action": "block-chat",
  "phone": "905366365288"
}

Arquivar chat

{
  "action": "archive-chat",
  "phone": "905366365288"
}

Executar campanha de broadcast

{
  "action": "run-broadcast",
  "broadcast": "Campanha Agendada de Domingo"
}

Acionar um fluxo de Resposta Inteligente

{
  "action": "run-workflow",
  "workflow": "Fluxo de Reembolso",
  "phone": "905366365288"
}

Webhooks de Saída

Os webhooks de saída permitem que o WA Web Plus envie dados de eventos para o seu servidor em tempo real — por exemplo, quando uma mensagem é recebida, um usuário entra em um grupo, ou uma Resposta Inteligente é acionada.

Você pode configurar o método HTTP (POST, GET, UPDATE, DELETE), headers personalizados (em JSON) e personalizar completamente o payload enviado ao seu endpoint. Use o botão @ no editor de payload para inserir qualquer uma das variáveis de evento disponíveis.

Variáveis de evento disponíveis:

• •m_id — ID único da mensagem
• •m_type — tipo da mensagem
• •m_datetime — data e hora formatadas
• •m_timestamp — timestamp unix
• •m_user — número de telefone do remetente
• •m_phone — número de telefone do remetente
• •m_content — conteúdo da mensagem
• •m_text — texto ou legenda da mensagem
• •m_cname — nome do contato
• •m_uname — nome de exibição do WhatsApp do remetente
• •m_gname — nome do grupo onde a mensagem foi recebida
• •m_gid — ID único do grupo
• •m_platform — plataforma do remetente
• •w_id — ID único do fluxo de trabalho que acionou o webhook
• •c_labels — etiquetas do chat
• •c_image — imagem do chat
• •m_location — coordenadas de localização
• •m_order — itens do pedido

Para ajuda com sua integração, entre em contato em support@wawplus.com.

Quer Webhooks Rodando Sem o Navegador?

Os webhooks no WA Web Plus exigem que o WhatsApp Web esteja aberto no seu navegador. Se você precisa que seus webhooks e automações rodem na nuvem 24/7 — sem precisar manter o computador ligado — conheça o Botassium, nossa solução em nuvem que mantém tudo funcionando sem precisar de navegador.