Proveedores de conversacion (Conversation Providers)

Proveedores de conversacion

La plataforma permite configurar proveedores de conversacion personalizados dentro de una app del Marketplace, para crear tus propios canales de SMS, correo y llamadas — por ejemplo, si tu institucion ya usa un proveedor de telefonia o correo propio y quiere que las conversaciones con aspirantes se registren igual dentro del mismo sistema.

Configurar proveedores personalizados

Crear una aplicación del Marketplace

Primero necesitas crear una aplicación del Marketplace:

1. Ve a https://marketplace.gohighlevel.com
2. Entra a la sección de Auth
3. Agrega tus scopes (ver notas abajo)
4. Agrega el redirect y las llaves de cliente, y da clic en guardar

Scopes

Estos son los distintos scopes necesarios para usar proveedores de conversacion personalizados. Revisa la documentación completa de scopes aquí: https://marketplace.gohighlevel.com/docs/oauth/Scopes

APIs de mensajeria requeridas:

conversations/message.write Proposito: eventos de webhook de mensajes salientes del proveedor de conversacion, agregar mensajes entrantes, agregar registros de llamadas salientes externas, subir adjuntos a conversaciones, actualizar el estado de los mensajes.

conversations.readonly Proposito: consultar las APIs de conversaciones.

conversations.write Proposito: crear, actualizar o eliminar una conversacion. Se mantiene un solo conversationId por contacto.

contacts.readonly / contacts.write Proposito: crear o actualizar contactos.

APIs de mensajeria opcionales: conversations/message.readonly Grabaciones/transcripciones y el evento de webhook de mensaje saliente.

Configuración del proveedor de conversacion

Al crear tu proveedor obtendras un "Id", que corresponde al conversationProviderId.

Proveedor de SMS (predeterminado)

Descripcion: habilita un proveedor de SMS para reemplazar al proveedor predeterminado (twilio/LC-Phone).

1. Ingresa un nombre
2. Tipo: SMS
3. URL de entrega — envia eventos de webhook al Conversation Provider Outbound Webhook

Nota: no marques la casilla "Is this a Custom Conversation Provider".

API para agregar mensaje entrante: usa el tipo "SMS". El conversationProviderId no es requerido. https://marketplace.gohighlevel.com/docs/ghl/conversations/add-an-inbound-message

Activar el proveedor: ve a Configuración de la sub-cuenta > Números telefonicos > Configuración avanzada > Proveedor de SMS. Selecciona tu proveedor y guarda.

Flujos de trabajo: soporta los módulos estandar de SMS.

Acciones masivas: soportadas.

Proveedor de SMS (adicional)

Descripcion: agrega un proveedor de SMS personalizado adicional (no reemplaza al predeterminado).

1. Ingresa un nombre
2. Tipo: SMS
3. URL de entrega — envia eventos de webhook al Conversation Provider Outbound Webhook
4. Marca la casilla "Is this a Custom Conversation Provider"
5. Pestaña de conversaciones (opcional) — marca "Always show this Conversation Provider" si quieres una pestaña visible en la ventana de conversaciones para responder desde ese proveedor
6. Alias (opcional) — cambia el nombre del proveedor en la pestaña de conversaciones
7. Logo (opcional)

API para agregar mensaje entrante: usa el tipo "SMS". El conversationProviderId si es requerido. https://marketplace.gohighlevel.com/docs/ghl/conversations/add-an-inbound-message

Activar el proveedor: se activa automáticamente al instalarse. Revisa Configuración > Proveedores de conversacion para ver los proveedores instalados.

Flujos de trabajo: puedes construir acciones premium de flujo de trabajo en tu app; el módulo de SMS estandar no esta soportado actualmente.

Proveedor de correo (predeterminado)

Descripcion: habilita un proveedor de correo para reemplazar al predeterminado (mailgun/LC-Email).

1. Ingresa un nombre
2. Tipo: Email
3. URL de entrega — envia eventos de webhook al Conversation Provider Outbound Webhook

Nota: no marques la casilla "Is this a Custom Conversation Provider".

API para agregar mensaje entrante: usa el tipo "Email". El emailMessageId de la respuesta es el hilo al que se debe responder. El conversationProviderId no es requerido. https://marketplace.gohighlevel.com/docs/ghl/conversations/add-an-inbound-message

Activar el proveedor: ve a Configuración de la sub-cuenta > Servicios de correo, selecciona tu proveedor y guarda.

Flujos de trabajo: soporta los módulos estandar de correo. Los disparadores (triggers) no estan soportados actualmente; usa acciones premium de flujo de trabajo.

Acciones masivas: soportadas.

Proveedor de correo (adicional)

Descripcion: agrega un proveedor de correo personalizado adicional.

1. Ingresa un nombre
2. Tipo: Email
3. URL de entrega — envia eventos de webhook al Conversation Provider Outbound Webhook
4. Marca la casilla "Is this a Custom Conversation Provider"
5. Pestaña de conversaciones (opcional) — igual que en SMS
6. Alias (opcional)
7. Logo (opcional)

API para agregar mensaje entrante: usa el tipo "Custom". También puedes definir altId. Cuando respondas desde la interfaz, el payload saliente del proveedor incluira replyToAltId. El conversationProviderId si es requerido. https://marketplace.gohighlevel.com/docs/ghl/conversations/add-an-inbound-message

Activar el proveedor: se activa automáticamente al instalarse. Revisa Configuración > Proveedores de conversacion.

Flujos de trabajo: puedes construir acciones premium de flujo de trabajo; los disparadores y los módulos de correo no estan soportados actualmente.

Proveedor de llamadas

Descripcion: agrega un proveedor de llamadas. Es específico para registrar llamadas (y adjuntar, por ejemplo, buzones de voz a una conversacion) — no se usa para reemplazar la conexión de voz/SIP.

1. Ingresa un nombre
2. Tipo: Call
3. URL de entrega — envia eventos de webhook al Conversation Provider Outbound Webhook

API para agregar mensaje entrante: usa el tipo "Call". Envia el payload del objeto de llamada y asegurate de que el teléfono "from" coincida con un contacto existente. Se usa para registrar llamadas entrantes. El conversationProviderId si es requerido. https://marketplace.gohighlevel.com/docs/ghl/conversations/add-an-inbound-message

API para agregar llamada saliente externa: se usa para registrar llamadas salientes. Asegurate de que el teléfono "to" coincida con un contacto existente. https://marketplace.gohighlevel.com/docs/ghl/conversations/add-an-outbound-message

Eventos de webhook

Eventos de webhook de mensaje saliente del proveedor de conversacion https://marketplace.gohighlevel.com/docs/webhook/ProviderOutboundMessage

Proposito: eventos salientes distintos al payload del evento de Mensaje Saliente estandar.

Eventos de mensaje saliente https://marketplace.gohighlevel.com/docs/webhook/OutboundMessage

Proposito: monitorea todos los mensajes/canales salientes.

Notas adicionales

Uso de los proveedores

1. Pantalla de conversaciones — ve a la pantalla de conversaciones para enviar/recibir mensajes si un proveedor esta configurado como predeterminado, o si habilitaste la opción de verlo.
2. Acciones masivas — por ahora solo soportadas en proveedores predeterminados.
3. Flujos de trabajo — revisa las notas sobre los módulos actualmente soportados.
4. Aplicación movil — selecciona tu proveedor personalizado según el tipo.

API para actualizar el estado del mensaje

El estado de un mensaje solo puede actualizarse mediante el token de la app del Marketplace que actua como proveedor de conversacion. Si tu cuenta tiene otras apps del Marketplace instaladas, esas no pueden actualizar el estado del mensaje. https://marketplace.gohighlevel.com/docs/ghl/conversations/update-message-status