Table of Contents

X Direct (Mensajes Directos)

  • ID del canal: 8 — Proveedor: Lynn.
  • Tipo de canal: Texto (mensajes directos).
  • Visibilidad del canal: Público.
  • Complejidad de integración: Alta / requiere contratación comercial (acceso a la API de X restringido a planes PRO y Enterprise; requiere cuenta de administración de X y aprobación de permisos por parte del cliente).
  • Chat general o solo Kyubo: Chat general.
  • Sandbox disponible: N/D.
Warning

Actualmente, la red social X ha restringido el acceso a sus APIs a los planes PRO y Enterprise (documentación previa la mencionaba también en Free/Basic). Lynn está disponible para dichas integraciones en la versión 2.0, para los planes indicados y bajo las condiciones que la red social establece.

Definición

El canal de red social X se subdivide, según su integración, en Mensajes Directos (X Direct) y Menciones (X Mention — ver X Mention). La integración con este canal depende de la incorporación de parámetros obtenidos de la aplicación y entorno de implementación de X Developer, configurados posteriormente en la herramienta de integración de canales de Lynn.

Requisitos previos

El cliente debe tener acceso a la cuenta de administración de X para obtener:

  • Identificador de la aplicación cliente en X (X_CLIENT_ID).
  • Clave secreta de la aplicación cliente en X (X_CLIENT_SECRET).

Procedimiento de configuración en Lynn

  1. Buscar el canal a crear (X Directo o X Mención) en el diseñador de flujos.

    Buscar el canal X en el listado de canales del diseñador (1)

    Buscar el canal X en el listado de canales del diseñador (2)

  2. Agregar los parámetros de la aplicación creada en X: la dupla OAuth 2.0 (CLIENT ID y CLIENT SECRET) y el Timeout.

    Formulario de parámetros OAuth 2.0 (Client ID, Client Secret, Timeout)

  3. Presionar "Verificar": se muestra una página web de X solicitando al cliente autorizar a la aplicación a enviar y recibir mensajes. Esta URL puede copiarse y enviarse al cliente para su aprobación. Mientras no se autorice, la ventana de creación del canal en Lynn permanece bloqueada.

    Página web de X solicitando autorización de permisos

  4. Una vez otorgados los permisos, se muestra una página de confirmación del proceso satisfactorio (en caso de error, se indica el problema).

    Página de confirmación del proceso satisfactorio

Guardar los datos del canal

Después de que el cliente aprueba la cesión de permisos, la ventana de configuración del canal se desbloquea y permite:

  1. Configurar solo el canal actual.
  2. Configurar el canal actual y el otro canal (Directo/Mención) simultáneamente: al configurar Menciones también se configura el canal Directo con los mismos atributos, y viceversa.
  3. Cancelar la operación (no se realiza ningún cambio).

Creación de ambos canales a la vez

Al seleccionar la opción se crea el canal, informando en una ventana la finalización del proceso.

Seleccionar la opción "Correr el Directo y Menciones a la misma cuenta" y presionar "Crear"; se confirma la creación de ambos canales, que quedan visibles en el diseñador.

Borrar el canal de X

Clic derecho sobre el canal → botón de borrar.

Menú contextual del canal X con la opción de borrar

Diagnóstico y resolución de problemas — "Mis clientes de X Direct Message no ven las respuestas de los ejecutivos"

  1. Revisar los mensajes recibidos en el correo asociado a la cuenta de administración del canal de X registrada en Lynn, buscando algún correo de error o advertencia enviado por X.
  2. Ingresar al Portal de Desarrollo de X y verificar que no existan alertas asociadas a la cuenta. Si existe una alerta de bloqueo de cuenta, seguir las instrucciones del portal de desarrollo para resolver el problema.

Generalmente estos casos se resuelven enviando un ticket de soporte a X desde su portal, describiendo el problema, los antecedentes y/o el código de error observado (ejemplo de redacción sugerida: "El día de ayer presentamos un problema enviando mensajes repetidos a través de nuestra cuenta y al parecer se bloqueó la cuenta con un código de error <código>, se probó y el error está corregido").

Se sugiere tener disponibles los siguientes datos antes de abrir el ticket: información de la cuenta, aplicación asociada y detalle del error observado en el dashboard de X (alertas por infracción de políticas del canal). Es importante que, una vez desbloqueada la cuenta, se resuelva la causa raíz del problema según las indicaciones de X.

Datos sugeridos para la apertura de un ticket de soporte

Ejemplo de alerta en el dashboard del portal de desarrollo de X por infracción de políticas