Pular para o conteúdo
WbizTool

Integrações

HubSpot e WhatsApp

Conecte o HubSpot ao seu número de WhatsApp nas duas direções:

  • HubSpot → WhatsApp: quando um contato é criado ou um negócio passa para uma etapa, envie a essa pessoa uma mensagem de WhatsApp pelo seu próprio número.
  • WhatsApp → HubSpot: quando alguém manda mensagem para o seu número de WhatsApp, adicione a mensagem como nota no contato dela no HubSpot, e crie o contato se ele ainda não existir.

O WbizTool não tem um app para HubSpot. Estas receitas conectam os dois pelo Zapier, Make, n8n, Pabbly Connect ou um workflow do HubSpot, com templates prontos para Make e n8n.

Quem pode fazer isso: no WbizTool, um Proprietário cria a chave de API em Configurações → Chaves de API (veja Chaves de API); Proprietários e Editores configuram os Números da caixa de entrada para a direção WhatsApp → HubSpot. No HubSpot, você precisa de permissão para conectar apps ou editar workflows; cada caminho abaixo diz do que precisa.

Antes de começar#

Escolha um caminho#

CaminhoHubSpot → WhatsAppWhatsApp → HubSpotDo que precisa
ZapierGatilho New Contact ou Updated Deal Stage, depois uma ação de envio do WbizToolO gatilho Incoming WhatsApp Message do WbizTool, depois Find Contact e Create Engagement do HubSpotUma conta do Zapier. Nenhum webhook para configurar.
MakeWatch Contacts do HubSpot CRM, depois o módulo HTTPUm custom webhook do Make, depois requisições HTTP à API do HubSpotUma conta do Make. Não existe app do WbizTool no Make: o módulo HTTP chama a API do WbizTool.
n8nHubSpot Trigger, depois WbizTool Send MessageUm node Webhook, depois o node HubSpot e requisições HTTP ao HubSpotn8n com o community node do WbizTool. O HubSpot Trigger precisa de uma conta de desenvolvedor e de um app do HubSpot.
Pabbly ConnectUm gatilho do HubSpot, depois API (Pabbly)Webhook by Pabbly, depois requisições à API do HubSpotUma conta do Pabbly Connect. Funciona pelas etapas de HTTP e de webhook do Pabbly.
Workflow do HubSpotA ação Send a webhook chama a API do WbizTool diretamenteUse outro caminhoData Hub Professional ou Enterprise. Nenhuma outra ferramenta necessária.

Números de telefone#

As duas direções escrevem os números de jeitos diferentes, então confira isto antes de mapear os campos.

HubSpot → WhatsApp. Mapeie o Phone number (ou Mobile phone number) do contato no phone do destinatário. O WbizTool remove espaços, hífens, pontos e parênteses para você, então +1 (212) 555-0120 funciona. Um número salvo com + ou 00 traz o código do país. Um número salvo sem ele, como 2125550120, precisa do código do país: preencha Country Code no Zapier e no n8n, ou country_code em uma requisição HTTP, como 1 ou 91. Um número salvo com código do país e sem +, como 12125550120, funciona como está. Veja phone e country_code em Enviar mensagem.

WhatsApp → HubSpot. O webhook traz quem envia como dígitos internacionais sem +, em contact.phone, como 12125550120. O HubSpot pesquisa números de telefone só pelo código de área e pelo número local, sem o código do país. Então, antes de pesquisar, remova o seu código do país do começo: 12125550120 vira 2125550120. Os templates fazem isso para um código do país que você define. Ao criar um contato, salve o número como + seguido dos dígitos, como +12125550120, para que o HubSpot saiba o país.

Enviar uma mensagem de WhatsApp a partir do HubSpot#

Com Zapier#

Use o gatilho do HubSpot de que precisar e depois uma ação do WbizTool. Conecte o WbizTool com o seu Client ID e a sua chave de API (veja Integração com Zapier).

Quando um contato é criado:

  1. Gatilho: HubSpot, New Contact

    Escolha HubSpot e o gatilho New Contact (novo contato), e conecte sua conta do HubSpot.

  2. Filter by Zapier

    Continue só quando o número de telefone do contato existir. Contatos sem número fariam a próxima etapa falhar.

  3. Ação: WbizTool, Send Text-Only WhatsApp Message

    Escolha o número que envia em WhatsApp Number. Mapeie Phone Number no número de telefone do contato. Preencha Country Code só se os seus números no HubSpot forem salvos sem ele. Escreva a Message, por exemplo Olá {first name}, obrigado pelo contato. Você pode falar conosco aqui no WhatsApp.

  4. Teste e publique

    Uma etapa bem-sucedida significa que a mensagem entrou na fila. Depois, o WbizTool a envia pelo seu número.

Quando um negócio passa para uma etapa:

  1. Gatilho: HubSpot, Updated Deal Stage

    Escolha Updated Deal Stage (etapa do negócio atualizada) e escolha o pipeline e a etapa, como Closed won.

  2. Encontre o contato do negócio

    Um negócio não guarda um número de telefone: o contato dele, sim. Adicione Get Contact do HubSpot com o ID do contato associado ao negócio. Se os dados do gatilho não tiverem um ID de contato, adicione antes Find Associations do HubSpot para obter os contatos do negócio.

  3. Filtre e depois envie

    Adicione uma etapa Filter by Zapier que continue quando o número de telefone existir e depois Send Text-Only WhatsApp Message como acima. Você pode usar campos do negócio no texto, como o nome do negócio.

Com Make#

Não existe app do WbizTool no Make. O módulo HTTP do Make chama a API Enviar mensagem. Dos dois templates do Make, este usa uma conexão do HubSpot no Make (Watch Contacts); o de WhatsApp → HubSpot usa só módulos integrados do Make e uma service key do HubSpot.

  1. Importe o template ou comece um cenário

    Importe hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint em um novo cenário), ou monte-o com as etapas abaixo.

  2. HubSpot CRM, Watch Contacts

    Adicione o módulo Watch Contacts do HubSpot CRM e conecte o HubSpot. Um Super Admin da sua conta do HubSpot precisa aprovar o app do Make primeiro. O Make pergunta por onde começar: escolha From now on para enviar mensagem só para contatos novos.

  3. HTTP, Make a request

    Método POST, URL https://wbiztool.com/api/v1/send_msg/. Adicione um cabeçalho Authorization com o valor Bearer YOUR_API_KEY. Tipo de corpo application/x-www-form-urlencoded, com estes campos:

    CampoValor
    whatsapp_clientO seu WhatsApp Client ID, como 678
    phoneO Phone number do contato, do módulo do HubSpot
    country_codeSó se os seus números forem salvos sem ele, como 1
    msgO seu texto, com campos como o primeiro nome mapeados
  4. Adicione um filtro e execute uma vez

    Na ligação entre os dois módulos, adicione um filtro que só passe quando o número de telefone existir. Execute o cenário uma vez: uma resposta com "status": 1 significa que a mensagem entrou na fila.

Campos de formulário continuam funcionando quando um valor mapeado tem aspas ou quebras de linha, que podem quebrar um corpo JSON bruto. JSON também funciona; veja Campos do corpo. Para uma etapa de negócio no Make, use um workflow do HubSpot que envie para um custom webhook do Make, ou o caminho do Zapier ou do n8n.

Com n8n#

O template hubspot-to-whatsapp.n8n.json trata os dois eventos em um só workflow: um contato novo e um negócio que passa para uma etapa.

  1. Instale o node do WbizTool

    Instale n8n-nodes-wbiztool e crie uma credencial WbizTool API. Veja Integração com n8n.

  2. Crie as credenciais do HubSpot

    O HubSpot Trigger precisa de uma credencial HubSpot Developer API: uma conta de desenvolvedor do HubSpot, um app com escopos de leitura para contatos e negócios, e a URL de redirecionamento do n8n nesse app (veja a página de credenciais do HubSpot do n8n). As outras etapas do HubSpot usam uma credencial HubSpot Service Key: no HubSpot, acesse Development → Keys → Service keys, clique em Create service key e adicione os escopos de leitura de contatos e negócios.

  3. Importe o workflow

    No n8n, importe o arquivo e escolha suas credenciais em cada node HubSpot, HTTP Request e WbizTool.

  4. Defina sua etapa e sua mensagem

    No node Deal stage is, substitua closedwon pelo valor interno da sua etapa. Edite o texto nos dois nodes WbizTool Send Message e defina Country Code neles só se os seus números forem salvos sem ele.

  5. Ative

    O gatilho então registra o webhook dele no HubSpot.

