Solución en modo Integración
Una solución en modo Integración no tiene página de chat propia. Otro sistema —un sitio, una aplicación, una plataforma de atención— envía los mensajes y recibe las respuestas del agente por webhook.
El modo se elige al crear la solución y hace que cambien tres cosas:
- la solución gana la pestaña Integración en la configuración;
- el elemento Chat pasa a ser Chat (Integración), solo para consulta;
- mientras no haya integración registrada, la pantalla de agentes avisa y ofrece el atajo Abrir configuración de integración.
Crear la integración
Sección titulada «Crear la integración»En Configuración → Integración, haz clic en Nueva integración.
| Campo | Qué indicar |
|---|---|
| Nombre de la integración | Una etiqueta para el sistema conectado |
| URL pública de la API | La completa MarIA, con el botón Copiar URL. Es la dirección que llamará el otro sistema |
| Modo de la conversación | Encolar cuando esté ocupado (recomendado) o Rechazar cuando esté ocupado, que devuelve HTTP 409 de inmediato |
| Limitar solicitudes por minuto | Opcional; protege ante picos |
| Máximo de solicitudes simultáneas | Recomendado 50 |
| URL del Webhook | A dónde envía MarIA el resultado de cada ejecución |
Una solución puede tener más de una integración, cada una con su clave, su webhook y sus límites, algo útil cuando dos sistemas distintos consumen la misma solución.
La clave aparece una sola vez
Sección titulada «La clave aparece una sola vez»Al crearla, MarIA muestra la API key (mk_…) y el HMAC Webhook Secret (whsec_…). Ambos se
muestran una única vez.
| Secreto | Para qué sirve |
|---|---|
| API key | El sistema externo la envía en el header X-API-Key al llamar a MarIA |
| HMAC Webhook Secret | Permite a tu sistema comprobar el header X-Hub-Signature-256 y asegurarse de que el webhook vino realmente de MarIA |
Copia y guarda ambos antes de cerrar la ventana. Si los pierdes, usa Regenerar clave, lo que invalida la anterior y obliga a actualizar el sistema conectado.
La lista de integraciones
Sección titulada «La lista de integraciones»
La tabla muestra Integración, Estado, Webhook, Rate limit, Concurrencia, API key (enmascarada) y Actualizada en, con las acciones Editar, Regenerar clave, Desactivar y Eliminar.
El enlace Abrir Swagger de la integración muestra el contrato de la API para quien programe el otro lado.
Seguir las conversaciones
Sección titulada «Seguir las conversaciones»El elemento Chat (Integración) en la barra lateral muestra, solo para consulta, las conversaciones creadas por el sistema conectado. No escribes ahí: es la ventana para ver qué preguntaron los usuarios finales y qué respondió el agente.
Cuando los mensajes no llegan
Sección titulada «Cuando los mensajes no llegan»| Síntoma | Causa probable |
|---|---|
El sistema externo recibe 401 | API key equivocada, o regenerada y no actualizada del otro lado |
El sistema externo recibe 409 | Modo de la conversación en Rechazar cuando esté ocupado, con la conversación en curso |
| El mensaje se acepta pero no vuelve nada | URL del webhook equivocada o inaccesible desde MarIA |
| Llega, pero el agente no responde | La solución no tiene agente activo; consulta Agentes |