Integraciones
HubSpot y WhatsApp
Conecta HubSpot con tu número de WhatsApp en las dos direcciones:
- HubSpot → WhatsApp: cuando se crea un contacto o un negocio pasa a una etapa, envía a esa persona un mensaje de WhatsApp desde tu propio número.
- WhatsApp → HubSpot: cuando alguien escribe a tu número de WhatsApp, añade el mensaje como nota en su contacto de HubSpot, y crea el contacto si todavía no existe.
WbizTool no tiene una app de HubSpot. Estas recetas conectan los dos a través de Zapier, Make, n8n, Pabbly Connect o un flujo de trabajo de HubSpot, con plantillas listas para Make y n8n.
Quién puede hacerlo: en WbizTool, un Propietario crea la clave API en Configuración → Claves API (consulta Claves API); los Propietarios y los Editores configuran Números de la bandeja para la dirección WhatsApp → HubSpot. En HubSpot, necesitas permisos para conectar apps o editar flujos de trabajo; cada vía de abajo indica lo que necesita.
Antes de empezar#
- Un número de WhatsApp conectado en Números de WhatsApp. Consulta Conecta tu número de WhatsApp.
- Tu clave API, y para algunas herramientas tu Client ID, de Configuración → Claves API, y el WhatsApp Client ID del número que envía (su ID en Números de WhatsApp).
- Solo para WhatsApp → HubSpot: el complemento Unibox. Los mensajes entrantes llegan a HubSpot a través del webhook de Números de la bandeja, que necesita el complemento Unibox: $20 al mes o $200 al año según los precios de lista en EE. UU. por cada número de la bandeja, en un plan de pago o de por vida (no en la prueba gratuita). Para enviar mensajes no hace falta.
Elige una vía#
| Vía | HubSpot → WhatsApp | WhatsApp → HubSpot | Qué necesita |
|---|---|---|---|
| Zapier | Disparador New Contact o Updated Deal Stage, y luego una acción de envío de WbizTool | El disparador Incoming WhatsApp Message de WbizTool, y luego Find Contact y Create Engagement de HubSpot | Una cuenta de Zapier. No hay que configurar ningún webhook. |
| Make | Watch Contacts de HubSpot CRM, y luego el módulo HTTP | Un webhook personalizado de Make, y luego solicitudes HTTP a la API de HubSpot | Una cuenta de Make. No hay app de WbizTool en Make: el módulo HTTP llama a la API de WbizTool. |
| n8n | HubSpot Trigger, y luego WbizTool Send Message | Un nodo Webhook, y luego el nodo HubSpot y solicitudes HTTP a HubSpot | n8n con el nodo de la comunidad de WbizTool. El HubSpot Trigger necesita una cuenta y una app de desarrollador de HubSpot. |
| Pabbly Connect | Un disparador de HubSpot, y luego API (Pabbly) | Webhook by Pabbly, y luego solicitudes de API a HubSpot | Una cuenta de Pabbly Connect. Funciona con los pasos HTTP y de webhook de Pabbly. |
| Flujo de trabajo de HubSpot | La acción Send a webhook llama directamente a la API de WbizTool | Usa otra vía | Data Hub Professional o Enterprise. No hace falta otra herramienta. |
Números de teléfono#
Las dos direcciones escriben los números de forma distinta, así que revisa esto antes de asignar campos.
HubSpot → WhatsApp. Asigna el Phone number (o Mobile phone number) del contacto al phone del destinatario. WbizTool quita por ti los espacios, guiones, puntos y paréntesis, así que +1 (212) 555-0120 funciona. Un número guardado con + o 00 lleva su código de país. Un número guardado sin él, como 2125550120, necesita el código de país: rellena Country Code en Zapier y n8n, o country_code en una solicitud HTTP, como 1 o 91. Un número guardado con el código de país y sin +, como 12125550120, funciona tal cual. Consulta phone y country_code en Enviar mensaje.
WhatsApp → HubSpot. El webhook da el remitente como dígitos internacionales sin +, en contact.phone, como 12125550120. HubSpot busca los números de teléfono solo por el código de área y el número local, sin el código de país. Así que antes de buscar, quita tu código de país del principio: 12125550120 pasa a ser 2125550120. Las plantillas lo hacen con un código de país que tú defines. Cuando crees un contacto, guarda el número como + seguido de los dígitos, como +12125550120, para que HubSpot sepa de qué país es.
Enviar un mensaje de WhatsApp desde HubSpot#
Con Zapier#
Usa el disparador de HubSpot que necesites y luego una acción de WbizTool. Conecta WbizTool con tu Client ID y tu API key (consulta Integración con Zapier).
Cuando se crea un contacto:
Disparador: HubSpot, New Contact
Elige HubSpot y el disparador New Contact (contacto nuevo), y conecta tu cuenta de HubSpot.
Filter by Zapier
Continúa solo cuando el número de teléfono del contacto exists (existe). Los contactos sin número harían fallar el paso siguiente.
Acción: WbizTool, Send Text-Only WhatsApp Message
Elige el número que envía en WhatsApp Number. Asigna Phone Number al número de teléfono del contacto. Rellena Country Code solo si tus números de HubSpot están guardados sin él. Escribe el Message, por ejemplo
Hi {first name}, thanks for getting in touch. You can reach us here on WhatsApp.Prueba y publica
Un paso correcto significa que el mensaje se puso en cola. Después WbizTool lo envía desde tu número.
Cuando un negocio pasa a una etapa:
Disparador: HubSpot, Updated Deal Stage
Elige Updated Deal Stage (etapa del negocio actualizada) y elige el pipeline y la etapa, como Closed won.
Busca el contacto del negocio
Un negocio no tiene número de teléfono: lo tiene su contacto. Añade Get Contact de HubSpot con el ID del contacto asociado al negocio. Si los datos del disparador no tienen ID de contacto, añade antes Find Associations de HubSpot para obtener los contactos del negocio.
Filtra y luego envía
Añade un paso Filter by Zapier que continúe cuando exista el número de teléfono, y luego Send Text-Only WhatsApp Message como arriba. Puedes usar campos del negocio en el texto, como su nombre.
Con Make#
No hay app de WbizTool en Make. El módulo HTTP de Make llama a la API de envío de mensajes. De las dos plantillas de Make, esta usa una conexión de HubSpot en Make (Watch Contacts); la de WhatsApp → HubSpot solo usa los módulos integrados de Make y una clave de servicio de HubSpot.
Importa la plantilla o empieza un escenario
Importa hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint en un escenario nuevo), o créalo con los pasos de abajo.
HubSpot CRM, Watch Contacts
Añade el módulo Watch Contacts de HubSpot CRM y conecta HubSpot. Antes, un Super Admin de tu cuenta de HubSpot tiene que aprobar la app de Make. Make pregunta desde dónde empezar: elige From now on para escribir solo a los contactos nuevos.
HTTP, Make a request
Método
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Añade una cabeceraAuthorizationcon el valorBearer YOUR_API_KEY. Tipo de cuerpo application/x-www-form-urlencoded, con estos campos:Campo Valor whatsapp_clientTu WhatsApp Client ID, como 678phoneEl Phone number del contacto, del módulo de HubSpot country_codeSolo si tus números están guardados sin él, como 1msgTu texto, con campos como el nombre asignados Añade un filtro y ejecútalo una vez
En el enlace entre los dos módulos, añade un filtro que deje pasar solo cuando exista el número de teléfono. Ejecuta el escenario una vez: una respuesta con
"status": 1significa que el mensaje se puso en cola.
Los campos de formulario siguen funcionando cuando un valor asignado tiene comillas o saltos de línea, que pueden romper un cuerpo JSON en bruto. JSON también funciona; consulta Campos del cuerpo. Para una etapa de negocio en Make, usa un flujo de trabajo de HubSpot que envíe a un webhook personalizado de Make, o la vía de Zapier o de n8n.
Con n8n#
La plantilla hubspot-to-whatsapp.n8n.json gestiona los dos eventos en un solo flujo de trabajo: un contacto nuevo y un negocio que pasa a una etapa.
Instala el nodo de WbizTool
Instala
n8n-nodes-wbiztooly crea una credencial WbizTool API. Consulta Integración con n8n.Crea las credenciales de HubSpot
El HubSpot Trigger necesita una credencial HubSpot Developer API: una cuenta de desarrollador de HubSpot, una app con permisos de lectura de contactos y negocios, y la URL de redirección de n8n en esa app (consulta la página de credenciales de HubSpot de n8n). Los demás pasos de HubSpot usan una credencial HubSpot Service Key: en HubSpot, ve a Development → Keys → Service keys, haz clic en Create service key y añade los permisos de lectura de contactos y negocios.
Importa el flujo de trabajo
En n8n, importa el archivo y elige tus credenciales en cada nodo de HubSpot, HTTP Request y WbizTool.
Define tu etapa y tu mensaje
En el nodo Deal stage is, sustituye
closedwonpor el valor interno de tu etapa. Edita el texto de los dos nodos WbizTool Send Message, y rellena allí Country Code solo si tus números están guardados sin él.Activa
Entonces el disparador registra su webhook en HubSpot.
Lo que hace el flujo de trabajo:
- HubSpot Trigger con dos eventos: Contact Created, y Deal Property Changed para la propiedad Deal Stage.
- Un nodo IF envía los eventos de contactos por un lado y los de negocios por otro.
- Para un negocio, comprueba la nueva etapa y luego lee el negocio y sus contactos asociados con un HTTP Request a HubSpot.
- HubSpot → Search Contacts lee el nombre y los números de teléfono del contacto.
- WbizTool Send Message envía el texto al número de teléfono, o al móvil cuando el teléfono está vacío.
Con un flujo de trabajo de HubSpot#
Con Data Hub Professional o Enterprise, un flujo de trabajo puede llamar él mismo a la API de WbizTool con la acción Send a webhook. No interviene ninguna otra herramienta.
Crea un flujo de trabajo basado en contactos
En HubSpot, ve a Automation → Workflows y crea un flujo de trabajo de contactos, con el disparador que quieras, como la creación de un contacto o un cambio en su etapa del ciclo de vida.
Añade Send a webhook
Haz clic en + y, en Data ops, elige Send a webhook. Método
POST, URL del webhookhttps://wbiztool.com/api/v1/send_msg/.Configura la autenticación
Elige API key como tipo de autenticación. Añade un secreto cuyo valor sea
Bearer YOUR_API_KEY(con tu clave de WbizTool), ponAuthorizationcomo nombre de la clave API y Request header como ubicación.Personaliza el cuerpo de la solicitud
Elige Customize request body y añade:
Clave Valor phonePropiedad: Phone number whatsapp_clientValor fijo: tu WhatsApp Client ID, como 678msgValor fijo: tu mensaje country_codeValor fijo, solo si tus números están guardados sin él Pruébalo
Prueba la acción con un contacto que tenga tu propio número. WbizTool responde
{"status": 1, "message": "Created", "msg_id": …}cuando ha puesto el mensaje en cola.
- El mensaje no puede incluir el nombre del contacto. En Customize request body, cada clave admite una propiedad de HubSpot o un valor fijo, así que
msges un texto fijo, el mismo para todos los contactos. Para un saludo personal, usa la vía de Zapier, Make o n8n. - Reintentos: HubSpot reintenta un webhook fallido durante un máximo de tres días. No reintenta las respuestas
4xxsalvo429, así que un mensaje rechazado, por ejemplo conInvalid phone number, no se vuelve a enviar. Para evitar que un reintento tras un tiempo de espera agotado envíe un mensaje dos veces, añade una claveidempotency_keycon la propiedad Record ID, si el flujo de trabajo escribe a cada contacto como mucho una vez al día. Consulta Reintentar con seguridad. - Negocios: estos pasos usan un flujo de trabajo basado en contactos, porque el número de teléfono está en el contacto, no en el negocio. Para mensajes según la etapa de un negocio, usa la vía de Zapier o de n8n.
Con Pabbly Connect#
Pabbly Connect inicia un flujo de trabajo a partir de eventos de HubSpot como New Contact Added o Deal Updated. Después añade API (Pabbly) → Execute API Request con POST a https://wbiztool.com/api/v1/send_msg/, como en Enviar mensajes de WhatsApp desde cualquier herramienta de automatización, y asigna el número de teléfono del contacto a phone.
Registrar los mensajes de WhatsApp entrantes en HubSpot#
Cada mensaje que alguien envía a tu número se convierte en una nota en su contacto de HubSpot. Esta dirección necesita el complemento Unibox ($20 al mes o $200 al año según los precios de lista en EE. UU. por cada número de la bandeja, en un plan de pago o de por vida), porque los mensajes salen de WbizTool a través del webhook de Números de la bandeja.
La receta es la misma en todas las herramientas:
- Omite los chats de grupo (
contact.is_groupestrue) y los contactos cuyo número oculta WhatsApp (contact.phone_hiddenestrue). - Quita tu código de país del principio de
contact.phone(consulta Números de teléfono). - Busca contactos de HubSpot cuyo Phone number o Mobile phone number sea igual a ese número.
- Si no hay ninguno, crea un contacto con Phone number
+ycontact.phone, y First namecontact.name. - Crea una nota en el contacto con el mensaje:
message.content, enmessage.timestamp.
Con Zapier#
No configuras ninguna URL de webhook: el disparador de WbizTool se conecta a Zapier cuando publicas el Zap.
Disparador: WbizTool, Incoming WhatsApp Message
Elige el número en WhatsApp Number. El Zap ocupa uno de tus números de la bandeja (consulta Requisitos del disparador). Solo lo inician los mensajes que te envían.
Filter by Zapier
Continúa solo cuando Contact Phone Hidden sea false e Is Group sea false.
Formatter by Zapier: quita el código de país
Elige Formatter, evento de acción Numbers, transformación Format Phone Number. Entrada:
+seguido de Contact Phone. Elige en To Format un formato nacional sin símbolos, para que+12125550120pase a ser2125550120.HubSpot, Find Contact
Busca por Phone Number con la salida del Formatter. Marca la opción de crear el contacto si no se encuentra, con Phone Number
+y Contact Phone, y First Name a partir de Contact Name.HubSpot, Create Engagement
Tipo Note, asociada al ID del contacto del paso Find Contact. Cuerpo:
WhatsApp fromContact Name: Message Content.
Con Make#
Importa la plantilla
Importa hubspot-whatsapp-to-note.make.json en un escenario nuevo.
Añade tu clave de servicio de HubSpot
En HubSpot, ve a Development → Keys → Service keys, haz clic en Create service key y añade los permisos de lectura y escritura de contactos. En cada módulo HTTP del escenario, sustituye
YOUR_HUBSPOT_SERVICE_KEYen la cabeceraAuthorizationpor esa clave.Crea el webhook
En el módulo Webhooks → Custom webhook, haz clic en Add, ponle un nombre y copia su dirección.
Añade la dirección a tu número de la bandeja
En WbizTool, abre Números de la bandeja, haz clic en Configuración del webhook en la tarjeta del número (o en Añadir número a la bandeja), pega la dirección en URL del webhook (opcional) y haz clic en Guardar. Deja Mensajes recibidos marcado; marca también Mensajes enviados si quieres tus respuestas en HubSpot.
Define tu código de país
En el módulo Search the contact by phone, la plantilla quita
1del principio del número (/^1/, dos veces). Sustituye1por tu código de país, como91.Activa el escenario
Envía un mensaje a tu número de WhatsApp desde otro teléfono. Llega en uno o dos minutos, y Make aprende con él los campos del webhook: revisa las asignaciones una vez.
El escenario: Custom webhook → una solicitud HTTP a la búsqueda de contactos de HubSpot → un router. Cuando se encuentra un contacto, una solicitud HTTP le añade la nota. Cuando no, una solicitud crea el contacto y otra añade la nota. Los pasos JSON → Transform to JSON convierten el mensaje y el nombre en texto JSON, para que las comillas y los saltos de línea no rompan las solicitudes.
Con n8n#
Importa el flujo de trabajo
Importa hubspot-whatsapp-to-note.n8n.json y elige una credencial HubSpot Service Key en los nodos HubSpot y HTTP Request. La clave necesita los permisos de lectura y escritura de contactos.
Define tu código de país
En el nodo National number, pon en
countryCodeel tuyo, como91.Activa y copia la dirección
Activa el flujo de trabajo y copia la Production URL del nodo WbizTool webhook.
Añade la dirección a tu número de la bandeja
Pégala como webhook del número en Números de la bandeja, como en los pasos de Make de arriba.
El nodo HubSpot de n8n no tiene una acción de notas, así que el flujo de trabajo crea el contacto y la nota con nodos HTTP Request que usan la misma credencial de HubSpot. El nodo Webhook responde al instante, muy por debajo de los 8 segundos que espera WbizTool.
Con Pabbly Connect#
Empieza con Webhook by Pabbly y pega su URL como webhook del número en Números de la bandeja. Después llama a la API de HubSpot con API (Pabbly) → Execute API Request, con una clave de servicio de HubSpot como token Bearer: POST https://api.hubapi.com/crm/objects/2026-09/contacts/search para buscar el contacto, POST …/contacts para crear uno y POST …/notes para añadir la nota (consulta Las solicitudes que hace tu servidor).
En tu propio servidor#
Recibe el webhook como se describe en Webhooks de mensajes entrantes, verifica su firma, responde 200 al instante y luego haz estas llamadas a la API de HubSpot con una clave de servicio.
Las solicitudes que hace tu servidor
| Paso | Solicitud | Cuerpo |
|---|---|---|
| Buscar el contacto | POST https://api.hubapi.com/crm/objects/2026-09/contacts/search | filterGroups con phone EQ el número sin su código de país, y un segundo grupo con mobilephone; limit 1 |
| Crearlo si falta | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties: phone +12125550120, firstname a partir de contact.name |
| Añadir la nota | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties: hs_timestamp a partir de message.timestamp, hs_note_body con el texto; associations al contacto con associationCategory HUBSPOT_DEFINED y associationTypeId 202 (nota a contacto) |
{
"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 }]
}
]
}
Los endpoints de búsqueda de HubSpot permiten cinco solicitudes por segundo por cuenta. Omite un message.id que ya hayas registrado: WbizTool puede, en raras ocasiones, enviar un mensaje dos veces.
Plantillas#
| Archivo | Herramienta | Qué hace |
|---|---|---|
| hubspot-new-contact-to-whatsapp.make.json | Make | Contacto nuevo de HubSpot → mensaje de WhatsApp |
| hubspot-whatsapp-to-note.make.json | Make | WhatsApp entrante → nota en el contacto (necesita el complemento Unibox) |
| hubspot-to-whatsapp.n8n.json | n8n | Contacto nuevo o etapa del negocio → mensaje de WhatsApp |
| hubspot-whatsapp-to-note.n8n.json | n8n | WhatsApp entrante → nota en el contacto (necesita el complemento Unibox) |
Las plantillas no contienen claves. Después de importarlas, elige tus propias conexiones o credenciales en cada paso, y sustituye YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, el WhatsApp Client ID 678 y el código de país por los tuyos.
Solución de problemas#
| Problema | Qué revisar |
|---|---|
Invalid phone number | El teléfono del contacto está vacío, tiene letras, o tiene menos de 6 o más de 17 dígitos. Añade un filtro que omita los contactos sin número. |
| El mensaje va a un número equivocado | El número está guardado sin su código de país y no se envió ninguno. Rellena Country Code o country_code, o guarda los números en HubSpot con +. |
Auth Error: invalid api key | La clave se eliminó o se escribió mal. En un flujo de trabajo de HubSpot, el valor del secreto debe ser Bearer seguido de la clave, y el nombre de la clave API Authorization. |
Invalid whatsapp client | Usa el ID del número de Números de WhatsApp. |
| Send a webhook no aparece en las acciones del flujo de trabajo | Necesita Data Hub Professional o Enterprise. Usa en su lugar Zapier, Make, n8n o Pabbly Connect. |
| Make no puede conectarse a HubSpot | Antes, un Super Admin de la cuenta de HubSpot tiene que aprobar la app de Make. |
| No aparece ninguna nota en HubSpot | Comprueba que el número muestre Sincronizando en Números de la bandeja, que la URL del webhook sea la de tu herramienta y que Mensajes recibidos esté marcado. Envía un mensaje desde otro teléfono: las respuestas desde la bandeja Unibox no se envían. |
| Los webhooks no llegan, o tu hosting los rechaza | Tu receptor debe responder 2xx en 8 segundos y no debe redirigir. Algunos firewalls de hosting bloquean clientes desconocidos: los webhooks de WbizTool llegan con el User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), así que permítelo. |
| Se crea un contacto nuevo para alguien que ya está en HubSpot | HubSpot no encontró el número. Comprueba que el código de país que quitas sea el correcto y que el número del contacto esté en Phone number o Mobile phone number. Para clientes en muchos países, consulta Números de teléfono. |
| Un mensaje se registra dos veces | WbizTool puede, en raras ocasiones, enviar un mensaje dos veces. Omite un message.id que ya hayas registrado. |
| Falta la nota de algunos mensajes | Los chats de grupo y los contactos cuyo número oculta WhatsApp se omiten a propósito. Los mensajes del tiempo en que el número estuvo detenido no se envían. |

