Verdent Docs
Funciones principales

Mensajería instantánea

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

PlataformaTipo
TelegramBot personal
SlackBot de espacio de trabajo
FeishuBot 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

Abre Agregar canal

En la barra lateral izquierda de Manager, selecciona el botón + en la parte superior (Agregar canal).

Selecciona una plataforma

Elige la plataforma que quieres conectar (Telegram, Slack o Feishu).

Sigue los pasos guiados

Completa la configuración de dos etapas en el panel lateral.


Configuración de Telegram

Etapa 1: crear el Bot y obtener el token

Escribe a BotFather

Busca @BotFather en Telegram y envía /newbot.

Asigna un nombre a tu bot

Sigue las indicaciones para proporcionar un nombre visible y un nombre de usuario.

Copia el token

Tras la creación, BotFather devuelve un token con el formato 123456:ABC-DEF1234....

Pégalo en Verdent

Pega el token en el campo Bot Token del panel de configuración de Verdent y confirma.

Etapa 2: emparejamiento por mensaje

Envía un mensaje

Abre tu nuevo bot en Telegram y envía cualquier mensaje (por ejemplo, hello).

Recibe el código de emparejamiento

El bot responde automáticamente con un código de emparejamiento.

Confirma en Verdent

Ingresa el código en el panel de Verdent y confirma. La conexión ya está completa.


Configuración de Slack

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

Crea una nueva app

Ve a api.slack.com/apps y selecciona Create New App.

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).

Selecciona un espacio de trabajo

Elige el espacio de trabajo de Slack y crea la app.

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.

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

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

Abre la consola de desarrolladores

Ve a la plataforma abierta de Feishu e inicia sesión con tu cuenta de Feishu.

Crea una app personalizada

Selecciona Create Custom App en la esquina superior derecha.

Completa la información básica

Ingresa el nombre y la descripción de la app, y luego finaliza la creación.

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:

{
  "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:

Copia el App ID y el App Secret

Copia el App ID (con el formato cli_xxx...) y el App Secret.

Pégalos en Verdent

Pega ambos valores en los campos correspondientes del panel de configuración de Verdent.

Conecta

Selecciona Connect para completar la primera etapa.

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:

Agrega el evento de mensaje

Selecciona Add Event, luego busca y agrega im.message.receive_v1 (evento de recepción de mensajes).

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.

Empareja con Verdent

Tras publicar, regresa a Verdent y envía un mensaje a tu bot de Feishu para completar el emparejamiento.

Qué hace cada permiso

PermisoPropó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:resourceLee 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:readonlyLee el contenido de Feishu Docs y Wiki, para que los enlaces de documentos puedan pasarse a Manager como contexto
application:application:self_manageAdministra 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

Centro de mando móvil

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.

Colaboración en equipo

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.

Captura rápida de ideas

Antes de dormir, envía una idea al bot y pide a Manager que la convierta en una tarea para ejecutarla mañana.