Your AI Connector Docs

Integración con GoHighLevel (GHL)

¿Ya utiliza GoHighLevel (GHL) para gestionar su negocio? Esta integración le permite añadir la mensajería con IA de Your AI Connector a su configuración actual de GHL. Los mensajes que llegan a GHL se reenvían a Your AI Connector para su gestión mediante IA, y las respuestas de Your AI Connector se envían de vuelta a través de GHL al cliente por el canal original.

¿Utiliza un CRM diferente? No necesita una pantalla dedicada para funcionar con Your AI Connector: consulte Conexión de una herramienta que no enumeramos para ver funciones personalizadas, la API y los webhooks.

Esto significa que puede seguir utilizando GHL como su centro principal mientras permite que la IA gestione las conversaciones impulsadas por inteligencia artificial.

Nota: Esta es una integración más técnica que implica configurar flujos de trabajo automatizados y conectar sistemas mediante webhooks (notificaciones automáticas entre aplicaciones) y llamadas a la API. Si no se siente cómodo con esto, es posible que desee entregar esta página a un desarrollador o a un miembro del equipo con conocimientos técnicos.


Requisitos previos

  • Una cuenta de Your AI Connector activa con su clave API (que encontrará en Settings → Integrations → API Key). Una clave API es un código único que permite a GHL comunicarse de forma segura con su cuenta.
  • Una cuenta de GoHighLevel con permisos para crear flujos de trabajo y gestionar webhooks (notificaciones automatizadas entre sistemas).

Cómo funciona

Dirección Qué sucede
GHL a Your AI Connector Un cliente le envía un mensaje por SMS, correo electrónico, Messenger, Instagram o chat en vivo en GHL. Un flujo de trabajo reenvía automáticamente ese mensaje a Your AI Connector. Your AI Connector lo procesa (respuesta de IA, etiquetado, etc.).
Your AI Connector a GHL Cuando Your AI Connector envía una respuesta (manualmente o mediante IA), notifica automáticamente a GHL. Un flujo de trabajo en GHL localiza al contacto y envía la respuesta a través del canal correcto.

Flujo de trabajo 1: GHL a Your AI Connector

Este flujo de trabajo reenvía los mensajes entrantes de GHL a Your AI Connector.

Paso 1: Crear el flujo de trabajo

  1. En GHL, vaya a Automation > Workflows.
  2. Haga clic en Create New Workflow.
  3. Asígnele un nombre descriptivo, como “Enviar mensaje a Your AI Connector”.

Paso 2: Añadir activadores

Añada un activador para cada canal que desee reenviar:

  • El cliente respondió - SMS
  • El cliente respondió - Correo electrónico
  • El cliente respondió - Mensaje de Facebook
  • El cliente respondió - DM de Instagram
  • El cliente respondió - Chat en vivo

Puede añadirlos todos o solo los canales relevantes para su configuración.

Paso 3: Añadir filtro de etiquetas (opcional)

Si solo desea reenviar mensajes de contactos específicos:

  1. Haga clic en Add Filter (Añadir filtro) en el activador.
  2. Establezca la condición en “Contact has tag” (El contacto tiene la etiqueta).
  3. Elija su(s) etiqueta(s).
  4. Seleccione si el contacto debe tener any (alguna) o all (todas) las etiquetas seleccionadas.

Paso 4: Crear una división de canal

Añada una acción de Condition (Condición) para dirigir cada canal a su propio webhook:

Rama Condición
Rama 1 El origen del mensaje es igual a Email
Rama 2 El origen del mensaje es igual a SMS
Rama 3 El origen del mensaje es igual a Messenger
Rama 4 El origen del mensaje es igual a Instagram
Rama 5 El origen del mensaje es igual a Live Chat

Paso 5: Configurar webhooks

Para cada rama, añada una acción de Webhook / HTTP Request (Webhook / Solicitud HTTP):

  • Method: POST

  • URL:

    https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
    
  • Custom Data fields: (Campos de datos personalizados):

Campo Valor Notas
messageSid {{right_now.second}}{{contact.id}} Identificador único de mensaje
fromId {{contact.id}} ID de contacto de GHL
toId {{user.id}} Su ID de usuario de GHL
body {{message.body}} El contenido del mensaje
channel Ver tabla a continuación Debe coincidir con la rama
status created Establecer siempre en created
messageType text Tipo de mensaje

Valores de canal por rama:

Rama Valor de channel
Email email
SMS sms
Messenger messenger
Instagram ig
Live Chat livechat

Importante: Asegúrese de que el valor channel coincida exactamente; estos distinguen entre mayúsculas y minúsculas.

Paso 6: Habilitar reingreso

En la configuración del flujo de trabajo, asegúrese de que Allow Re-entry (Permitir reingreso) esté habilitado. Sin esto, solo se reenviará el primer mensaje de cada contacto.


Flujo de trabajo 2: Your AI Connector a GHL

Este flujo de trabajo recibe las respuestas de Your AI Connector y las envía al cliente a través del canal de GHL correcto.

Paso 1: Crear un webhook entrante en GHL

  1. En GHL, vaya a Settings > Developers / API.
  2. Haga clic en Create New Webhook (o “Inbound Webhook”).
  3. Asígnele el nombre “Messages”.
  4. Guarde y copie la URL del webhook; la necesitará en el siguiente paso.

