Conecta WhatsApp con los contactos de GoHighLevel en un número con Coexistencia

¿Cómo llega un mensaje de WhatsApp a un contacto de HighLevel?

Meta envía cada mensaje del número al destino de webhook que configuraste, aquí un nodo Webhook de n8n. El workflow pasa el número del remitente y su nombre de perfil de WhatsApp al nodo HighLevel de n8n, cuyo recurso de contactos tiene una operación de crear o actualizar. Así, un remitente nuevo se convierte en contacto y uno conocido se encuentra en lugar de duplicarse.

Con el id del contacto en mano, un nodo HTTP Request envía el cuerpo del mensaje a /contacts/{contactId}/notes. La nota aparece en la ficha del contacto, donde cualquiera que la abra ve lo que escribió el cliente. Si el mensaje requiere seguimiento, el nodo HighLevel también puede crear una tarea en el contacto o una oportunidad en un pipeline, y ambas cosas las admite directamente.

El equipo sigue respondiendo desde la app de WhatsApp Business en todo momento.

¿Qué token debe usar el workflow?

Un token de Private Integration. A la API v2 de HighLevel se accede con OAuth o con uno de estos tokens, y las antiguas claves de API v1 llegaron al fin de su vida útil. El token de Private Integration se crea en los ajustes de la subcuenta, con los permisos que marques, y se envía en la cabecera Authorization como cualquier token de acceso.

No se renueva solo, algo que le va bien a una automatización: sigue funcionando hasta que alguien lo rota. Cuando lo rotas, HighLevel mantiene válidos el token antiguo y el nuevo durante siete días, que es el margen para pegar el nuevo en n8n antes de que el antiguo deje de funcionar.

Marca solo los permisos que el workflow necesita: contactos, notas y, si los usas, oportunidades y tareas. Si no encuentras Private Integrations en los ajustes, HighLevel indica que hay que activarlo en Labs.

¿Cómo atiende un workflow a varias subcuentas de clientes?

Enrutando según el número receptor. Todo webhook que envía Meta incluye el phone_number_id del número de empresa que recibió el mensaje. Apunta el número de cada cliente al mismo webhook de n8n, mantén una tabla pequeña que asocie cada phone_number_id con la subcuenta de ese cliente y su token, y busca el token al inicio de cada ejecución.

Así tienes un solo workflow que mantener para todos los clientes, algo que a una agencia le importa más que a nadie. Una corrección en la lógica de coincidencia o en el formato de la nota llega a todos a la vez.

Los límites de tasa se cuentan por app y por subcuenta, así que los clientes no consumen la cuota de los demás: cada uno tiene sus propias 100 peticiones cada diez segundos y 200.000 al día.

¿Llegan a HighLevel las respuestas escritas en el teléfono?

Pueden llegar. En un número con Coexistencia la app de WhatsApp Business sigue en uso, y cuando alguien responde desde ella, Meta envía un eco del mensaje saliente al mismo destino de webhook, en el campo smb_message_echoes.

Añade una rama para esos ecos y escríbelos como notas marcadas como enviadas. La ficha del contacto reúne entonces, en orden, las líneas del cliente y las respuestas de la empresa, que es lo que un cliente espera ver al abrir su CRM.

Cuando el propio workflow envía un mensaje por la Cloud API, por ejemplo una plantilla aprobada tras reservar una cita, escribe la nota en el momento del envío. El workflow ya tiene el texto y el id del contacto.

Errores comunes

• Usar una clave de API v1. La API v1 de HighLevel llegó al fin de su vida útil; la API v2 requiere un token de Private Integration o OAuth.
• Rotar el token de Private Integration sin actualizar n8n dentro del solapamiento de siete días. Todas las llamadas fallan cuando caduca el token antiguo.
• Escribir los mensajes de todos los clientes con el token de una sola subcuenta. Asocia primero phone_number_id con la subcuenta correcta, o los registros acabarán en el cliente equivocado.

Preguntas frecuentes

Sigue leyendo