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#

• Uma conta do WbizTool com um número de WhatsApp conectado nas configurações do WhatsApp.
• Seu Client ID e sua chave de API, em Configurações → Chaves API.
• Para o gatilho de mensagem recebida: o add-on Unibox no seu plano. Veja Requisitos do gatilho.

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 seu Client ID e sua chave de API, 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. Se o Client ID ou a chave de API estiver errado, o Zapier mostra o erro quando você conecta, por exemplo Auth Error: invalid api key.

Gatilho de mensagem de WhatsApp recebida#

Este gatilho inicia seu Zap sempre que alguém envia uma mensagem para um dos seus números de WhatsApp. Use-o para adicionar novas conversas a um CRM, publicar mensagens em um canal da equipe ou registrar conversas em uma planilha.

1. Escolha o gatilho

   Escolha WbizTool como app e Incoming WhatsApp Message (mensagem de WhatsApp recebida) como evento de gatilho.

2. Escolha um número de WhatsApp

   Em WhatsApp Number (número de WhatsApp), escolha o número conectado cujas mensagens recebidas devem iniciar o Zap. A lista mostra os números de telefone conectados no seu espaço de trabalho.

3. Teste o gatilho

   Clique em Test trigger (testar gatilho). O Zapier carrega as mensagens mais recentes recebidas nesse número, para que você possa mapear campos reais nas próximas etapas. Se o número ainda não tiver mensagens, o Zapier mostra uma mensagem de exemplo.

4. Ative o Zap

   Publique o Zap. O WbizTool se conecta ao Zapier automaticamente. Você não precisa adicionar uma URL de webhook em nenhum lugar do WbizTool.

Requisitos do gatilho#

• Add-on Unibox. O gatilho adiciona seu número à caixa de entrada Unibox (um número da caixa de entrada). Sem o add-on, 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 da caixa de entrada livre. Se o número ainda não estiver na caixa de entrada, ele ocupa um dos números da caixa de entrada que o seu add-on permite. Um número que já está na caixa de entrada não usa outro.
• Função Owner (proprietário) ou Editor. A chave de API precisa pertencer a um Owner ou Editor do espaço de trabalho.
• Um número de WhatsApp conectado. O número precisa continuar conectado para que as novas mensagens sejam captadas.

Como o gatilho funciona com seus números da caixa de entrada#

• Só mensagens recebidas iniciam o Zap. Mensagens enviadas pelo seu número, não.
• Só são enviadas as mensagens recebidas depois que você ativa o Zap. Mensagens anteriores não são reenviadas.
• Se o número já estiver na caixa de entrada com a URL do seu próprio webhook, o webhook do Zapier toma o lugar dele enquanto o Zap estiver ativo. Quando você desativa o Zap, a URL do seu próprio webhook, o segredo e as configurações de eventos são restaurados.
• Se você excluir um Zap sem desativá-lo antes, o WbizTool para de enviar para ele assim que o Zapier informa que o Zap não existe mais.
• Em Números da caixa de entrada, o webhook do número mostra um selo Zapier. Se você usar Parar ou Remover no número lá, o Zap continua ativo no Zapier, mas não recebe mensagens, e a página avisa você antes. Para parar o Zap, desative-o no Zapier. Para voltar a receber mensagens depois de excluir o listener, desative e ative o Zap de novo no Zapier.

Veja em Webhooks de mensagens recebidas como funcionam os números da caixa de entrada e os webhooks.

Dados do gatilho#

Cada execução do Zap recebe uma mensagem, como esta:

{
  "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",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

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.

Exemplo: registrar mensagens recebidas no Google Sheets#

1. Gatilho: WbizTool, Incoming WhatsApp Message.
2. Ação: Google Sheets, Create Spreadsheet Row (criar linha na planilha). Mapeie Contact Phone (telefone do contato) para uma coluna Phone, Contact Name (nome do contato) para uma coluna Name e Message Content (conteúdo da mensagem) para uma coluna Message.

Enviar mensagens de WhatsApp a partir de um Zap#

Adicione o WbizTool como ação e escolha um destes eventos de ação:

Em todas as ações, escolha o número de envio em WhatsApp Number. Informe o número de telefone do destinatário com o código do país, como 919876543210, ou coloque o código do país no campo opcional Country Code (código do país), como 91. Send WhatsApp Message on Group não tem telefone nem código do país; em vez disso, recebe o Group Name (nome do grupo).

Quando o WbizTool não consegue aceitar uma mensagem, a etapa falha e o Zapier mostra o motivo, por exemplo WbizTool: Invalid phone number ou WbizTool: Not enough credits. Uma etapa bem-sucedida significa que a mensagem entrou na fila. Depois, o WbizTool a envia pelo seu número conectado.

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

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#