O que o workflow faz:

  1. HubSpot Trigger com dois eventos: Contact Created e Deal Property Changed para a propriedade Deal Stage.
  2. Um node IF manda os eventos de contato para um lado e os de negócio para o outro.
  3. Para um negócio, ele confere a nova etapa e depois lê o negócio e os contatos associados com um HTTP Request ao HubSpot.
  4. HubSpot → Search Contacts lê o primeiro nome e os números de telefone do contato.
  5. WbizTool Send Message envia o texto para o número de telefone, ou para o celular quando o telefone está vazio.

Com um workflow do HubSpot#

Com o Data Hub Professional ou Enterprise, um workflow pode chamar a API do WbizTool sozinho com a ação Send a webhook. Nenhuma outra ferramenta participa.

  1. Crie um workflow baseado em contatos

    No HubSpot, acesse Automation → Workflows e crie um workflow de contatos, com o gatilho que você quiser, como a criação de um contato ou a mudança da fase do ciclo de vida dele.

  2. Adicione Send a webhook

    Clique em + e, em Data ops, escolha Send a webhook. Método POST, URL do webhook https://wbiztool.com/api/v1/send_msg/.

  3. Configure a autenticação

    Escolha API key como tipo de autenticação. Adicione um secret cujo valor seja Bearer YOUR_API_KEY (com a sua chave do WbizTool), defina o nome da API key como Authorization e o local como Request header.

  4. Personalize o corpo da requisição

    Escolha Customize request body e adicione:

    ChaveValor
    phoneProperty: Phone number
    whatsapp_clientStatic value: o seu WhatsApp Client ID, como 678
    msgStatic value: a sua mensagem
    country_codeStatic value, só se os seus números forem salvos sem ele
  5. Teste

    Teste a ação com um contato que tenha o seu próprio número. O WbizTool responde {"status": 1, "message": "Created", "msg_id": …} quando colocou a mensagem na fila.

  • A mensagem não pode incluir o nome do contato. Em Customize request body, cada chave recebe uma propriedade do HubSpot ou um valor fixo, então msg é um texto fixo, igual para todos os contatos. Para uma saudação personalizada, use o caminho do Zapier, do Make ou do n8n.
  • Novas tentativas: o HubSpot tenta de novo um webhook que falhou por até três dias. Ele não tenta de novo respostas 4xx, exceto 429, então uma mensagem recusada, como Invalid phone number, não é enviada de novo. Para que uma nova tentativa após um timeout não envie uma mensagem duas vezes, adicione uma chave idempotency_key com a propriedade Record ID, se o workflow enviar mensagem para cada contato no máximo uma vez por dia. Veja Tentar de novo com segurança.
  • Negócios: estas etapas usam um workflow baseado em contatos, porque o número de telefone fica no contato, não no negócio. Para mensagens em uma etapa de negócio, use o caminho do Zapier ou do n8n.

Com Pabbly Connect#

O Pabbly Connect inicia um workflow a partir de eventos do HubSpot como New Contact Added ou Deal Updated. Depois, adicione API (Pabbly) → Execute API Request com POST para https://wbiztool.com/api/v1/send_msg/, como em Enviar mensagens de WhatsApp a partir de qualquer ferramenta de automação, e mapeie o número de telefone do contato em phone.

Registrar mensagens de WhatsApp recebidas no HubSpot#

Cada mensagem que alguém envia ao seu número vira uma nota no contato dessa pessoa no HubSpot. Esta direção 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), porque as mensagens saem do WbizTool pelo webhook dos Números da caixa de entrada.

A receita é a mesma em todas as ferramentas:

  1. Pule os chats de grupo (contact.is_group é true) e os contatos cujo número o WhatsApp oculta (contact.phone_hidden é true).
  2. Remova o seu código do país do começo de contact.phone (veja Números de telefone).
  3. Pesquise contatos do HubSpot cujo Phone number ou Mobile phone number seja igual a esse número.
  4. Se não houver nenhum, crie um contato com Phone number + e contact.phone, e First name contact.name.
  5. Crie uma nota no contato com a mensagem: message.content, em message.timestamp.

