Integración con CRM
Integra WhatsApp con HubSpot
HubSpot es una plataforma de CRM y automatización de marketing que centraliza contactos, negocios y todo el historial de la relación en un solo lugar. Su módulo de Workflows permite crear automatizaciones visuales que reaccionan a eventos del embudo: cuando un contacto entra en cierta etapa del ciclo de vida, cuando un negocio avanza un paso o cuando una propiedad cambia de valor. Es donde los equipos de marketing y ventas orquestan la nutrición de leads, los seguimientos y los traspasos sin escribir código.
Por qué conectar
HubSpot es excelente para organizar el embudo, pero el email tiene baja tasa de apertura y respuestas lentas. Conectar ZapZap API lleva WhatsApp a los Workflows: en cuanto un lead entra en la etapa "Lead calificado" o un negocio pasa a "Reunión agendada", HubSpot envía automáticamente un mensaje al WhatsApp del contacto. Dejas de depender de que el vendedor se acuerde de mandar el "hola" y empiezas a disparar la conversación en el canal donde la respuesta llega en minutos. Como ZapZap usa instancias gestionadas con calentamiento comunitario y antibaneo, el volumen de envío automatizado sale con menor riesgo de que el número sea restringido.
Paso a paso
- 1
Activa un número en ZapZap API
Crea la instancia en el panel de ZapZap, conecta WhatsApp leyendo el QR y copia la x-api-key y el x-api-secret de esa instancia. HubSpot los usará para autenticar cada envío. El número cuesta R$15 al mes, prepago, con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.
- 2
Crea el Workflow en HubSpot
En el menú superior ve a Automatizaciones > Workflows y haz clic en Crear workflow > Desde cero. Elige el tipo basado en Contactos (para disparadores de contacto) o basado en Negocios (para disparadores de negocio), según el evento que deba activar el WhatsApp.
- 3
Define el disparador de inscripción
En Set enrollment triggers, elige la condición del evento. Ejemplos reales: 'Lifecycle stage is any of Lead', 'Deal stage is Meeting scheduled' o 'Contact property [Phone] is known'. Asegúrate de que el contacto tenga un móvil rellenado en una propiedad, ya que va en el cuerpo de la solicitud.
- 4
Añade la acción Send a webhook
Haz clic en el + para añadir una acción y selecciona Send a webhook. Define el Method como POST y la URL de destino. Como ZapZap exige los headers x-api-key y x-api-secret, apunta a un endpoint intermedio tuyo (un relay de webhook, un Worker o un escenario de Make) que reciba el payload de HubSpot, adjunte los dos headers y reenvíe a https://api.zapzapapi.com. Usa los tokens de propiedades de HubSpot (p. ej. contact.phone) para inyectar el número en el cuerpo.
- 5
Prueba y publica
Usa Review and publish, luego inscribe un contacto de prueba que cumpla el disparador y comprueba que el mensaje llegó a WhatsApp. Sigue cada ejecución en la pestaña Enrollment history del propio Workflow para validar el estado y reprocesar fallos. Las rutas y los campos exactos de ZapZap están en la documentación en https://api.zapzapapi.com/llms.txt.
Ejemplo
// Ejemplo ILUSTRATIVO del envío que tu relay hace a ZapZap API.
// La ruta y los nombres exactos de los campos están en https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
x-api-key: TU_API_KEY
x-api-secret: TU_API_SECRET
Content-Type: application/json
Body:
{
"number": "5511999999999",
"text": "Hola {{contact.firstname}}, vi que avanzaste por aquí. ¿Puedo ayudarte?"
}Ilustrativo. Los campos y endpoints exactos están en la documentación.
Preguntas frecuentes
¿Necesito la API oficial de WhatsApp (Cloud API) para integrar con HubSpot?
No. ZapZap API funciona con instancias de WhatsApp no oficiales y gestionadas, por lo que no necesitas aprobar plantillas con Meta ni pasar por la verificación del negocio. Solo conecta un número leyendo el QR y usa los headers x-api-key y x-api-secret en las solicitudes que dispara HubSpot.
¿La acción Send a webhook de HubSpot permite añadir headers de autenticación?
La acción nativa Send a webhook envía el payload del registro, pero no todos los planes permiten headers personalizados directamente. El camino recomendado es apuntar el webhook a un endpoint intermedio tuyo (un relay simple, un Cloudflare Worker o un escenario de Make) que reciba los datos de HubSpot, añada x-api-key y x-api-secret y reenvíe a ZapZap API.
¿Puedo usar datos del contacto o del negocio dentro del mensaje?
Sí. Dentro del Workflow usas los tokens de personalización de HubSpot, como el nombre, la empresa o la etapa del negocio, e inyectas esos valores en el cuerpo de la solicitud. El mensaje llega personalizado para cada contacto inscrito en el Workflow.
¿El envío masivo por HubSpot puede hacer que baneen mi número?
Un alto volumen de automatización siempre conlleva riesgo. ZapZap trabaja con calentamiento comunitario del número y recursos antibaneo para reducir el riesgo de restricción. Aun así, usa intervalos entre mensajes, envía contenido relevante y evita disparar de una vez a listas frías grandes.
¿Cómo recibo de vuelta en HubSpot la respuesta del contacto?
ZapZap API envía webhooks por evento cuando llega un mensaje. Defines esa URL de callback con un endpoint tuyo que actualiza el contacto o crea una nota mediante la API de HubSpot. Así la conversación de WhatsApp queda registrada en el CRM. Los eventos disponibles están documentados en https://api.zapzapapi.com/llms.txt.
Empieza ahora
Crea tu cuenta, conecta un número en minutos y prueba la API con calentamiento y anti-bloqueo. R$15 por número activo/mes, prepago, sin permanencia.