Conexión de canales externos al chat
Las integraciones de canales reúnen la comunicación con los clientes desde distintos lugares en un solo flujo de trabajo. El cliente escribe donde le resulta cómodo — en Telegram, WhatsApp o mediante el formulario del sitio —, y el mensaje llega al chat de LadVen OS, donde el equipo responde, asigna un responsable y vincula la solicitud con una tarea u oportunidad.
Esta es la base del trabajo omnicanal: la conversación no se pierde en los teléfonos personales de los empleados, y el historial permanece en el portal, disponible para el equipo.
Cada empleado también puede vincular su Telegram desde los ajustes del Extranet: el portal muestra un código de un solo uso que debe enviarse al bot de Telegram conectado. El código no se introduce de nuevo en el portal; actualiza las vinculaciones cuando responda el bot. Si la integración de Telegram no está activada, pide a un responsable que la habilite. Puedes revocar el acceso en los mismos ajustes y volver a cargar la lista de vinculaciones.
En la configuración de Telegram, vinculado no garantiza la entrega: un enlace antiguo puede requerir migración. Un responsable puede iniciar la migración o pedir al cliente que vuelva a conectar. El cliente envía al bot la línea completa /bind <code> y después actualiza los enlaces; el código de un solo uso tiene un plazo y nunca se introduce de nuevo en el portal. Tras recargar o cambiar de pestaña, emita un código nuevo. Un código caducado, un bot incorrecto/comando omitido y un Telegram vinculado a otra cuenta requieren acciones distintas; el conflicto lo libera un administrador.
Escenarios de canales externos
Telegram, WhatsApp y los formularios web pueden enviar mensajes al chat cuando su adaptador está activo. No son tipos del formulario genérico /chat/integrations, que solo usa external, bot y webhook.
Ahora se pueden conectar al chat:
- Telegram — mensajes de un bot o canal de Telegram;
- WhatsApp — mensajes de WhatsApp;
- Formulario del sitio — solicitudes enviadas mediante el formulario de su sitio.
Cada canal se conecta como una integración independiente. Una misma empresa puede tener varias integraciones a la vez — por ejemplo, Telegram para un producto y WhatsApp para otro.
El conjunto de canales disponibles depende de la configuración de su portal y de los adaptadores conectados. Si el canal que necesita no está en la lista, consulte con el administrador del portal si está disponible en su configuración.
/chat/integrations configura conexiones externas, de bots y webhook genéricas para el chat. El formulario tiene campos tipados endpointUrl de salida e inboundToken de entrada; los parámetros avanzados deben ser un objeto JSON. Se rechazan el JSON no válido y el JSON que no sea un objeto. El control de entrega está separado en /chat/integrations/ops; la configuración de proveedores Telegram y WhatsApp está en el CRM Integration Hub y no forma parte de este formulario.
Cómo conectar un canal (con permiso de gestión)
chat.canReadSettings permite consultar la lista; crear y modificar requiere chat.canManageSettings. Sin permiso de gestión, la pantalla queda en modo de solo lectura.
- Abra la sección de integraciones del chat en los ajustes.
- Cree una nueva integración y asígnele un nombre claro — por ejemplo, «Telegram: ventas» o «WhatsApp: soporte». Por el nombre, el equipo sabrá de dónde llegan los mensajes.
- Elija el tipo de conexión.
- Complete los campos tipados de dirección de salida y token de entrada; use un objeto JSON solo para parámetros adicionales. Se rechaza el JSON no válido o que no sea un objeto. Tome los valores exactos del proveedor; el portal no publica secretos ni los adivina.
- Active la integración y guarde.
Después de guardar, la integración aparece en la lista con su estado. Desactivarla o eliminarla se hace en el mismo lugar, y los parámetros se actualizan cuando cambian los accesos del canal.
Prepare los parámetros del canal con antelación y compruébelos antes de activar: un error en el token o en la dirección significa que los mensajes no llegarán ni se enviarán.
Cómo lo ve el equipo
Cuando un canal está conectado, los mensajes de los clientes llegan al chat como conversaciones normales. A partir de ahí, el equipo trabaja con ellos igual que con los chats internos:
- responde al cliente directamente desde el portal;
- adjunta archivos, responde a un mensaje concreto, usa menciones;
- vincula la conversación con una tarea u oportunidad para que la solicitud entre en el flujo de trabajo;
- fija los mensajes importantes y busca en la conversación.
El cliente recibe las respuestas de vuelta en su canal — sigue comunicándose de la forma habitual, sin saber de la cocina interna del portal.
Operaciones de entrega
Para los canales externos es importante que los mensajes no solo lleguen, sino que también salgan de vuelta al cliente. Para ello existe una consola operativa de entrega, donde el administrador ve el estado del envío:
Los usuarios con chat.canReadSettings pueden consultar la lista y la consola. Crear, editar, activar, desactivar, borrar y reintentar requiere chat.canManageSettings; un operador que no sea administrador puede verla en modo de solo lectura.
- cuántos mensajes hay en cola, enviados, con error o vencidos;
- entregas atascadas filtradas por integración, límite numérico o
overdueOnly; - filas de dead-letter con estado, intentos,
maxAttemptsy el último error; - el reintento solo está disponible para quien puede gestionar: actualiza la misma entrega, su estado y el contador de intentos, sin crear una copia oculta.
Revise la consola con regularidad para los canales activos: si crece el número de errores o de mensajes atascados, el problema suele estar en los accesos del canal o en sus límites, no en el propio portal.
En una pantalla estrecha, los mismos datos se convierten en tarjetas: la tarjeta de una entrega atascada conserva la integración, los contadores pending/failed/overdue y la antigüedad de la entrega pendiente más antigua; una tarjeta DLQ muestra el estado, attempts/maxAttempts, el último error y Reintentar. Sin chat.canManageSettings, Reintentar está desactivado; no lo pulse durante la captura para mantenerla en solo lectura y no modificar la cola. El screenshot localizado debe usar etiquetas del idioma objetivo, identificadores sintéticos sin PII/secretos y revisión RTL para ar.
Buenas prácticas
- Nombre las integraciones por canal y propósito, para que el equipo entienda de inmediato el origen de los mensajes.
- Prepare y compruebe los parámetros del canal antes de activar la integración.
- Asigne un responsable para cada canal externo, o las solicitudes quedarán «visibles para todos» y sin cerrar por nadie.
- Vincule las conversaciones de clientes con tareas u oportunidades, para que la solicitud no quede solo como conversación.
- Revise periódicamente la consola de entrega para los canales activos.
- Al cambiar tokens o accesos del canal, actualice de inmediato los parámetros de la integración.
Errores frecuentes
- Un error en los parámetros de conexión — los mensajes no llegan o no se envían, y la causa no se ve en la propia conversación.
- No hay responsable del canal — las solicitudes de clientes se pierden en el flujo general.
- Una conversación de un canal externo no está vinculada con una tarea u oportunidad — el acuerdo queda solo en el chat.
- Nadie mira la consola de entrega — los errores de envío se acumulan sin notarse y el cliente no recibe respuesta.
Secciones relacionadas