Com Zapier#

Você não define uma URL de webhook em lugar nenhum: o gatilho do WbizTool se conecta ao Zapier quando você publica o Zap.

  1. Gatilho: WbizTool, Incoming WhatsApp Message

    Escolha o número em WhatsApp Number. O Zap ocupa um dos seus números da caixa de entrada (veja Requisitos do gatilho). Só as mensagens que as pessoas enviam a você o iniciam.

  2. Filter by Zapier

    Continue só quando Contact Phone Hidden for falso e Is Group for falso.

  3. Formatter by Zapier: remova o código do país

    Escolha Formatter, action event Numbers, transform Format Phone Number. Input: + seguido de Contact Phone. Em To Format, escolha um formato nacional sem símbolos, para que +12125550120 vire 2125550120.

  4. HubSpot, Find Contact

    Pesquise por Phone Number com a saída do Formatter. Marque a opção de criar o contato se ele não for encontrado, com Phone Number + e Contact Phone, e First Name a partir de Contact Name.

  5. HubSpot, Create Engagement

    Tipo Note, associada ao ID do contato da etapa Find Contact. Corpo: WhatsApp de Contact Name: Message Content.

Com Make#

  1. Importe o template

    Importe hubspot-whatsapp-to-note.make.json em um novo cenário.

  2. Adicione a sua service key do HubSpot

    No HubSpot, acesse Development → Keys → Service keys, clique em Create service key e adicione os escopos de leitura e escrita de contatos. Em cada módulo HTTP do cenário, substitua YOUR_HUBSPOT_SERVICE_KEY no cabeçalho Authorization por essa chave.

  3. Crie o webhook

    No módulo Webhooks → Custom webhook, clique em Add, dê um nome a ele e copie o endereço.

  4. Adicione o endereço ao seu número da caixa de entrada

    No WbizTool, abra Números da caixa de entrada, clique em Configurações do webhook no cartão do número (ou em Adicionar número à caixa de entrada), cole o endereço em URL do webhook (opcional) e clique em Salvar. Mantenha Mensagens recebidas marcada; marque também Mensagens enviadas se quiser as suas respostas no HubSpot.

  5. Defina o seu código do país

    No módulo Search the contact by phone, o template remove 1 do começo do número (/^1/, duas vezes). Substitua 1 pelo seu código do país, como 91.

  6. Ative o cenário

    Envie uma mensagem para o seu número de WhatsApp de outro celular. Ela chega em um ou dois minutos, e o Make aprende os campos do webhook com ela: confira os mapeamentos uma vez.

O cenário: Custom webhook → uma requisição HTTP à pesquisa de contatos do HubSpot → um router. Quando um contato é encontrado, uma requisição HTTP adiciona a nota a ele. Quando nenhum é encontrado, uma requisição cria o contato e outra adiciona a nota. As etapas JSON → Transform to JSON transformam a mensagem e o nome em texto JSON, para que aspas e quebras de linha não quebrem as requisições.

Com n8n#

  1. Importe o workflow

    Importe hubspot-whatsapp-to-note.n8n.json e escolha uma credencial HubSpot Service Key nos nodes HubSpot e HTTP Request. A chave precisa dos escopos de leitura e escrita de contatos.

  2. Defina o seu código do país

    No node National number, defina countryCode como o seu, por exemplo 91.

  3. Ative e copie o endereço

    Ative o workflow e copie a Production URL do node WbizTool webhook.

  4. Adicione o endereço ao seu número da caixa de entrada

    Cole-o como webhook do número em Números da caixa de entrada, como nas etapas do Make acima.

O node HubSpot do n8n não tem uma ação de nota, então o workflow cria o contato e a nota com nodes HTTP Request que usam a mesma credencial do HubSpot. O node Webhook responde na hora, bem dentro dos 8 segundos que o WbizTool espera.

Com Pabbly Connect#

Comece com Webhook by Pabbly e cole a URL dele como webhook do número em Números da caixa de entrada. Depois, chame a API do HubSpot com API (Pabbly) → Execute API Request, com uma service key do HubSpot como token Bearer: POST https://api.hubapi.com/crm/objects/2026-09/contacts/search para encontrar o contato, POST …/contacts para criar um e POST …/notes para adicionar a nota (veja As requisições que o seu servidor faz).

