Canales

Que Son los Canales?

Los canales son las plataformas de comunicacion que sus agentes de Neotask utilizan para enviar y recibir mensajes. Al conectar un canal, le da a un agente la capacidad de escuchar mensajes entrantes en esa plataforma y responder en tiempo real.

Conceptos clave:

• Configuracion por agente -- Cada conexion de canal se configura a nivel del agente. Un agente puede estar conectado a Slack mientras otro maneja Discord, o un solo agente puede estar conectado a multiples canales simultaneamente.
• Bidireccional -- Los canales soportan tanto envio como recepcion de mensajes. Los agentes pueden responder a mensajes entrantes, iniciar mensajes salientes, o ambos.
• Multi-cuenta -- Puede conectar multiples cuentas del mismo tipo de canal (por ejemplo, dos espacios de trabajo de Slack diferentes o varias direcciones de correo electronico).

Canales Soportados

Conexion de un Canal

El proceso de conexion varia dependiendo del metodo de autenticacion del canal.

Flujo OAuth

Usado por: Slack, Microsoft Teams, Google Chat, Email / Gmail

1. Abra la pestana Canales del agente.
2. Haga clic en Conectar junto al canal que desea agregar.
3. Sera redirigido a la pagina de autorizacion del servicio.
4. Inicie sesion con su cuenta y otorgue a Neotask los permisos solicitados.
5. Despues de la autorizacion, es redirigido de vuelta al panel y el canal aparece como conectado.

Para plataformas moviles, hay disponible una opcion de codigo QR. Escanee el codigo QR desde su telefono para completar la autorizacion sin necesidad de iniciar sesion en su navegador de escritorio.

Token de Bot

Usado por: Discord, Telegram

1. Cree un bot en la plataforma respectiva:
   • Discord -- Cree una aplicacion en el Discord Developer Portal y genere un token de bot.
   • Telegram -- Envie un mensaje a @BotFather en Telegram para crear un bot y recibir un token.
2. Abra la pestana Canales del agente y haga clic en Conectar junto al canal.
3. Pegue el token de bot en el campo de token.
4. Haga clic en Guardar para establecer la conexion.

Codigo QR

Usado por: WhatsApp

1. Abra la pestana Canales del agente y haga clic en Conectar junto a WhatsApp.
2. Aparecera un codigo QR en pantalla.
3. Abra WhatsApp en su telefono, vaya a Dispositivos Vinculados, y escanee el codigo QR.
4. La conexion se establece una vez que su telefono confirma el vinculo.

Clave API

Usado por: SMS

1. Obtenga una clave API de su proveedor de SMS (por ejemplo, Twilio, Vonage).
2. Abra la pestana Canales del agente y haga clic en Conectar junto a SMS.
3. Ingrese su clave API y cualquier campo adicional requerido (por ejemplo, numero de telefono, Account SID).
4. Haga clic en Guardar para activar el canal.

Token

Usado por: Matrix, Line, Zalo

1. Genere un token de acceso desde los ajustes de desarrollador o panel de administracion de la plataforma respectiva.
2. Abra la pestana Canales del agente y haga clic en Conectar junto al canal.
3. Pegue el token en el campo de token.
4. Haga clic en Guardar para establecer la conexion.

Configuracion de Servidor

Usado por: IRC

1. Abra la pestana Canales del agente y haga clic en Conectar junto a IRC.
2. Ingrese la direccion del servidor, puerto, apodo y (opcionalmente) una contrasena.
3. Especifique los canales a unirse al conectar.
4. Haga clic en Guardar para conectar.

Aplicacion Local

Usado por: Signal, iMessage

1. Asegurese de que la aplicacion requerida este instalada y ejecutandose en la maquina host:
   • Signal -- Signal Desktop debe estar instalado y vinculado a su cuenta de Signal.
   • iMessage -- Requiere un host macOS con Messages.app configurado.
2. Abra la pestana Canales del agente y haga clic en Conectar junto al canal.
3. Neotask detectara la aplicacion local y establecera una conexion.
4. Si la aplicacion no se detecta, se le pedira que la instale o configure.

Prueba de Conexion

Despues de conectar cualquier canal, Neotask ejecuta automaticamente una prueba de latencia para verificar la conexion:

• Se envia y recibe un mensaje de prueba a traves de la API del canal.
• Se mide y muestra la latencia de ida y vuelta.
• Si la prueba falla, un mensaje de error describe el problema (por ejemplo, token invalido, autorizacion OAuth expirada, servidor inalcanzable).

Puede volver a ejecutar la prueba de conexion en cualquier momento desde los ajustes del canal.

Operaciones de Canal

Una vez que un canal esta conectado, puede gestionarlo desde la pestana Canales del agente.

Habilitar / Deshabilitar

Active o desactive un canal sin desconectarlo. Cuando esta deshabilitado:

• El agente deja de escuchar mensajes en ese canal.
• No se envian mensajes salientes a traves de el.
• Las credenciales de conexion se preservan para que pueda volver a habilitarlo en cualquier momento sin reconfigurar.

Probar Conectividad

Ejecute una prueba de conectividad bajo demanda para verificar que el canal es alcanzable y responde. La prueba:

• Envia una solicitud API ligera al servicio del canal.
• Mide la latencia de ida y vuelta en milisegundos.
• Reporta el resultado como Conectado (con latencia) o Fallido (con detalles del error).

Ver Latencia

Cada canal conectado muestra su lectura de latencia mas reciente en la pestana Canales. Esto le ayuda a identificar conexiones lentas o degradadas de un vistazo. La latencia se actualiza:

• Automaticamente despues de cada prueba de conexion.
• Periodicamente en segundo plano mientras el canal esta activo.

Desconectar / Cerrar Sesion

Para eliminar completamente una conexion de canal:

1. Haga clic en Desconectar junto al canal.
2. Confirme la accion en el dialogo.
3. Neotask revoca o descarta las credenciales almacenadas (los tokens OAuth se revocan en el lado del proveedor donde sea soportado).
4. El canal se elimina de la lista de canales activos del agente.

Para reconectar despues de desconectar, siga los pasos de conexion originales nuevamente.