Integraciones
GoHighLevel y WhatsApp
Conecta GoHighLevel (HighLevel) con WbizTool y tus flujos de trabajo enviarán mensajes de WhatsApp desde tu propio número de WhatsApp. Los mensajes de WhatsApp entrantes también pueden volver a HighLevel, como una nota, una etiqueta o una tarea en el contacto.
Todo lo que hay en esta página usa funciones que ya existen en ambos lados: los webhooks de los flujos de trabajo de HighLevel, y la API de envío de mensajes y los webhooks de mensajes entrantes de WbizTool. No instalas nada.
Quién puede hacerlo: en WbizTool, un Propietario crea la clave API (Claves API), y un Propietario o un Editor configura los webhooks de mensajes entrantes. En HighLevel, los crea alguien que pueda editar flujos de trabajo en la subcuenta. La agencia debe activar las funciones premium de flujos de trabajo de HighLevel (consulta Antes de empezar).
Lo que puedes hacer#
| Dirección | Ejemplo | Cómo |
|---|---|---|
| HighLevel → WhatsApp | Se envía un formulario, se añade una etiqueta o se reserva una cita, y el contacto recibe un mensaje de WhatsApp. | Una acción Custom Webhook en un flujo de trabajo de HighLevel llama a la API de envío de mensajes de WbizTool. |
| WhatsApp → HighLevel | Un cliente escribe a tu número de WhatsApp y el mensaje se añade como nota en su contacto de HighLevel. El contacto se crea si todavía no existe. | Un número de la bandeja de WbizTool envía cada mensaje a un disparador Inbound Webhook de HighLevel. Necesita el complemento Unibox. |
Antes de empezar#
- Un número de WhatsApp conectado en Números de WhatsApp, y su WhatsApp Client ID (el ID que aparece para el número), por ejemplo
678. - Una clave API de WbizTool de Configuración → Claves API. En HighLevel va en una cabecera
Authorization: Bearer, así que no necesitas el Client ID. Consulta Enviar la clave en una cabecera. - Las funciones premium de flujos de trabajo de HighLevel. HighLevel clasifica Custom Webhook e Inbound Webhook como funciones premium de flujos de trabajo. Las agencias de cualquier plan de HighLevel pueden activarlas: en Agency View, ve a Settings → Company y activa Workflow - Premium Features. HighLevel cobra cada ejecución premium, y cada subcuenta recibe 100 ejecuciones premium gratis (una sola vez, no cada mes). La agencia puede volver a facturárselo a la subcuenta. Los precios de HighLevel están en su propia página de ayuda.
- Solo para los mensajes entrantes: el complemento Unibox en un plan de pago o de por vida de WbizTool (no en la prueba gratuita). Cuesta $20 al mes o $200 al año según los precios de lista en EE. UU. por cada número de WhatsApp de la bandeja. Un Propietario lo añade en Facturación y planes (consulta Complementos).
Elige una vía#
La vía de los flujos de trabajo de HighLevel es la más corta: HighLevel llama directamente a WbizTool, sin ninguna otra herramienta de por medio. Usa una herramienta de automatización solo si tus flujos de trabajo ya funcionan allí.
| Vía | Enviar (HighLevel → WhatsApp) | Recibir (WhatsApp → HighLevel) | Planes que necesitas |
|---|---|---|---|
| Flujos de trabajo de HighLevel (recomendada) | Acción Custom Webhook → API de envío de mensajes | Webhook de WbizTool → disparador Inbound Webhook | Funciones premium de flujos de trabajo de HighLevel. Recibir: el complemento Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact o Add Task | Una cuenta de Zapier. Recibir: el complemento Unibox. |
| Make | Acción Webhook de HighLevel → Webhooks de Make → módulo HTTP | Webhook de WbizTool → Webhooks de Make → API de HighLevel | Una cuenta de Make. Recibir: el complemento Unibox. |
| n8n | Acción Webhook de HighLevel → Webhook de n8n → WbizTool Send Message | Webhook de WbizTool → Webhook de n8n → nodo HighLevel | n8n con el nodo de la comunidad de WbizTool. Recibir: el complemento Unibox. |
| Pabbly Connect | Acción Webhook de HighLevel → disparador de webhook de Pabbly → solicitud API (Pabbly) | Webhook de WbizTool → disparador de webhook de Pabbly → tu paso de HighLevel | Una cuenta de Pabbly Connect. Recibir: el complemento Unibox. |
Enviar mensajes de WhatsApp desde un flujo de trabajo de HighLevel#
Abre o crea un flujo de trabajo
En tu subcuenta de HighLevel, abre Automation y crea un flujo de trabajo, o edita uno. Dale el disparador que quieras, como el envío de un formulario, una etiqueta nueva o una cita reservada.
Añade la acción Custom Webhook
Haz clic en + donde deba salir el mensaje y luego en Send Data → Custom Webhook (o busca "webhook" en las acciones y elige Custom Webhook). La acción Webhook simple no puede definir la cabecera ni el cuerpo que necesita esta API.
Configura la solicitud
Pon Event en CUSTOM y Method en POST. Pon en URL
https://wbiztool.com/api/v1/send_msg/. En Authorization, elige Bearer Token y pega tu clave API de WbizTool, o elige sin autenticación y añade la cabeceraAuthorizationcon el valorBearer YOUR_API_KEY. Pon Content-Type enapplication/json.Pega el cuerpo
Pega uno de los bloques para copiar y pegar en Raw Body y sustituye
678por tu WhatsApp Client ID. Usa el icono de etiqueta de HighLevel para añadir más campos del contacto al mensaje.Prueba y publica
Guarda la acción y publica el flujo de trabajo. Ejecútalo con un contacto de prueba que tenga tu propio número de teléfono. Cada ejecución aparece en los registros de ejecución del flujo de trabajo. Cuando WbizTool acepta el mensaje, responde
"status": 1. Después, el mensaje sale desde tu número de WhatsApp.
El campo del número de teléfono#
Usa {{contact.phone_raw}}, no {{contact.phone}}. El {{contact.phone}} de HighLevel tiene un formato pensado para leerlo, como (515) 555-2345, sin el código de país. {{contact.phone_raw}} es el mismo número en formato internacional, como +15155552345.
WbizTool quita por ti el +, los espacios, los guiones y los paréntesis. Un número escrito con + ya incluye su código de país, así que no necesitas enviar country_code. Si algunos de tus contactos se guardaron sin código de país, añade "country_code": "1" (el prefijo de tu país) al cuerpo. Solo se añade a los números escritos sin +. Consulta Enviar mensaje → phone.
Bloques para copiar y pegar#
URL: https://wbiztool.com/api/v1/send_msg/ · Método: POST · Cabeceras: Authorization: Bearer YOUR_API_KEY y Content-Type: application/json
{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}{
"whatsapp_client": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}whatsapp_client: el ID del número desde el que se envía. Solo puedes omitirlo cuando tu espacio de trabajo tiene exactamente un número conectado.msg: hasta 3.000 caracteres. El formato de WhatsApp funciona:*bold*,_italic_. Para una línea nueva, escribe\ndentro del texto. Un salto de línea real hace que el JSON no sea válido.- Imágenes y archivos: los enlaces deben ser públicos.
msgpasa a ser el pie de foto. Consulta Enviar imágenes y archivos. expire_after_seconds: si el mensaje no ha salido en este tiempo, por ejemplo porque el número se desconectó, se marca como expirado y no se envía.- Grupos:
group_namees el nombre exacto de un grupo de WhatsApp en el que está tu número. Envíagroup_nameophone, nunca los dos. Consulta Enviar a un grupo.
Registrar los mensajes de WhatsApp entrantes en HighLevel#
Esta dirección necesita el complemento Unibox. Cada mensaje que recibe tu número de WhatsApp se envía al disparador Inbound Webhook de HighLevel. Después, el flujo de trabajo busca o crea el contacto y añade el mensaje como nota, etiqueta o tarea. Los mensajes no aparecen en ninguna otra parte de HighLevel.
Crea un flujo de trabajo con un disparador Inbound Webhook
En HighLevel, crea un flujo de trabajo y elige el disparador Inbound Webhook. Copia la URL del webhook que muestra.
Apunta tu número de WhatsApp a ella
En WbizTool, abre Números de la bandeja. Haz clic en Añadir número a la bandeja, elige el número y pega la URL de HighLevel en URL del webhook (opcional). Para un número que ya está en la bandeja, pégala en la Configuración del webhook del número. En Mensajes que se envían, marca solo Mensajes recibidos. Cada envío es una ejecución premium en HighLevel, así que deja Mensajes enviados sin marcar salvo que los necesites.
Envía un mensaje de prueba
Desde otro teléfono, envía un mensaje a tu número de WhatsApp. Se envía tras la siguiente comprobación, normalmente en uno o dos minutos. En HighLevel, haz clic en Test Trigger, elige la solicitud en Mapping Reference y guarda el disparador. Los campos se describen en Contenido.
Omite los grupos y los números ocultos
Añade un paso If/Else que continúe solo cuando
eventseamessage_received,contact.is_groupseafalseycontact.phoneno esté vacío. WhatsApp a veces oculta el número del remitente, y los mensajes de grupo llevan el ID del grupo en lugar de un número de teléfono.Busca o crea el contacto
En la acción Create/Update Contact, pon en Phone un
+seguido de contact → phone de los valores del Inbound Webhook. WbizTool envía el número sin+, y el+le indica a HighLevel que incluye el código de país. También puedes asignar contact → name. Es el nombre de WhatsApp del remitente, y puede sustituir un nombre que hayas editado en HighLevel.Añade el mensaje al contacto
Añade una acción Add to Notes. Escribe una nota como "Mensaje de WhatsApp:" y elige message → content y message → timestamp de los valores del Inbound Webhook. También puedes añadir Add Contact Tag (por ejemplo
whatsapp), una tarea o una notificación interna para tu equipo.Publica
Publica el flujo de trabajo y envía otro mensaje de prueba.
| Valor del Inbound Webhook | Úsalo para |
|---|---|
contact.phone | El teléfono del contacto. Añade + delante. |
contact.name | El nombre de WhatsApp del remitente. Puede estar vacío. |
message.content | El texto. Para fotos, notas de voz y archivos es una etiqueta como 📸 Image, y los pies de foto no se incluyen. |
message.timestamp | Cuándo se envió el mensaje en WhatsApp (ISO 8601, UTC). |
message.media.url | Un enlace de descarga de una foto o un archivo. Caduca a los 3½ a 7 días, así que no dependas de él en una nota. |
whatsapp_phone | Cuál de tus números lo recibió, si varios números envían al mismo flujo de trabajo. |
event | message_received o message_sent. |
- Solo los mensajes nuevos se envían, desde el momento en que se configura el webhook. Los chats anteriores no se importan.
- Un webhook por número. Cada número de la bandeja envía a una sola URL. Si un Zap de Zapier usa el disparador Incoming WhatsApp Message para el mismo número, el Zap se queda con el webhook mientras está activado.
- Responder desde HighLevel: para responder por WhatsApp desde el mismo flujo de trabajo, añade la acción Custom Webhook con
"phone": "{{contact.phone_raw}}". - Mantén la URL en privado. El Inbound Webhook de HighLevel no comprueba la firma de WbizTool, así que cualquiera que tenga la URL puede enviarle datos. Si se filtra, crea un disparador nuevo y pega su URL en WbizTool.
Zapier#
La app de HighLevel en Zapier se llama LeadConnector. Tiene un disparador, Pipeline Stage Changed (cambió la etapa del pipeline). Entre sus acciones están Add/Update Contact y Add Task. Consulta Integración con Zapier para conectar WbizTool.
- Enviar: disparador LeadConnector Pipeline Stage Changed, luego un paso Filter by Zapier para la etapa que quieras y luego WbizTool Send Text-Only WhatsApp Message. Elige el número en WhatsApp Number, asigna el teléfono del contacto a Phone Number y escribe el Message. Para otros eventos de HighLevel, usa en su lugar la acción Custom Webhook.
- Recibir: disparador WbizTool Incoming WhatsApp Message (necesita el complemento Unibox), luego un paso Filter by Zapier que continúe solo cuando Contact Phone Hidden e Is Group sean false. Después LeadConnector Add/Update Contact con el teléfono puesto en
+y Contact Phone, y luego LeadConnector Add Task con Message Content.
Make#
La app de HighLevel en Make se llama GoHighLevel. Estas plantillas solo usan los módulos genéricos Webhooks, JSON y HTTP de Make, así que no necesitas una conexión de GoHighLevel en Make. En su lugar, la plantilla de recepción necesita un token de Private Integration de HighLevel y tu ID de ubicación (location ID) (consulta más abajo).
Importa el blueprint
Descarga una de las plantillas de abajo. En Make, crea un escenario, abre el menú … y elige Import blueprint.
Crea el webhook
Abre el módulo Webhooks, haz clic en Add para crear un webhook y copia su dirección.
Rellena los marcadores de posición
Sustituye cada marcador en mayúsculas de los módulos HTTP, como
YOUR_WBIZTOOL_API_KEYyYOUR_WHATSAPP_CLIENT_ID.Conecta el webhook
Enviar: en HighLevel, añade una acción Webhook a tu flujo de trabajo con la dirección de Make como URL. En Custom Data, añade la clave
phone_rawcon el valor{{contact.phone_raw}}. Recibir: pega la dirección de Make como URL del webhook del número en Números de la bandeja, con solo Mensajes recibidos marcado.Ejecútalo una vez
Haz clic en Run once en Make y lanza el flujo de trabajo, o envía un mensaje de WhatsApp a tu número.
La plantilla de recepción escribe en HighLevel a través de su API con un token de Private Integration de la configuración de tu subcuenta, con el permiso contacts.write, y el ID de ubicación de tu subcuenta. En su lugar puedes usar los módulos Create a Contact y Add a Note to the Contact de la app GoHighLevel.
n8n#
n8n tiene un nodo HighLevel integrado. Su operación Contact → Create or Update busca un contacto por teléfono o correo electrónico, o lo crea, y puede añadir una Note. Primero instala el nodo de la comunidad de WbizTool: consulta Integración con n8n.
Importa el flujo de trabajo
Descarga una de las plantillas de abajo. En n8n, crea un flujo de trabajo e importa el archivo (menú … → Import from File, o pega el JSON en el lienzo).
Añade tus credenciales
Abre el nodo WbizTool Send Message y elige o crea una credencial WbizTool API. En el flujo de recepción, abre el nodo HighLevel y elige o crea una credencial de HighLevel.
Conecta el webhook
Copia la URL de producción del nodo Webhook. Enviar: úsala como URL de una acción Webhook de HighLevel, con la clave de Custom Data
phone_rawpuesta en{{contact.phone_raw}}. Recibir: pégala como URL del webhook del número en Números de la bandeja, con solo Mensajes recibidos marcado.Activa
Activa el flujo de trabajo y haz una prueba.
Pabbly Connect#
Usa el disparador de webhook propio de Pabbly Connect y su acción API (Pabbly), configurada como en Enviar mensajes de WhatsApp desde cualquier herramienta de automatización. Para la dirección de envío, apunta una acción Webhook de HighLevel a la URL del webhook de Pabbly y asigna phone_raw a phone. Para los mensajes entrantes, pega la URL del webhook de Pabbly como URL del webhook del número en Números de la bandeja.
Plantillas#
| Archivo | Qué hace |
|---|---|
| ghl-blocks.md | Los bloques para copiar y pegar de esta página, en un solo archivo. |
| gohighlevel-to-whatsapp.make.json | Make: webhook de HighLevel → mensaje de WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: mensaje de WhatsApp entrante → contacto y nota en HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: webhook de HighLevel → mensaje de WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: mensaje de WhatsApp entrante → contacto de HighLevel con una nota. |
Las plantillas no contienen claves. Después de importarlas, añade las tuyas en los marcadores de posición o en las credenciales.
Solución de problemas#
| Problema | Qué hacer |
|---|---|
El mensaje va a un número equivocado, o Invalid phone number | Usa {{contact.phone_raw}}, no {{contact.phone}}. Si el número del contacto no tiene código de país en HighLevel, añade country_code al cuerpo o corrige el contacto. |
Either phone or group_name parameter is required | El contacto no tiene número de teléfono. Añade un paso If/Else antes de la acción. |
Auth Error: invalid api key | Revisa la cabecera Authorization: Bearer, un espacio y luego la clave, sin comillas. Puede que la clave se haya eliminado. Consulta Claves API. |
Invalid whatsapp client o Invalid whatsapp client id. | Usa el WhatsApp Client ID de Números de WhatsApp. Es obligatorio cuando tienes más de un número. |
Invalid JSON format: … | El cuerpo no es un JSON válido: falta una coma, sobra una coma al final, hay un salto de línea real en msg o un valor insertado contiene comillas dobles. |
"status": 1, pero no llega nada | El mensaje queda en cola hasta que tu número de WhatsApp esté conectado. Revisa Números de WhatsApp y Estado del mensaje. |
| Falta la acción Custom Webhook o Inbound Webhook | La agencia no ha activado las funciones premium de flujos de trabajo (Workflow - Premium Features), o la subcuenta ya usó sus ejecuciones gratis y no se le vuelven a facturar. Pregunta a tu agencia. |
| No llega ningún mensaje entrante a HighLevel | El número debe mostrar Sincronizando en Números de la bandeja, con la URL correcta y Mensajes recibidos marcado. El receptor debe responder 2xx en 8 segundos. Las solicitudes llegan con el User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), por si un firewall filtra por él. Más información en Webhooks de mensajes entrantes. |
| Se requiere el complemento Unibox | Los mensajes entrantes necesitan el complemento Unibox en un plan de pago o de por vida. Consulta Planes y facturación. |
| Se crea un contacto nuevo con cada mensaje | Asigna Phone con el + delante, para que HighLevel encuentre el contacto existente. |
| Los chats de grupo crean contactos extraños | Omite los mensajes en los que contact.is_group sea true con un paso If/Else. |
| Los mensajes entrantes dejaron de llegar después de activar un Zap | Un Zap con el disparador Incoming WhatsApp Message de WbizTool se queda con el webhook del número mientras está activado. Desactiva el Zap o usa otro número. |
Relacionado#
- API de envío de mensajes: todos los campos y errores
- Webhooks de mensajes entrantes: números de la bandeja, entrega, contenido
- Claves API y Client ID
- Integración con Zapier
- Integración con n8n
- Enviar desde cualquier herramienta de automatización: Make, Pabbly Connect y otras

