Envío de mensajes proactivos en disparos de webhook vía hubspot

Utilizando nuestro endpoint de envíos proactivos, es posible iniciar conversaciones por WhatsApp através de webhooks integrados a Hubspot. Estos webhooks pueden alimentarse con la base de datos de información de Hubspot, haciendo que el mensaje sea dinámico en contexto.

📌 ¿Cuándo usar esta integración?

Utiliza este flujo cuando desees:

Enviar automáticamente un mensaje por WhatsApp (utilizando una plantilla aprobada por Meta) desde Cloud Chat tras una acción en HubSpot
Personalizar el mensaje con propiedades del contacto en HubSpot (nombre, número de pedido, estado, entre otros)
Crear flujos automáticos de seguimiento, cobranza, incorporación o actualización de estado

✅ Requisitos previos

Antes de configurar el endpoint, necesitas:

Tener el número de WhatsApp conectado a Cloud Chat y poseer el inbox_id de la bandeja de entrada correspondiente. Consulta la FAQ: Guía maestra — Cómo conectar tu número de WhatsApp a Cloud Chat

El inbox_id se puede encontrar accediendo a la configuración de la bandeja de entrada en Cloud Chat. La URL seguirá el siguiente patrón: https://cloudchat.cloudhumans.com/app/accounts/{{account_id}}/settings/inboxes/{{inbox_id}}
Tener una plantilla aprobada en Meta registrada en Cloud Chat. Accede a la FAQ: Cómo crear plantillas de WhatsApp en Cloud Chat (creación, edición y aprobación).
Tener tu API Key de Cloud Chat a mano. Accede a la FAQ siguiente para obtener la clave y el token: API: Enviar mensaje proactivo por WhatsApp.

Paso 1: Crear el Workflow en HubSpot

Para crear un webhook de disparo proactivo en un workflow de Hubspot, sigue los siguientes pasos.

En la barra lateral principal de Hubspot, pasa el mouse sobre el símbolo de automatizaciones y luego haz clic en Flujos de trabajo para ser redirigido al panel de control de workflows:

Al entrar al panel, haz clic en Crear flujo de trabajo y luego selecciona la opción Desde cero:

Elige las opciones que dispararán este trigger:

Paso 2: Configurar el envío del Webhook

Con la configuración inicial del workflow completada, ahora debemos construir el payload que se enviará en el webhook.

Para iniciar la configuración del webhook, haz clic en el botón de añadir acción (+):

En el panel izquierdo, haz clic en Operaciones de datos y luego selecciona Enviar un webhook:

En el selector de método, elige la opción POST:

Luego, completa la información de url del webhook y la clave API:

URL: https://{CLOUDCHAT_DOMAIN}/api/v1/accounts/{ACCOUNT_ID}/conversations/create_proactive_whatsapp_conversation

Para configurar la Clave API, haz clic en Añadir secreto. Luego, aparecerá una ventana solicitando el Nombre del secreto y el Valor del secreto.

Ingresa en Nombre del Secreto api_access_token y en el campo Valor del Secreto, la API Key de Cloud Chat que guardaste previamente.

Estructura del Payload

Por último, completa el body (payload) de la solicitud para realizar el disparo, incluyendo:

template_name (requerido) — valor estático que corresponde exactamente al nombre de la plantilla aprobada en Cloud Chat.
inbox_id (requerido) — valor estático que identifica la bandeja de entrada de envío en Cloud Chat.
phone_number (requerido) — campo dinámico usando la variable de HubSpot {{contact.phone}}.
Variables de la plantilla — Al registrar la plantilla en Cloud Chat, las variables configuradas en ella deben tener exactamente el mismo nombre que las propiedades enviadas por HubSpot en el payload.

Esto significa que el nombre de la variable en la plantilla debe ser idéntico al nombre del campo enviado en el webhook (respetando mayúsculas/minúsculas y guiones bajos), para que la sustitución de valores sea correcta en el momento del disparo.

Aquí tienes un ejemplo de payload: