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#
- Um número de WhatsApp conectado em Números do WhatsApp. Veja Conecte seu número de WhatsApp.
- Sua chave de API, e para algumas ferramentas o seu Client ID, de Configurações → Chaves de API, e o WhatsApp Client ID do número que envia (o ID dele em Números do WhatsApp).
- Só para WhatsApp → HubSpot: o add-on Unibox. As mensagens recebidas chegam ao HubSpot pelo webhook dos Números da caixa de entrada, que 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 (não no teste grátis). Enviar mensagens não precisa dele.
Escolha um caminho#
| Caminho | HubSpot → WhatsApp | WhatsApp → HubSpot | Do que precisa |
|---|---|---|---|
| Zapier | Gatilho New Contact ou Updated Deal Stage, depois uma ação de envio do WbizTool | O gatilho Incoming WhatsApp Message do WbizTool, depois Find Contact e Create Engagement do HubSpot | Uma conta do Zapier. Nenhum webhook para configurar. |
| Make | Watch Contacts do HubSpot CRM, depois o módulo HTTP | Um custom webhook do Make, depois requisições HTTP à API do HubSpot | Uma conta do Make. Não existe app do WbizTool no Make: o módulo HTTP chama a API do WbizTool. |
| n8n | HubSpot Trigger, depois WbizTool Send Message | Um node Webhook, depois o node HubSpot e requisições HTTP ao HubSpot | n8n com o community node do WbizTool. O HubSpot Trigger precisa de uma conta de desenvolvedor e de um app do HubSpot. |
| Pabbly Connect | Um gatilho do HubSpot, depois API (Pabbly) | Webhook by Pabbly, depois requisições à API do HubSpot | Uma conta do Pabbly Connect. Funciona pelas etapas de HTTP e de webhook do Pabbly. |
| Workflow do HubSpot | A ação Send a webhook chama a API do WbizTool diretamente | Use outro caminho | Data 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:
Gatilho: HubSpot, New Contact
Escolha HubSpot e o gatilho New Contact (novo contato), e conecte sua conta do HubSpot.
Filter by Zapier
Continue só quando o número de telefone do contato existir. Contatos sem número fariam a próxima etapa falhar.
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.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:
Gatilho: HubSpot, Updated Deal Stage
Escolha Updated Deal Stage (etapa do negócio atualizada) e escolha o pipeline e a etapa, como Closed won.
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.
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.
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.
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.
HTTP, Make a request
Método
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Adicione um cabeçalhoAuthorizationcom o valorBearer YOUR_API_KEY. Tipo de corpo application/x-www-form-urlencoded, com estes campos:Campo Valor whatsapp_clientO seu WhatsApp Client ID, como 678phoneO Phone number do contato, do módulo do HubSpot country_codeSó se os seus números forem salvos sem ele, como 1msgO seu texto, com campos como o primeiro nome mapeados 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": 1significa 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.
Instale o node do WbizTool
Instale
n8n-nodes-wbiztoole crie uma credencial WbizTool API. Veja Integração com n8n.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.
Importe o workflow
No n8n, importe o arquivo e escolha suas credenciais em cada node HubSpot, HTTP Request e WbizTool.
Defina sua etapa e sua mensagem
No node Deal stage is, substitua
closedwonpelo 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.Ative
O gatilho então registra o webhook dele no HubSpot.
O que o workflow faz:
- HubSpot Trigger com dois eventos: Contact Created e Deal Property Changed para a propriedade Deal Stage.
- Um node IF manda os eventos de contato para um lado e os de negócio para o outro.
- 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.
- HubSpot → Search Contacts lê o primeiro nome e os números de telefone do contato.
- 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.
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.
Adicione Send a webhook
Clique em + e, em Data ops, escolha Send a webhook. Método
POST, URL do webhookhttps://wbiztool.com/api/v1/send_msg/.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 comoAuthorizatione o local como Request header.Personalize o corpo da requisição
Escolha Customize request body e adicione:
Chave Valor phoneProperty: Phone number whatsapp_clientStatic value: o seu WhatsApp Client ID, como 678msgStatic value: a sua mensagem country_codeStatic value, só se os seus números forem salvos sem ele 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, exceto429, então uma mensagem recusada, comoInvalid 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 chaveidempotency_keycom 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:
- Pule os chats de grupo (
contact.is_groupétrue) e os contatos cujo número o WhatsApp oculta (contact.phone_hiddenétrue). - Remova o seu código do país do começo de
contact.phone(veja Números de telefone). - Pesquise contatos do HubSpot cujo Phone number ou Mobile phone number seja igual a esse número.
- Se não houver nenhum, crie um contato com Phone number
+econtact.phone, e First namecontact.name. - Crie uma nota no contato com a mensagem:
message.content, emmessage.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.
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.
Filter by Zapier
Continue só quando Contact Phone Hidden for falso e Is Group for falso.
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+12125550120vire2125550120.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.HubSpot, Create Engagement
Tipo Note, associada ao ID do contato da etapa Find Contact. Corpo:
WhatsApp deContact Name: Message Content.
Com Make#
Importe o template
Importe hubspot-whatsapp-to-note.make.json em um novo cenário.
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_KEYno cabeçalhoAuthorizationpor essa chave.Crie o webhook
No módulo Webhooks → Custom webhook, clique em Add, dê um nome a ele e copie o endereço.
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.
Defina o seu código do país
No módulo Search the contact by phone, o template remove
1do começo do número (/^1/, duas vezes). Substitua1pelo seu código do país, como91.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#
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.
Defina o seu código do país
No node National number, defina
countryCodecomo o seu, por exemplo91.Ative e copie o endereço
Ative o workflow e copie a Production URL do node WbizTool webhook.
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
| Etapa | Requisição | Corpo |
|---|---|---|
| Encontrar o contato | POST https://api.hubapi.com/crm/objects/2026-09/contacts/search | filterGroups 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 existir | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties: phone +12125550120, firstname a partir de contact.name |
| Adicionar a nota | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties: 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#
| Arquivo | Ferramenta | O que faz |
|---|---|---|
| hubspot-new-contact-to-whatsapp.make.json | Make | Novo contato do HubSpot → mensagem de WhatsApp |
| hubspot-whatsapp-to-note.make.json | Make | WhatsApp recebido → nota no contato (precisa do add-on Unibox) |
| hubspot-to-whatsapp.n8n.json | n8n | Novo contato ou etapa de negócio → mensagem de WhatsApp |
| hubspot-whatsapp-to-note.n8n.json | n8n | WhatsApp 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#
| Problema | O que verificar |
|---|---|
Invalid phone number | O 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 errado | O 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 key | A 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 client | Use o ID do número de Números do WhatsApp. |
| Send a webhook não aparece nas ações do workflow | Precisa do Data Hub Professional ou Enterprise. Use Zapier, Make, n8n ou Pabbly Connect. |
| O Make não consegue se conectar ao HubSpot | Um Super Admin da conta do HubSpot precisa aprovar o app do Make primeiro. |
| Nenhuma nota aparece no HubSpot | Confira 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 recusa | O 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 HubSpot | O 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 vezes | O WbizTool pode, raramente, enviar uma mensagem duas vezes. Pule um message.id que você já registrou. |
| Não há nota para algumas mensagens | Chats 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. |

