---
title: Mensajería instantánea
description: "Asigna trabajo a Manager desde Telegram, Slack o Feishu"
---

No necesitas estar frente a tu equipo para asignar trabajo a Manager. Al conectar Telegram, Slack o Feishu, puedes enviar mensajes a Manager en cualquier momento y lugar usando herramientas de chat conocidas. Manager convierte tus mensajes en tareas estructuradas y comienza a ejecutarlas: captura una idea mientras navegas en tu dispositivo móvil y vuelve más tarde para ver el resultado.

## Plataformas de mensajería instantánea compatibles

| Plataforma       | Tipo          |
|------------------|---------------|
| Telegram         | Bot personal  |
| Slack            | Bot de espacio de trabajo |
| Feishu           | Bot empresarial |

Cada plataforma requiere crear un Bot en su consola de desarrolladores y luego completar el emparejamiento en Verdent. Una vez conectado, cualquier mensaje que envíes al Bot se reenvía directamente a Manager.

---

## Flujo de conexión

El proceso de conexión tiene dos etapas:

1. **Ingresar el token** — configuración de credenciales
2. **Enviar un mensaje para emparejar** — vincular el Bot con Manager

Todo se configura en la página de ajustes de canales de la barra lateral de Manager.

### Cómo acceder a la configuración

<Steps>
  <Step title="Abre Agregar canal">
    En la barra lateral izquierda de Manager, selecciona el botón **+** en la parte superior (Agregar canal).
  </Step>
  <Step title="Selecciona una plataforma">
    Elige la plataforma que quieres conectar (Telegram, Slack o Feishu).
  </Step>
  <Step title="Sigue los pasos guiados">
    Completa la configuración de dos etapas en el panel lateral.
  </Step>
</Steps>

---

## Configuración de Telegram

### Etapa 1: crear el Bot y obtener el token

