Saltar al contenido
WbizTool

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#

Elige una vía#

VíaHubSpot → WhatsAppWhatsApp → HubSpotQué necesita
ZapierDisparador New Contact o Updated Deal Stage, y luego una acción de envío de WbizToolEl disparador Incoming WhatsApp Message de WbizTool, y luego Find Contact y Create Engagement de HubSpotUna cuenta de Zapier. No hay que configurar ningún webhook.
MakeWatch Contacts de HubSpot CRM, y luego el módulo HTTPUn webhook personalizado de Make, y luego solicitudes HTTP a la API de HubSpotUna cuenta de Make. No hay app de WbizTool en Make: el módulo HTTP llama a la API de WbizTool.
n8nHubSpot Trigger, y luego WbizTool Send MessageUn nodo Webhook, y luego el nodo HubSpot y solicitudes HTTP a HubSpotn8n con el nodo de la comunidad de WbizTool. El HubSpot Trigger necesita una cuenta y una app de desarrollador de HubSpot.
Pabbly ConnectUn disparador de HubSpot, y luego API (Pabbly)Webhook by Pabbly, y luego solicitudes de API a HubSpotUna cuenta de Pabbly Connect. Funciona con los pasos HTTP y de webhook de Pabbly.
Flujo de trabajo de HubSpotLa acción Send a webhook llama directamente a la API de WbizToolUsa otra víaData 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:

  1. Disparador: HubSpot, New Contact

    Elige HubSpot y el disparador New Contact (contacto nuevo), y conecta tu cuenta de HubSpot.

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

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

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

  1. Disparador: HubSpot, Updated Deal Stage

    Elige Updated Deal Stage (etapa del negocio actualizada) y elige el pipeline y la etapa, como Closed won.

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

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

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

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

  3. HTTP, Make a request

    Método POST, URL https://wbiztool.com/api/v1/send_msg/. Añade una cabecera Authorization con el valor Bearer YOUR_API_KEY. Tipo de cuerpo application/x-www-form-urlencoded, con estos campos:

    CampoValor
    whatsapp_clientTu WhatsApp Client ID, como 678
    phoneEl Phone number del contacto, del módulo de HubSpot
    country_codeSolo si tus números están guardados sin él, como 1
    msgTu texto, con campos como el nombre asignados
  4. 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": 1 significa 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.

  1. Instala el nodo de WbizTool

    Instala n8n-nodes-wbiztool y crea una credencial WbizTool API. Consulta Integración con n8n.

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

  3. Importa el flujo de trabajo

    En n8n, importa el archivo y elige tus credenciales en cada nodo de HubSpot, HTTP Request y WbizTool.

  4. Define tu etapa y tu mensaje

    En el nodo Deal stage is, sustituye closedwon por 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.

  5. Activa

    Entonces el disparador registra su webhook en HubSpot.

Lo que hace el flujo de trabajo:

  1. HubSpot Trigger con dos eventos: Contact Created, y Deal Property Changed para la propiedad Deal Stage.
  2. Un nodo IF envía los eventos de contactos por un lado y los de negocios por otro.
  3. Para un negocio, comprueba la nueva etapa y luego lee el negocio y sus contactos asociados con un HTTP Request a HubSpot.
  4. HubSpot → Search Contacts lee el nombre y los números de teléfono del contacto.
  5. 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.

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

  2. Añade Send a webhook

    Haz clic en + y, en Data ops, elige Send a webhook. Método POST, URL del webhook https://wbiztool.com/api/v1/send_msg/.

  3. 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), pon Authorization como nombre de la clave API y Request header como ubicación.

  4. Personaliza el cuerpo de la solicitud

    Elige Customize request body y añade:

    ClaveValor
    phonePropiedad: Phone number
    whatsapp_clientValor fijo: tu WhatsApp Client ID, como 678
    msgValor fijo: tu mensaje
    country_codeValor fijo, solo si tus números están guardados sin él
  5. 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 msg es 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 4xx salvo 429, así que un mensaje rechazado, por ejemplo con Invalid 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 clave idempotency_key con 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:

  1. Omite los chats de grupo (contact.is_group es true) y los contactos cuyo número oculta WhatsApp (contact.phone_hidden es true).
  2. Quita tu código de país del principio de contact.phone (consulta Números de teléfono).
  3. Busca contactos de HubSpot cuyo Phone number o Mobile phone number sea igual a ese número.
  4. Si no hay ninguno, crea un contacto con Phone number + y contact.phone, y First name contact.name.
  5. Crea una nota en el contacto con el mensaje: message.content, en message.timestamp.

Con Zapier#

No configuras ninguna URL de webhook: el disparador de WbizTool se conecta a Zapier cuando publicas el Zap.

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

  2. Filter by Zapier

    Continúa solo cuando Contact Phone Hidden sea false e Is Group sea false.

  3. 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 +12125550120 pase a ser 2125550120.

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

  5. HubSpot, Create Engagement

    Tipo Note, asociada al ID del contacto del paso Find Contact. Cuerpo: WhatsApp from Contact Name: Message Content.

Con Make#

  1. Importa la plantilla

    Importa hubspot-whatsapp-to-note.make.json en un escenario nuevo.

  2. 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_KEY en la cabecera Authorization por esa clave.

  3. Crea el webhook

    En el módulo Webhooks → Custom webhook, haz clic en Add, ponle un nombre y copia su dirección.

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

  5. Define tu código de país

    En el módulo Search the contact by phone, la plantilla quita 1 del principio del número (/^1/, dos veces). Sustituye 1 por tu código de país, como 91.

  6. 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#

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

  2. Define tu código de país

    En el nodo National number, pon en countryCode el tuyo, como 91.

  3. Activa y copia la dirección

    Activa el flujo de trabajo y copia la Production URL del nodo WbizTool webhook.

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

PasoSolicitudCuerpo
Buscar el contactoPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups con phone EQ el número sin su código de país, y un segundo grupo con mobilephone; limit 1
Crearlo si faltaPOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties: phone +12125550120, firstname a partir de contact.name
Añadir la notaPOST https://api.hubapi.com/crm/objects/2026-09/notesproperties: 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#

ArchivoHerramientaQué hace
hubspot-new-contact-to-whatsapp.make.jsonMakeContacto nuevo de HubSpot → mensaje de WhatsApp
hubspot-whatsapp-to-note.make.jsonMakeWhatsApp entrante → nota en el contacto (necesita el complemento Unibox)
hubspot-to-whatsapp.n8n.jsonn8nContacto nuevo o etapa del negocio → mensaje de WhatsApp
hubspot-whatsapp-to-note.n8n.jsonn8nWhatsApp 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#

ProblemaQué revisar
Invalid phone numberEl 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 equivocadoEl 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 keyLa 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 clientUsa el ID del número de Números de WhatsApp.
Send a webhook no aparece en las acciones del flujo de trabajoNecesita Data Hub Professional o Enterprise. Usa en su lugar Zapier, Make, n8n o Pabbly Connect.
Make no puede conectarse a HubSpotAntes, un Super Admin de la cuenta de HubSpot tiene que aprobar la app de Make.
No aparece ninguna nota en HubSpotComprueba 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 rechazaTu 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 HubSpotHubSpot 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 vecesWbizTool puede, en raras ocasiones, enviar un mensaje dos veces. Omite un message.id que ya hayas registrado.
Falta la nota de algunos mensajesLos 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.

Relacionado#