No seu próprio servidor#

Receba o webhook como descrito em Webhooks de mensagens recebidas, verifique a assinatura dele, responda 200 na hora e depois faça estas chamadas à API do HubSpot com uma service key.

As requisições que o seu servidor faz

EtapaRequisiçãoCorpo
Encontrar o contatoPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups com phone EQ o número sem o código do país, e um segundo grupo com mobilephone; limit 1
Criá-lo se não existirPOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties: phone +12125550120, firstname a partir de contact.name
Adicionar a notaPOST https://api.hubapi.com/crm/objects/2026-09/notesproperties: hs_timestamp a partir de message.timestamp, hs_note_body com o texto; associations ao contato com associationCategory HUBSPOT_DEFINED e associationTypeId 202 (nota para contato)
{
  "properties": {
    "hs_timestamp": "2026-10-15T10:30:04+00:00",
    "hs_note_body": "WhatsApp from Emma Thompson (+12125550120): Can I add a gift note to it?"
  },
  "associations": [
    {
      "to": { "id": "CONTACT_ID" },
      "types": [{ "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 202 }]
    }
  ]
}

Os endpoints de pesquisa do HubSpot permitem cinco requisições por segundo por conta. Pule um message.id que você já registrou: o WbizTool pode, raramente, enviar uma mensagem duas vezes.

Templates#

ArquivoFerramentaO que faz
hubspot-new-contact-to-whatsapp.make.jsonMakeNovo contato do HubSpot → mensagem de WhatsApp
hubspot-whatsapp-to-note.make.jsonMakeWhatsApp recebido → nota no contato (precisa do add-on Unibox)
hubspot-to-whatsapp.n8n.jsonn8nNovo contato ou etapa de negócio → mensagem de WhatsApp
hubspot-whatsapp-to-note.n8n.jsonn8nWhatsApp recebido → nota no contato (precisa do add-on Unibox)

Os templates não contêm chaves. Depois de importar, escolha as suas próprias conexões ou credenciais em cada etapa e substitua YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, o WhatsApp Client ID 678 e o código do país pelos seus.

Solução de problemas#

ProblemaO que verificar
Invalid phone numberO telefone do contato está vazio, tem letras ou tem menos de 6 ou mais de 17 dígitos. Adicione um filtro que pule contatos sem número.
A mensagem vai para o número erradoO número está salvo sem o código do país e nenhum foi enviado. Preencha Country Code ou country_code, ou salve os números no HubSpot com +.
Auth Error: invalid api keyA chave foi excluída ou digitada errado. Em um workflow do HubSpot, o valor do secret precisa ser Bearer seguido da chave, e o nome da API key Authorization.
Invalid whatsapp clientUse o ID do número de Números do WhatsApp.
Send a webhook não aparece nas ações do workflowPrecisa do Data Hub Professional ou Enterprise. Use Zapier, Make, n8n ou Pabbly Connect.
O Make não consegue se conectar ao HubSpotUm Super Admin da conta do HubSpot precisa aprovar o app do Make primeiro.
Nenhuma nota aparece no HubSpotConfira se o número mostra Sincronizando em Números da caixa de entrada, se a URL do webhook é a da sua ferramenta e se Mensagens recebidas está marcada. Envie uma mensagem de outro celular: as respostas da caixa de entrada Unibox não são enviadas.
Os webhooks não chegam, ou o seu host os recusaO seu receptor precisa responder 2xx em até 8 segundos e não pode redirecionar. Alguns firewalls de hospedagem bloqueiam clientes desconhecidos: os webhooks do WbizTool chegam com o User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), então libere-o.
Um novo contato é criado para alguém que já está no HubSpotO HubSpot não encontrou o número. Confira se o código do país que você remove está certo e se o número do contato está em Phone number ou Mobile phone number. Para clientes em vários países, veja Números de telefone.
Uma mensagem é registrada duas vezesO WbizTool pode, raramente, enviar uma mensagem duas vezes. Pule um message.id que você já registrou.
Não há nota para algumas mensagensChats de grupo e contatos cujo número o WhatsApp oculta são pulados de propósito. Mensagens do período em que o número estava parado não são enviadas.

Relacionados#