<Steps>
  <Step title="Escribe a BotFather">
    Busca [@BotFather](https://t.me/BotFather) en Telegram y envía `/newbot`.
  </Step>
  <Step title="Asigna un nombre a tu bot">
    Sigue las indicaciones para proporcionar un nombre visible y un nombre de usuario.
  </Step>
  <Step title="Copia el token">
    Tras la creación, BotFather devuelve un token con el formato `123456:ABC-DEF1234...`.
  </Step>
  <Step title="Pégalo en Verdent">
    Pega el token en el campo **Bot Token** del panel de configuración de Verdent y confirma.
  </Step>
</Steps>

### Etapa 2: emparejamiento por mensaje

<Steps>
  <Step title="Envía un mensaje">
    Abre tu nuevo bot en Telegram y envía cualquier mensaje (por ejemplo, `hello`).
  </Step>
  <Step title="Recibe el código de emparejamiento">
    El bot responde automáticamente con un código de emparejamiento.
  </Step>
  <Step title="Confirma en Verdent">
    Ingresa el código en el panel de Verdent y confirma. La conexión ya está completa.
  </Step>
</Steps>

---

## Configuración de Slack

### Etapa 1: crear la app de Slack y obtener los tokens

<Steps>
  <Step title="Crea una nueva app">
    Ve a [api.slack.com/apps](https://api.slack.com/apps) y selecciona **Create New App**.
  </Step>
  <Step title="Usa el manifiesto proporcionado">
    Elige **From an app manifest** y pega el manifiesto JSON proporcionado por Verdent (hay un botón para copiar en la interfaz).
  </Step>
  <Step title="Selecciona un espacio de trabajo">
    Elige el espacio de trabajo de Slack y crea la app.
  </Step>
  <Step title="Copia ambos tokens">
    En los ajustes de la app, ubica el **Bot Token** (`xoxb-`) y el **App Token** (`xapp-`), y luego pega ambos en el panel de configuración de Verdent.
  </Step>
</Steps>

<Note>
  **Requisito del nombre de la app:** el nombre debe tener menos de 80 caracteres y no puede contener caracteres chinos, japoneses ni coreanos.
</Note>

### Etapa 2: emparejamiento por mensaje

Igual que en Telegram: envía un mensaje al bot, recibe el código de emparejamiento e ingrésalo en Verdent para completar la conexión.

---

## Configuración de Feishu

Feishu requiere algunos pasos más que Telegram o Slack: los permisos se configuran por separado y los eventos deben suscribirse manualmente. No es complejo, pero cada paso debe hacerse correctamente o la conexión se detendrá. Síguelos en orden.

### Paso 1: crear una app personalizada

<Steps>
  <Step title="Abre la consola de desarrolladores">
    Ve a la [plataforma abierta de Feishu](https://open.feishu.cn/app) e inicia sesión con tu cuenta de Feishu.
  </Step>
  <Step title="Crea una app personalizada">
    Selecciona **Create Custom App** en la esquina superior derecha.
  </Step>
  <Step title="Completa la información básica">
    Ingresa el nombre y la descripción de la app, y luego finaliza la creación.
  </Step>
</Steps>

### Paso 2: configurar permisos

Abre la nueva app y ve a **Permissions & Scopes** en el menú izquierdo.

Feishu admite la importación masiva de scopes, por lo que no tienes que marcarlos uno por uno. Busca la opción de importación/exportación masiva en la página y pega el siguiente JSON completo:

```json
{
  "scopes": {
    "tenant": [
      "im:message:send_as_bot",
      "im:message",
      "im:resource",
      "im:chat",
      "im:chat:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "wiki:wiki:readonly",
      "application:application:self_manage"
    ],
    "user": []
  }
}
```

Tras confirmar la importación, todos los scopes anteriores deberían aparecer seleccionados en la lista de permisos.

### Paso 3: obtener las credenciales y conectar Verdent

Abre **Credentials & Basic Info** en el menú izquierdo:

<Steps>
  <Step title="Copia el App ID y el App Secret">
    Copia el **App ID** (con el formato `cli_xxx...`) y el **App Secret**.
  </Step>
  <Step title="Pégalos en Verdent">
    Pega ambos valores en los campos correspondientes del panel de configuración de Verdent.
  </Step>
  <Step title="Conecta">
    Selecciona **Connect** para completar la primera etapa.
  </Step>
</Steps>

### Paso 4: habilitar la conexión persistente

Una vez conectado, vuelve a la plataforma abierta de Feishu y abre **Events & Callbacks**.

Activa **Use Long Connection to Receive Events**. Este interruptor controla cómo Feishu entrega los mensajes al bot: la conexión persistente no requiere que expongas una URL pública, sino que mantiene una conexión continua, lo cual es más confiable.

### Paso 5: suscribirse a los eventos de mensajes y publicar

Todavía en la página **Events & Callbacks**:

<Steps>
  <Step title="Agrega el evento de mensaje">
    Selecciona **Add Event**, luego busca y agrega `im.message.receive_v1` (evento de recepción de mensajes).
  </Step>
  <Step title="Crea y publica una versión">
    Selecciona **Create and Publish Version** en la esquina superior derecha, completa las notas de la versión y confirma.
  </Step>
  <Step title="Empareja con Verdent">
    Tras publicar, regresa a Verdent y envía un mensaje a tu bot de Feishu para completar el emparejamiento.
  </Step>
</Steps>

### Qué hace cada permiso

| Permiso | Propósito |
|------------|---------|
| Familia `im:message:*` | Permite que el bot lea y envíe mensajes, incluidos mensajes directos y menciones @ en grupos |
| `im:chat:*` | Lee la lista de conversaciones a las que pertenece el bot |
| `im:resource` | Lee imágenes, archivos y otros recursos adjuntos a los mensajes |
| `contact:*` | Lee la información básica de contacto para identificar quién envió un mensaje |
| `docs:document.content:read` / `wiki:wiki:readonly` | Lee el contenido de Feishu Docs y Wiki, para que los enlaces de documentos puedan pasarse a Manager como contexto |
| `application:application:self_manage` | Administra la configuración propia de la app; necesario para la capacidad de conexión persistente |

---

## Después de una conexión exitosa

Una vez emparejado, el canal aparece en la lista de canales de la barra lateral izquierda de Manager y muestra:

- Ícono de la plataforma y nombre del canal
- Estado de la conexión (**Connected** / **Disconnected** / **Needs attention**)
- Vista previa y marca de tiempo del último mensaje
- Indicador de mensajes no leídos (punto verde)

A partir de este momento, cada mensaje enviado al Bot es gestionado directamente por Manager como una tarea ejecutable.

---

## Gestionar los canales conectados

- **Ver todos los canales** — todos los canales de mensajería conectados aparecen en la barra lateral.
- **Eliminar un canal** — coloca el cursor sobre un canal, selecciona eliminar y confirma. Si es el último canal de ese tipo, también se borra la configuración del bot.
- **Reconectar** — si un canal muestra **Disconnected** o **Needs attention**, aparece un aviso de reparación en la parte superior para volver a configurarlo.

---

## Casos de uso

<CardGroup cols={3}>
  <Card title="Centro de mando móvil" icon="mobile">
    Mientras estás en movimiento, dile al bot en Telegram: "Despliega los últimos cambios de la rama main en staging". Para cuando regreses, el resultado estará listo.
  </Card>
  <Card title="Colaboración en equipo" icon="users">
    Menciona a tu bot de Manager en un canal de Slack para resumir el estado de los PR de hoy; las respuestas aparecen directamente en el canal para que todo el equipo las vea.
  </Card>
  <Card title="Captura rápida de ideas" icon="lightbulb">
    Antes de dormir, envía una idea al bot y pide a Manager que la convierta en una tarea para ejecutarla mañana.
  </Card>
</CardGroup>