# Mensajería instantánea (/es/docs/verdent-manager/core-features/instant-messaging)

> 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 [#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 [#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 [#cómo-acceder-a-la-configuración]

<Steps>
  <Step title="Abre Agregar canal">
    En la barra lateral izquierda de Manager, selecciona el botón &#x2A;*+** 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 [#configuración-de-telegram]

### Etapa 1: crear el Bot y obtener el token [#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 [#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 [#configuración-de-slack]

### Etapa 1: crear la app de Slack y obtener los tokens [#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 [#etapa-2-emparejamiento-por-mensaje-1]

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 [#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 [#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 [#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 [#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 [#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 [#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 [#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 [#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 [#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 [#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>