Integrações
Pipedrive e WhatsApp
Conecte o Pipedrive ao número de WhatsApp que você vinculou ao WbizTool. Envie mensagem a uma pessoa quando o negócio dela passa para uma etapa e registre como notas no Pipedrive as mensagens de WhatsApp que ela envia para você.
O WbizTool não tem um app para Pipedrive. Você conecta os dois com uma ferramenta que talvez já use: as Automations do próprio Pipedrive, Zapier, Make, n8n ou Pabbly Connect. Esta página mostra cada caminho passo a passo, com templates prontos para Make e n8n.
Quem pode fazer isso: qualquer pessoa com uma chave de API do WbizTool pode enviar mensagens. Registrar as mensagens recebidas precisa do add-on Unibox (US$ 20 por mês ou US$ 200 por ano pelos preços de tabela nos EUA para cada número da caixa de entrada, em um plano pago ou vitalício) e de um Proprietário ou Editor para configurar o webhook. No Pipedrive, você precisa das permissões que o seu caminho pede (veja Escolha um caminho).
O que você pode fazer#
| Direção | Exemplo | Do que precisa no WbizTool |
|---|---|---|
| Pipedrive → WhatsApp | Um negócio passa para Proposta enviada: a pessoa recebe "Olá Emma, sua proposta está no seu e-mail." Uma nova pessoa é adicionada: ela recebe uma mensagem de boas-vindas. | Uma chave de API e um número de WhatsApp conectado. |
| WhatsApp → Pipedrive | Um cliente escreve para o seu número de WhatsApp: a mensagem é adicionada como nota na pessoa com esse número de telefone, e a pessoa é criada se o Pipedrive ainda não a tiver. | O add-on Unibox e o número adicionado em Números da caixa de entrada. |
As mensagens saem do seu próprio número de WhatsApp, então as regras do WhatsApp se aplicam: envie mensagens para pessoas que esperam ter notícias suas, como os seus leads e clientes.
Antes de começar#
- Um número de WhatsApp conectado em Números do WhatsApp, e o WhatsApp Client ID dele, na mesma página.
- O seu Client ID e uma chave de API de Configurações → Chaves de API. Crie uma chave só para o Pipedrive, para poder excluí-la separadamente depois. Veja Chaves de API.
- Números de telefone com o código do país no Pipedrive, como
+44 20 7946 0018. Veja Números de telefone. - Para mensagens recebidas: o add-on Unibox com um número da caixa de entrada livre. Veja Números da caixa de entrada e webhooks de mensagens recebidas.
Escolha um caminho#
| Caminho | Pipedrive → WhatsApp | WhatsApp → Pipedrive | Plano e permissões no Pipedrive |
|---|---|---|---|
| Automations do Pipedrive | Sim, sem nenhuma outra ferramenta: a ação de webhook da automação chama a API do WbizTool. | Não | As Automations e a ação de webhook delas estão nos planos Growth e superiores. Só administradores globais criam o webhook automatizado. |
| Zapier | Sim, com as ações do app do WbizTool. | Sim, com o gatilho Incoming WhatsApp Message do WbizTool. | Qualquer plano com acesso ao Zapier. |
| Make | Sim, com o módulo HTTP do Make. Blueprint abaixo. | Sim, com um webhook do Make. Blueprint abaixo. | Qualquer plano. Os blueprints usam os webhooks do Pipedrive (todos os planos) e um token de API do Pipedrive. |
| n8n | Sim, com o Pipedrive Trigger e o node do WbizTool. Workflow abaixo. | Sim, com um node Webhook e o node Pipedrive. Workflow abaixo. | Qualquer plano. O n8n precisa de um token de API do Pipedrive. |
| Pabbly Connect | Sim, com a ação de requisição API (Pabbly) dele. | Sim, com o gatilho de webhook dele. | Qualquer plano. |
Os Webhooks do próprio Pipedrive (todos os planos) enviam um corpo fixo que a API do WbizTool não consegue ler, então eles não chamam o WbizTool diretamente. Em vez disso, eles iniciam um workflow do Make, do n8n ou do Pabbly, como na receita do Make.
Números de telefone#
Os dois lados escrevem os números de jeitos diferentes. Tenha estas regras em mente ao mapear os campos:
- Para enviar, passe o telefone do Pipedrive como está. A API de envio de mensagens remove espaços, hífens, pontos, parênteses e o
+. Um número escrito com+, como+44 20 7946 0018, mantém o próprio código do país. Um número local, como020 7946 0018, precisa decountry_code(aqui44), ou vai para o número errado ou falha. - As mensagens recebidas trazem só dígitos. No webhook,
contact.phoneé o número sem+, como442079460018. Pesquise no Pipedrive com esses dígitos e adicione um+na frente ao criar uma pessoa. - O Pipedrive guarda os telefones como foram digitados. A pesquisa dele encontra uma pessoa pelos dígitos do número, mas um número salvo sem o código do país pode não ser encontrado. Salve os números com o código do país.
- Números ocultos e grupos. O WhatsApp às vezes oculta o número de quem envia: então
contact.phonefica vazio econtact.phone_hiddenétrue. Chats de grupo têmcontact.is_groupdefinido comotrue. As receitas abaixo pulam os dois.
Automations do Pipedrive#
As Automations do Pipedrive podem enviar uma requisição de webhook como ação. Aponte-a para a API de envio de mensagens do WbizTool, e a automação envia a mensagem de WhatsApp sozinha, sem nenhuma outra ferramenta.
No Pipedrive: um plano Growth ou superior. Só administradores globais podem criar o webhook automatizado; criar a automação exige permissão para usar as Automations.
Crie o webhook automatizado
No Pipedrive, abra o menu da conta e acesse Tools and apps → Webhooks. Clique em + Webhooks e escolha Automated webhook. Dê o nome "WbizTool" e informe
https://wbiztool.com/api/v1/como URL do endpoint. A URL precisa terminar com/, porque a automação adiciona o caminho. Deixe a autenticação vazia: as credenciais do WbizTool vão no corpo.Crie a automação
Abra o menu da conta no canto superior direito, acesse Tools and apps → Automations e clique em + Automation. Selecione Event trigger, escolha deal como item e defina o evento do gatilho como Updated. Selecione a etapa do negócio como o campo cujas alterações serão monitoradas e clique em Apply trigger. Depois, adicione uma condição com o nome da etapa do negócio, para que a automação só rode quando um negócio passar para essa etapa.
Para uma mensagem de boas-vindas, escolha person como item e o evento Added.
Adicione a ação de webhook
Adicione a ação webhook e escolha o webhook "WbizTool". Defina o método como POST e adicione o caminho
send_msg/.Preencha o corpo
Escolha o corpo Key-value e adicione os campos abaixo. Use o botão de campos para inserir o telefone e o nome da pessoa.
Chave Valor client_idO seu Client ID. api_keyA sua chave de API. whatsapp_clientO WhatsApp Client ID do número que envia. phoneO telefone da pessoa de contato, pelo botão de campos. country_codeSó se os seus números no Pipedrive forem locais, sem código do país: o código de discagem, como 44.msgA sua mensagem, como Olá [primeiro nome da pessoa], sua proposta está no seu e-mail. Responda aqui se tiver dúvidas.Você também pode escolher Raw e escrever os mesmos campos em JSON. Com Key-value, você não precisa se preocupar com aspas nos nomes.
Teste
Salve a automação, deixe-a ativa e mova um negócio de teste para a etapa. Abra Automations → History e a execução: ela mostra o corpo que foi enviado. O WbizTool responde
"status": 1quando a mensagem entra na fila; um erro é respondido com HTTP400e umamessage, comoInvalid phone number.
Zapier#
Use o app do WbizTool no Zapier com o app do Pipedrive no Zapier.
Um negócio muda de etapa: enviar uma mensagem de WhatsApp#
Gatilho: Pipedrive Updated Deal Stage
Escolha Pipedrive e o gatilho Updated Deal Stage (etapa do negócio atualizada). Para uma mensagem de boas-vindas, use New Person (nova pessoa).
Filtro: só a sua etapa
Adicione Filter by Zapier e continue só quando a etapa do negócio for a que você quer. O gatilho roda a cada mudança de etapa.
Encontre o telefone da pessoa
Se os dados do gatilho não tiverem um telefone para a pessoa do negócio, adicione a pesquisa Get Person do Pipedrive com o ID da pessoa do negócio.
Ação: WbizTool Send Text-Only WhatsApp Message
Escolha o número que envia em WhatsApp Number. Mapeie o telefone da pessoa em Phone Number, preencha Country Code só se os seus números no Pipedrive forem locais e escreva a Message com o nome da pessoa.
Teste e publique
Uma etapa bem-sucedida significa que a mensagem entrou na fila. Se o WbizTool não conseguir aceitá-la, a etapa falha com o motivo, como
WbizTool: Invalid phone number.
Uma mensagem de WhatsApp chega: adicionar uma nota no Pipedrive#
Precisa do add-on Unibox. Veja Requisitos do gatilho.
Gatilho: WbizTool Incoming WhatsApp Message
Escolha o número em WhatsApp Number. Quando você publica o Zap, o WbizTool adiciona o número à caixa de entrada e envia as mensagens recebidas dele ao Zapier.
Filtro: pessoas, não grupos
Adicione Filter by Zapier: continue só quando Is Group for falso e Contact Phone Hidden for falso.
Encontre ou crie a pessoa
Adicione Find or Create Person do Pipedrive: ele pesquisa pessoas em um campo (escolha o campo de telefone, com Contact Phone) e cria uma pessoa quando não encontra nenhuma. Para uma pessoa nova, defina o nome como Contact Name e o telefone como
+seguido de Contact Phone.Crie a nota
Adicione Create Note do Pipedrive. Vincule-a à pessoa da etapa anterior e escreva o conteúdo, por exemplo:
WhatsApp de Contact Name: Message Content, com Message Time se quiser o horário.
Make#
Não existe app do WbizTool no Make. Os dois blueprints usam os módulos Webhooks, HTTP e JSON do próprio Make: o módulo HTTP chama a API do WbizTool e a API do Pipedrive.
| Blueprint | O que faz |
|---|---|
| pipedrive-deal-stage-to-whatsapp.blueprint.json | Webhook do Pipedrive (um negócio mudou) → filtro na sua etapa → obter a pessoa do negócio → enviar uma mensagem de WhatsApp para ela. |
| whatsapp-to-pipedrive-note.blueprint.json | Webhook de mensagens recebidas do WbizTool → encontrar a pessoa pelo telefone → adicionar uma nota, ou criar a pessoa antes. |
Os blueprints são feitos com os módulos genéricos do Make, então funcionam em qualquer plano do Make e não precisam de uma conexão do Pipedrive no Make.
Você precisa do seu token de API do Pipedrive (no Pipedrive, Settings → Personal preferences → API) e do endereço da sua empresa no Pipedrive, como yourcompany.pipedrive.com.
Um negócio muda de etapa: enviar uma mensagem de WhatsApp#
Importe o blueprint
Crie um cenário no Make, clique nos três pontos da barra inferior, escolha Import Blueprint e selecione o arquivo.
Crie o webhook
Abra o primeiro módulo (Webhooks → Custom webhook), clique em Add, salve e copie o endereço que o Make mostra.
Preencha os marcadores
- No filtro depois do webhook, substitua
YOUR_STAGE_IDpelo ID da sua etapa. Para encontrá-lo, mova um negócio de teste para a etapa uma vez e leiadata.stage_idna saída do webhook. - No módulo Get the person, substitua
YOUR_COMPANYeYOUR_PIPEDRIVE_API_TOKEN. - No módulo Send WhatsApp, substitua
YOUR_WBIZTOOL_API_KEYno cabeçalhoAuthorization,YOUR_WHATSAPP_CLIENT_IDno corpo e o texto da mensagem.
- No filtro depois do webhook, substitua
Aponte o webhook do Pipedrive para o Make
No Pipedrive, acesse Settings → Tools and apps → Webhooks e crie um webhook: event action change (updated em versões mais antigas), event object deal e o endereço do Make como URL do endpoint.
Ative
Ative o cenário e mova um negócio de teste para a etapa. A saída do módulo HTTP mostra a resposta do WbizTool:
"status": 1significa que a mensagem entrou na fila.
Para montá-lo com os módulos do Pipedrive no Make, use Watch New Events (ou um Custom webhook como acima), Get a Person e o módulo HTTP com a mesma requisição do módulo Send WhatsApp do blueprint. Os módulos do Pipedrive no Make devolvem a pessoa de um negócio só como ID, então você precisa de Get a Person para obter o telefone.
Uma mensagem de WhatsApp chega: adicionar uma nota no Pipedrive#
Importe o blueprint
Importe
whatsapp-to-pipedrive-note.blueprint.jsonem um novo cenário.Crie o webhook
Abra Webhooks → Custom webhook, clique em Add, salve e copie o endereço.
Preencha os marcadores
Substitua
YOUR_COMPANYeYOUR_PIPEDRIVE_API_TOKENnos quatro módulos HTTP do Pipedrive (pesquisa, criação da pessoa e as duas notas).Adicione o endereço no WbizTool
Em Números da caixa de entrada, adicione o seu número à caixa de entrada ou abra Configurações do webhook no cartão dele. Cole o endereço do Make em URL do webhook, deixe marcada só Mensagens recebidas e salve.
Ative e teste
Ative o cenário e envie uma mensagem para o seu número de WhatsApp de outro celular. Em um ou dois minutos, a nota aparece na pessoa no Pipedrive.
O blueprint pula chats de grupo, números ocultos e mensagens enviadas. Para montá-lo com os módulos do Pipedrive no Make, use Search Persons no campo de telefone, um router, Create a Person e Create a Note.
n8n#
Use os nodes Pipedrive Trigger e Pipedrive do n8n com o community node do WbizTool (n8n-nodes-wbiztool). Instale o community node primeiro.
| Workflow | O que faz |
|---|---|
| pipedrive-deal-stage-to-whatsapp.n8n.json | Pipedrive Trigger (negócio alterado) → If o negócio passou para a sua etapa → Pipedrive Get pessoa → WbizTool Send Message. |
| whatsapp-to-pipedrive-note.n8n.json | Webhook (mensagem recebida do WbizTool) → If for a mensagem de uma pessoa → Pipedrive Search pessoa pelo telefone → Create uma nota, criando a pessoa antes quando nenhuma é encontrada. |
Importe o workflow
No n8n, crie um workflow, abra o menu ⋯ e escolha Import from File. Você também pode colar o conteúdo do arquivo no canvas.
Adicione as credenciais
Abra cada node do Pipedrive e crie uma credencial Pipedrive API com o seu token de API do Pipedrive (Settings → Personal preferences → API no Pipedrive). Abra o node WbizTool Send Message e escolha a sua credencial WbizTool API (Client ID, chave de API e o WhatsApp Client ID que envia).
Defina sua etapa e sua mensagem
No primeiro workflow, substitua
YOUR_STAGE_IDno node If pelo ID da sua etapa (mova um negócio de teste para a etapa e leiadata.stage_idna saída do gatilho) e edite o Message Text. Deixe Country Code vazio quando os seus números no Pipedrive incluírem o código do país.Ative
Ative o workflow. O Pipedrive Trigger cria o webhook dele no Pipedrive sozinho.
Para o segundo workflow, copie a Production URL do node Webhook e cole-a em URL do webhook em Números da caixa de entrada, com só Mensagens recebidas marcada.
Os nodes do Pipedrive nestes arquivos são a versão 2 do node Pipedrive do n8n. Se o seu n8n for mais antigo e os mostrar como desconhecidos, atualize o n8n ou substitua-os pelo node Pipedrive da sua versão, com as mesmas configurações.
Pabbly Connect#
Não existe app do WbizTool no Pabbly Connect: use os módulos gerais dele.
- Pipedrive → WhatsApp: inicie o workflow com o gatilho do Pipedrive do Pabbly, ou com o gatilho de webhook dele alimentado por um webhook do Pipedrive. Depois, adicione API (Pabbly) com Execute API Request para
https://wbiztool.com/api/v1/send_msg/, configurado como em Pabbly Connect, e mapeie o telefone e o nome da pessoa. - WhatsApp → Pipedrive: comece com o gatilho de webhook do Pabbly, cole o endereço dele em URL do webhook em Números da caixa de entrada e envie uma mensagem de teste para o seu número, para que o Pabbly veja os campos. Depois, adicione as etapas do Pipedrive do Pabbly: encontre a pessoa por
contact.phone, crie-a se precisar e adicione uma nota commessage.content.
O que chega do WhatsApp#
Cada mensagem recebida é uma requisição JSON. Os campos que as receitas usam:
| Campo | Exemplo | Use para |
|---|---|---|
event | message_received | Pule message_sent se você também marcou Mensagens enviadas. |
contact.phone | 12125550120 | A pesquisa no Pipedrive e o telefone da nova pessoa (com +). |
contact.name | Emma Thompson | O nome da nova pessoa. Pode estar vazio: use o telefone nesse caso. |
contact.is_group, contact.phone_hidden | false | Pular chats de grupo e números ocultos. |
message.content | Can I add a gift note to it? | A nota. Fotos e arquivos chegam como um rótulo, como 📸 Image. |
message.timestamp | 2026-10-15T10:30:04+00:00 | Quando foi enviada, em UTC. |
Todos os campos, a assinatura e as novas tentativas estão em Números da caixa de entrada e webhooks de mensagens recebidas.
Solução de problemas#
| Problema | O que verificar |
|---|---|
Auth Error: invalid api key | A chave foi excluída ou digitada errado, ou não pertence ao espaço de trabalho do Client ID. No Make e no n8n, confira o cabeçalho Authorization: Bearer ou a credencial. |
Invalid phone number | O campo de telefone estava vazio ou tinha outra coisa, como um nome. Confira se a pessoa tem um telefone no Pipedrive e se você mapeou o campo de telefone. |
| A mensagem foi para o número errado | O Pipedrive tem o número sem o código do país. Salve-o com o código, como +44 20 7946 0018, ou envie country_code. |
Invalid JSON format: … | Um corpo JSON bruto quebrou, muitas vezes por causa de aspas ou de uma quebra de linha em um campo mapeado. Nas Automations do Pipedrive, use o corpo Key-value; no Make, mantenha os módulos JSON do blueprint. |
| A execução da automação diz "Maximum retry limit reached" | O WbizTool respondeu com um erro. Abra a execução em Automations → History e leia o corpo que foi enviado. |
| Nenhum webhook chega do WbizTool | O número precisa mostrar Sincronizando em Números da caixa de entrada, com Mensagens recebidas marcada, no add-on Unibox. Make, n8n e Pabbly precisam responder 2xx em até 8 segundos: ative o cenário ou o workflow. As mensagens são enviadas em um ou dois minutos. |
| O seu servidor ou firewall recusa o webhook do WbizTool | Libere as requisições com o User-Agent WbizTool-Webhooks/1. Alguns hosts bloqueiam clientes desconhecidos com 403. |
| Uma nota é adicionada, mas a pessoa não é encontrada, então uma pessoa duplicada é criada | O número da pessoa no Pipedrive está salvo de outra forma, como sem o código do país. Salve-o com o código e depois mescle as duas pessoas no Pipedrive. |
| Nada acontece para uma mensagem de grupo | É de propósito: as receitas pulam chats de grupo e números ocultos, que não têm telefone para comparar. |
Relacionados#
- API de envio de mensagens: todos os campos que você pode enviar
- Números da caixa de entrada e webhooks de mensagens recebidas
- Chaves de API
- Integração com Zapier
- Integração com n8n
- Enviar mensagens de WhatsApp a partir de qualquer ferramenta de automação: Make, Pabbly Connect e outras

