Pular para o conteúdo
Wbiztool

Integrações

Integração com Zapier

O app do Wbiztool no Zapier conecta seu número de WhatsApp aos outros apps que você usa. Inicie um Zap quando chegar uma mensagem de WhatsApp ou envie uma mensagem de WhatsApp quando algo acontecer em outro app.

Antes de começar#

Conectar sua conta#

  1. Adicione o Wbiztool a um Zap

    No Zapier, crie um Zap e pesquise Wbiztool como app de gatilho ou de ação.

  2. Faça login

    Quando o Zapier pedir para conectar uma conta, informe as credenciais solicitadas, sua chave de API e seu Client ID, que estão em Configurações → Chaves API.

A chave de API define qual espaço de trabalho o Zapier usa. Se você participa de mais de um espaço de trabalho, use uma chave criada no espaço de trabalho que quer conectar.

Gatilho de nova mensagem de WhatsApp#

Este gatilho inicia seu Zap sempre que uma mensagem é recebida no seu número de WhatsApp. Use-o para adicionar novas conversas a um CRM, publicar mensagens em um canal da equipe ou registrar conversas em uma planilha.

Requisitos do gatilho#

  • Add-on Unibox. Sem ele, ativar o Zap falha com Unibox add-on subscription required. Compre-o em Cobrança e Planos: US$ 20/mês ou US$ 200/ano por número de WhatsApp usado no Unibox.
  • Um número de WhatsApp conectado. O gatilho fica vinculado a um dos seus números conectados.

Dados do gatilho#

As mensagens reais têm esta aparência:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

O exemplo que o Zapier carrega enquanto você configura o gatilho tem os mesmos campos message e contact (exceto message.forwarding_score), mas não tem webhook_id, whatsapp_client_id, whatsapp_phone nem organisation. Esses campos só aparecem para mapeamento depois que chega uma mensagem real. O exemplo também usa valores fictícios: números de telefone com +, whatsapp_timestamp em milissegundos e status igual a delivered.

CampoDescrição
eventmessage_received para mensagens recebidas, message_sent para mensagens enviadas pelo seu número.
message.typechat para texto. Mensagens de mídia usam tipos como image, video, audio, ptt (mensagem de voz), document e sticker.
message.contentO texto. Para mídia, um rótulo curto como "📸 Image".
message.directionincoming ou outgoing.
message.from / message.tofrom é sempre o contato e to o seu número, mesmo em mensagens enviadas. Use message.direction para diferenciá-las.
contact.is_grouptrue quando a mensagem veio de um grupo. Mensagens de grupo também incluem group.name.

Nas mensagens reais, os números de telefone não têm +, message.whatsapp_timestamp está em segundos e message.status geralmente é pending. Algumas mensagens incluem campos extras: message.media (nome, tipo e tamanho do arquivo) para mídia, message.quoted_message_id para respostas e group para mensagens de grupo. Veja mais exemplos em Listeners de webhook.

Exemplo: registrar mensagens recebidas no Google Sheets#

  1. Gatilho: Wbiztool, New WhatsApp Message.
  2. Filter by Zapier: continue somente se message.direction corresponder exatamente a incoming.
  3. Ação: Google Sheets, Create Spreadsheet Row. Mapeie contact.phone para uma coluna Phone, contact.name para uma coluna Name e message.content para uma coluna Message.

Enviar mensagens de WhatsApp a partir de um Zap#

Para enviar uma mensagem, adicione o Wbiztool como ação e escolha uma das ações listadas na página do Wbiztool no Zapier. Mapeie o número de telefone do destinatário e o texto da mensagem a partir das etapas anteriores.

Você também pode chamar a API diretamente com Webhooks by Zapier:

ConfiguraçãoValor
Action event (evento da ação)POST
URLhttps://wbiztool.com/api/v1/send_msg/
Payload type (tipo de payload)json ou form
Data (dados)client_id, api_key, whatsapp_client, country_code, phone, msg

Veja o que significa cada campo em Enviar mensagens de WhatsApp a partir de qualquer ferramenta de automação e todas as opções em Enviar mensagem.

Solução de problemas#

ProblemaO que verificar
Invalid API keyA chave foi excluída ou digitada errado. Crie uma nova em Configurações → Chaves API e reconecte.
Unibox add-on subscription requiredCompre o add-on Unibox em Cobrança e Planos e ative o Zap de novo.
No available WhatsApp clientsNenhum número foi definido no gatilho e todos os números conectados já têm um listener do Unibox, ou nenhum número está conectado. Isso inclui o listener que o Wbiztool criou na primeira vez que você ativou este Zap: desativar um Zap não o exclui, então ativá-lo de novo (por exemplo, depois de editar o Zap) pode falhar. Exclua um listener de que você não precisa mais, como esse, em Listeners do Unibox ou conecte outro número nas configurações do WhatsApp.
Invalid WhatsApp clientO número definido no gatilho não está conectado no momento. Reconecte-o nas configurações do WhatsApp.
O Zap está ativo, mas não disparaSeu número de WhatsApp precisa continuar conectado para que as novas mensagens sejam captadas. Confira o listener em Listeners do Unibox.
O Zapier mostra um erro quando você desativa o Zap, como Listener not found ou um erro de servidorÉ um problema conhecido. Confira o listener em Listeners do Unibox para ver se a URL de webhook dele foi removida.