Pular para o conteúdo
WbizTool

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çãoExemploDo que precisa no WbizTool
Pipedrive → WhatsAppUm 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 → PipedriveUm 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#

Escolha um caminho#

CaminhoPipedrive → WhatsAppWhatsApp → PipedrivePlano e permissões no Pipedrive
Automations do PipedriveSim, sem nenhuma outra ferramenta: a ação de webhook da automação chama a API do WbizTool.NãoAs Automations e a ação de webhook delas estão nos planos Growth e superiores. Só administradores globais criam o webhook automatizado.
ZapierSim, com as ações do app do WbizTool.Sim, com o gatilho Incoming WhatsApp Message do WbizTool.Qualquer plano com acesso ao Zapier.
MakeSim, 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.
n8nSim, 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 ConnectSim, 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, como 020 7946 0018, precisa de country_code (aqui 44), ou vai para o número errado ou falha.
  • As mensagens recebidas trazem só dígitos. No webhook, contact.phone é o número sem +, como 442079460018. 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.phone fica vazio e contact.phone_hidden é true. Chats de grupo têm contact.is_group definido como true. 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.

  1. 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.

  2. 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.

  3. 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/.

  4. 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.

    ChaveValor
    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.

  5. 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": 1 quando a mensagem entra na fila; um erro é respondido com HTTP 400 e uma message, como Invalid 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#

  1. 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).

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  1. 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.

  2. Filtro: pessoas, não grupos

    Adicione Filter by Zapier: continue só quando Is Group for falso e Contact Phone Hidden for falso.

  3. 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.

  4. 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.

BlueprintO que faz
pipedrive-deal-stage-to-whatsapp.blueprint.jsonWebhook 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.jsonWebhook 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#

  1. Importe o blueprint

    Crie um cenário no Make, clique nos três pontos da barra inferior, escolha Import Blueprint e selecione o arquivo.

  2. Crie o webhook

    Abra o primeiro módulo (Webhooks → Custom webhook), clique em Add, salve e copie o endereço que o Make mostra.

  3. Preencha os marcadores

    • No filtro depois do webhook, substitua YOUR_STAGE_ID pelo ID da sua etapa. Para encontrá-lo, mova um negócio de teste para a etapa uma vez e leia data.stage_id na saída do webhook.
    • No módulo Get the person, substitua YOUR_COMPANY e YOUR_PIPEDRIVE_API_TOKEN.
    • No módulo Send WhatsApp, substitua YOUR_WBIZTOOL_API_KEY no cabeçalho Authorization, YOUR_WHATSAPP_CLIENT_ID no corpo e o texto da mensagem.
  4. 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.

  5. 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": 1 significa 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#

  1. Importe o blueprint

    Importe whatsapp-to-pipedrive-note.blueprint.json em um novo cenário.

  2. Crie o webhook

    Abra Webhooks → Custom webhook, clique em Add, salve e copie o endereço.

  3. Preencha os marcadores

    Substitua YOUR_COMPANY e YOUR_PIPEDRIVE_API_TOKEN nos quatro módulos HTTP do Pipedrive (pesquisa, criação da pessoa e as duas notas).

  4. 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.

  5. 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.

WorkflowO que faz
pipedrive-deal-stage-to-whatsapp.n8n.jsonPipedrive Trigger (negócio alterado) → If o negócio passou para a sua etapa → Pipedrive Get pessoa → WbizTool Send Message.
whatsapp-to-pipedrive-note.n8n.jsonWebhook (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.
  1. 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.

  2. 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).

  3. Defina sua etapa e sua mensagem

    No primeiro workflow, substitua YOUR_STAGE_ID no node If pelo ID da sua etapa (mova um negócio de teste para a etapa e leia data.stage_id na 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.

  4. 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 com message.content.

O que chega do WhatsApp#

Cada mensagem recebida é uma requisição JSON. Os campos que as receitas usam:

CampoExemploUse para
eventmessage_receivedPule message_sent se você também marcou Mensagens enviadas.
contact.phone12125550120A pesquisa no Pipedrive e o telefone da nova pessoa (com +).
contact.nameEmma ThompsonO nome da nova pessoa. Pode estar vazio: use o telefone nesse caso.
contact.is_group, contact.phone_hiddenfalsePular chats de grupo e números ocultos.
message.contentCan I add a gift note to it?A nota. Fotos e arquivos chegam como um rótulo, como 📸 Image.
message.timestamp2026-10-15T10:30:04+00:00Quando 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#

ProblemaO que verificar
Auth Error: invalid api keyA 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 numberO 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 erradoO 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 WbizToolO 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 WbizToolLibere 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 é criadaO 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#