Paso 2: Configurar Your AI Connector

  1. En Your AI Connector, haz clic en Settings en la barra lateral.
  2. En Channels, haz clic en Channels.
  3. Desplázate hasta la tarjeta Custom channel en la parte inferior de la página.
  4. Pega la URL del webhook de entrada de GHL que acabas de copiar en Webhook URL (debe ser una dirección HTTPS pública) y haz clic en Save.

Esta no es la página Settings → Integrations → Webhooks. Esa página es para notificaciones de eventos y envía una carga útil diferente. El relé de salida de GHL se configura en la tarjeta Custom channel en Settings → Channels.

Your AI Connector enviará ahora automáticamente una notificación a GHL cada vez que se envíe un mensaje a un contacto. Los datos enviados tienen este aspecto:

{
  "contactId": "NtL97bwnhITrfIq8lWFi",
  "messageId": "s28dtg13qNuhXLoKpcLs",
  "userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
  "body": "Message content here",
  "toId": "qtpBsc6fiqkXTnSOeze3",
  "channel": "email"
}

Nota de navegación: la clave API que utilizas para el flujo de trabajo 1 y la tarjeta de canal personalizado que utilizas aquí se encuentran en lugares diferentes: Settings → Integrations → API Key para la clave, y la tarjeta Custom channel en la parte inferior de Settings → Channels para este relé. La página independiente Settings → Integrations → Webhooks es para notificaciones de eventos y envía una carga útil diferente; consulta Webhooks si eso es lo que buscas en su lugar.

Paso 3: Crear el flujo de trabajo de respuesta

  1. En GHL, ve a Automation > Workflows.
  2. Crea un nuevo flujo de trabajo llamado “Send Message to Contact”.
  3. Establece el activador (trigger) en Inbound Webhook y selecciona el webhook que creaste en el Paso 1.

Paso 4: Agregar una acción de búsqueda de contacto

  1. Agrega una acción Find Contact.
  2. Establece el campo de búsqueda en Contact ID.
  3. Usa el valor: {{inboundWebhookRequest.toId}}

Paso 5: Agregar una verificación de etiqueta opcional

Si desea limitar qué contactos reciben mensajes de Your AI Connector:

  1. Agrega una acción Condition.
  2. Verifica si el contacto tiene una etiqueta específica.
  3. Si falta la etiqueta, finaliza el flujo de trabajo (agrega una acción “Stop” en la rama falsa).

Paso 6: Agregar una división de canal

Añada una acción de Condición que dirija el mensaje según {{inboundWebhookRequest.channel}}:

Rama Condición Acción
Rama 1 igual a email Enviar correo electrónico
Rama 2 igual a sms Enviar SMS
Rama 3 igual a messenger Enviar mensaje de Facebook
Rama 4 igual a ig Enviar mensaje de Instagram
Rama 5 igual a livechat Enviar mensaje de chat

Paso 7: Configurar cada acción de envío

En cada acción de envío, establezca el cuerpo del mensaje en:

{{inboundWebhookRequest.body}}

Paso 8: Habilitar reingreso

Al igual que con el Flujo de trabajo 1, asegúrese de que Permitir reingreso esté habilitado en la configuración del flujo de trabajo.


Prueba de la integración

Probar GHL a Your AI Connector (Flujo de trabajo 1)

  1. Envíe un mensaje a su número de GHL o canal conectado (por ejemplo, envíese un SMS a usted mismo).
  2. Abra Your AI Connector y verifique que el mensaje aparece en Chats.
  3. Compruebe que la etiqueta del canal sea correcta (SMS, correo electrónico, etc.).
  4. Repita el proceso para cada canal que haya configurado.

Probar Your AI Connector a GHL (Flujo de trabajo 2)

  1. En Your AI Connector, envía una respuesta a un contacto (manualmente o deja que la IA responda).
  2. Abre GHL y verifica que el contacto haya recibido el mensaje.
  3. Confirma que se envió a través del canal correcto.
  4. Comprueba que el contenido del mensaje coincida.

Solución de problemas

Problema Qué comprobar
Los mensajes no llegan a Your AI Connector Verifica que tu clave API sea correcta en la URL del webhook. Comprueba que los activadores del flujo de trabajo se estén ejecutando (registros de flujo de trabajo de GHL). Confirma que la opción “Allow Re-entry” esté habilitada.
Los mensajes no llegan a GHL Verifica que la URL del webhook de entrada de GHL esté pegada correctamente en Webhook URL en la tarjeta Custom channel en la parte inferior de Settings → Channels (no en la página Settings → Integrations → Webhooks, que es una función diferente). Comprueba que el webhook de entrada de GHL esté activo. Revisa los registros de ejecución del flujo de trabajo de GHL.
Contacto no encontrado en GHL El toId en los datos del webhook debe coincidir con un ID de contacto de GHL existente. Asegúrate de que los contactos existan en ambos sistemas con IDs coincidentes.
Se utilizó el canal incorrecto para la respuesta Comprueba dos veces los valores del canal en tus ramas de condición. Deben coincidir exactamente: email, sms, messenger, ig, livechat.
Solo se reenvía el primer mensaje Habilita Allow Re-entry en ambos ajustes del flujo de trabajo.

Próximos pasos

  • Webhooks — configura webhooks para otros eventos de Your AI Connector.
  • Acceso a la API — utiliza la API para integraciones personalizadas más allá de GHL.
  • Canales personalizados — obtén más información sobre la mensajería en canales personalizados.