Coroid cuenta con bots de plataforma para Slack, Discord, Telegram y SMS. Configúralos en esta sección: Configuración → Conexiones → Canales.
Qué hace cada uno en la actualidad:
| Plataforma | Los mensajes se convierten en solicitudes | Recibe actualizaciones |
|---|---|---|
| Slack | Sí, mediante una automatización de eventos | Actualizaciones de tareas, a través de un webhook entrante |
| Telegram | Sí, mediante una automatización de eventos | No |
| Discord | No | No |
| SMS | No | No |
Puedes guardar un bot de Discord o SMS, pero nada lo utiliza hoy en día. En la misma página también hay puentes de canal que aún no funcionan. Ver Puentes de canal.
Bots de plataforma
El bot es la identidad que Coroid utiliza en la plataforma. Instálalo una vez por espacio de trabajo o servidor y otorga acceso a los canales que debe leer. Slack y Telegram necesitan su bot para que la automatización de eventos pueda leer los mensajes.
Si se elimina un bot de Slack de un canal, Coroid dejará de leer ese canal, y no hay ningún aviso al respecto. Si los mensajes de Slack dejan de convertirse en solicitudes, comprueba que el bot continúe en el canal.
Solo los propietarios y administradores pueden agregar, modificar o eliminar un bot. Cada plataforma envía sus eventos a una URL de webhook en la pasarela API, que Coroid muestra para cada bot. Coroid rechaza cualquier entrega que no esté firmada con el secreto del bot.
Iniciar trabajo desde un canal
Un mensaje de Slack o Telegram puede convertirse en una solicitud de trabajo. Los mensajes de Discord y SMS no pueden hacerlo.
Un mensaje se convierte en solicitud mediante una automatización de eventos. Esto es útil para las solicitudes del tipo "¿puede alguien arreglarlo ya?" que de otro modo nunca se registrarían como trabajo.
Un mensaje coincidente se envía a Qualificación como solicitud. Qualificación lo analiza, busca duplicados y determina qué debe convertirse en. Nada se crea hasta que apruebe. Ver Formas de iniciar trabajo.
Coroid no vincula las cuentas de Slack o Telegram con las cuentas de Coroid, por lo que cualquier persona que pueda publicar en un chat correspondiente puede presentar una solicitud. Por esa razón, el trabajo desde un chat nunca comienza por sí solo. Se crea una tarea calificada y espera a que alguien la inicie, y un plan espera la aprobación.
Ver Desencadenadores y destinos.
Slack
- Configure el bot de Slack en esta sección: Bots de plataforma. Necesita el token del bot y el secreto de firma de la aplicación de Slack.
- En tu aplicación de Slack, envía los mensajes del canal y las menciones de la app al URL del webhook
que muestra Coroid:
https://api.coroid.ai/api/v1/webhooks/slack/events. - Invita al bot a cada canal que deba leer.
- Activa Slack en Control de Calidad → Valor predeterminado de la organización → Antes de que comience el trabajo → Origen de las solicitudes. Solo los propietarios y administradores pueden activar un origen, y solo después de conectar el bot.
Al activar Slack se añade una automatización que convierte los mensajes coincidentes en solicitudes. Aparece en Fábrica → Automatizaciones, donde puedes modificar su filtro. Desactivar Slack pausa la automatización y conserva su filtro.
El filtro de la automatización determina qué mensajes cuentan. Comienza haciendo coincidir
los mensajes que contengan esta mención: @coroid. Un filtro también puede limitar la
automatización a un canal, o a los mensajes enviados por bots, como las alertas.
Coroid procesa como máximo 10 automatizaciones de Slack por minuto en un canal.
Telegram
- Añade el bot de Telegram en esta sección: Bots de plataforma. Coroid registra su webhook en Telegram y lo protege con un secreto de webhook. Si dejas el secreto vacío, Coroid generará uno.
- Añade el bot al grupo o hazlo administrador del canal.
- Activa Telegram en Control de Calidad → Valor predeterminado de la organización → Antes de que comience el trabajo → Origen de las solicitudes. Su automatización aparece en Fábrica → Automatizaciones, donde puedes modificar su filtro.
- En el chat, comienza cada solicitud con este comando:
/coroid.
El modo de privacidad de Telegram, activado por defecto, permite al bot ver los comandos pero no los mensajes ordinarios. Un filtro también puede limitar la automatización a un chat mediante su ID. El bot ignora los mensajes directos a menos que el filtro lo permita.
Cualquier persona puede añadir tu bot a otro grupo y registrar solicitudes desde allí. Para evitarlo, limita la automatización a tu chat o impide que el bot se una a grupos con este comando de BotFather: /setjoingroups.
Coroid acepta como máximo 10 mensajes coincidentes por minuto desde un chat. Si la automatización está limitada a un proyecto, sus solicitudes irán a ese proyecto.
Puentes de canal
Un puente conecta un canal con una sesión del asistente de chat.
Hablar con el asistente a través de un puente no está disponible. Un puente no pasa mensajes al asistente, por lo que no puede iniciar ni dirigir trabajos.
Actualizaciones en un canal
Slack es la única plataforma de chat que recibe actualizaciones. Coroid publica mensajes en un canal de Slack cuando una tarea se completa, falla o se escala, así como cuando reintenta o abandona ante un conflicto de fusión. Los mensajes se envían a través de un webhook entrante de Slack vinculado a tu organización, no mediante el bot de Slack. Por ahora, no existe ninguna pantalla de configuración para conectar dicho webhook.
Discord, Telegram y SMS no reciben actualizaciones. Todo lo demás llega al portal. Consulta Notificaciones.