---
title: Mensagens instantâneas
description: "Atribua trabalho ao Manager pelo Telegram, Slack ou Feishu"
---

Você não precisa estar no computador para atribuir trabalho ao Manager. Ao conectar Telegram, Slack ou Feishu, você pode enviar mensagens ao Manager a qualquer hora e em qualquer lugar usando ferramentas de chat familiares. O Manager transforma suas mensagens em tarefas estruturadas e começa a executá-las—capture uma ideia enquanto navega no celular e volte mais tarde para ver o resultado.

## Plataformas de mensagens instantâneas suportadas

| Plataforma       | Tipo          |
|------------------|---------------|
| Telegram         | Bot pessoal   |
| Slack            | Bot de espaço de trabalho |
| Feishu           | Bot empresarial |

Cada plataforma requer a criação de um Bot em seu console de desenvolvedor e, em seguida, a conclusão do pareamento no Verdent. Uma vez conectado, qualquer mensagem que você enviar ao Bot é encaminhada diretamente ao Manager.

---

## Fluxo de conexão

O processo de conexão tem duas etapas:

1. **Inserir token** — configuração de credenciais
2. **Enviar mensagem para pareamento** — vincular o Bot ao Manager

Tudo é configurado na página de configurações de canais na barra lateral do Manager.

### Como acessar a configuração

<Steps>
  <Step title="Abrir Add Channel">
    Na barra lateral esquerda do Manager, clique no botão **+** no topo (Add Channel).
  </Step>
  <Step title="Selecionar uma plataforma">
    Escolha a plataforma que deseja conectar (Telegram, Slack ou Feishu).
  </Step>
  <Step title="Siga as etapas guiadas">
    Conclua a configuração de duas etapas no painel lateral.
  </Step>
</Steps>

---

## Configuração do Telegram

### Etapa 1: criar o Bot e obter o token

<Steps>
  <Step title="Envie uma mensagem ao BotFather">
    Encontre o [@BotFather](https://t.me/BotFather) no Telegram e envie `/newbot`.
  </Step>
  <Step title="Dê um nome ao seu bot">
    Siga as instruções para fornecer um nome de exibição e um nome de usuário.
  </Step>
  <Step title="Copie o token">
    Após a criação, o BotFather retorna um token no formato `123456:ABC-DEF1234...`.
  </Step>
  <Step title="Cole no Verdent">
    Cole o token no campo **Bot Token** no painel de configuração do Verdent e confirme.
  </Step>
</Steps>

### Etapa 2: pareamento por mensagem

<Steps>
  <Step title="Envie uma mensagem">
    Abra seu novo bot no Telegram e envie qualquer mensagem (por exemplo, `hello`).
  </Step>
  <Step title="Receba o código de pareamento">
    O bot responde automaticamente com um código de pareamento.
  </Step>
  <Step title="Confirme no Verdent">
    Insira o código no painel do Verdent e confirme. A conexão está concluída.
  </Step>
</Steps>

---

## Configuração do Slack

### Etapa 1: criar o app do Slack e obter os tokens

<Steps>
  <Step title="Crie um novo app">
    Acesse [api.slack.com/apps](https://api.slack.com/apps) e clique em **Create New App**.
  </Step>
  <Step title="Use o manifesto fornecido">
    Escolha **From an app manifest** e cole o manifesto JSON fornecido pelo Verdent (há um botão de cópia disponível na interface).
  </Step>
  <Step title="Selecione um espaço de trabalho">
    Escolha o espaço de trabalho do Slack e crie o app.
  </Step>
  <Step title="Copie os dois tokens">
    Nas configurações do app, localize o **Bot Token** (`xoxb-`) e o **App Token** (`xapp-`) e cole ambos no painel de configuração do Verdent.
  </Step>
</Steps>

<Note>
  **Requisito do nome do app:** O nome deve ter menos de 80 caracteres e não pode conter caracteres chineses, japoneses ou coreanos.
</Note>

### Etapa 2: pareamento por mensagem

Igual ao Telegram: envie uma mensagem ao bot, receba o código de pareamento e insira-o no Verdent para concluir a conexão.

---

## Configuração do Feishu

O Feishu exige algumas etapas a mais do que o Telegram ou o Slack—as permissões são configuradas separadamente e os eventos precisam ser assinados manualmente. Não é complexo, mas cada etapa precisa ser feita corretamente, ou a conexão vai travar. Siga-as na ordem.

### Passo 1: criar um app personalizado

<Steps>
  <Step title="Abra o console do desenvolvedor">
    Acesse a [Feishu Open Platform](https://open.feishu.cn/app) e faça login com sua conta Feishu.
  </Step>
  <Step title="Crie um app personalizado">
    Clique em **Create Custom App** no canto superior direito.
  </Step>
  <Step title="Preencha as informações básicas">
    Insira o nome e a descrição do app e conclua a criação.
  </Step>
</Steps>

### Passo 2: configurar permissões

Abra o novo app e vá para **Permissions & Scopes** no menu à esquerda.

O Feishu permite importar escopos em massa, então você não precisa marcá-los um por um. Encontre a opção de importação/exportação em massa na página e cole o JSON a seguir na íntegra:

```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": []
  }
}
```

Após confirmar a importação, todos os escopos acima devem aparecer como selecionados na lista de permissões.

### Passo 3: obter as credenciais e conectar o Verdent

Abra **Credentials & Basic Info** no menu à esquerda:

<Steps>
  <Step title="Copie o App ID e o App Secret">
    Copie o **App ID** (no formato `cli_xxx...`) e o **App Secret**.
  </Step>
  <Step title="Cole no Verdent">
    Cole ambos os valores nos campos correspondentes do painel de configuração do Verdent.
  </Step>
  <Step title="Conecte">
    Clique em **Connect** para concluir a primeira etapa.
  </Step>
</Steps>

### Passo 4: ativar a conexão longa

Uma vez conectado, volte à Feishu Open Platform e abra **Events & Callbacks**.

Ative **Use Long Connection to Receive Events**. Essa chave controla como o Feishu entrega mensagens ao bot—a conexão longa não exige que você exponha uma URL pública; em vez disso, mantém uma conexão persistente, o que é mais confiável.

### Passo 5: assinar eventos de mensagem e publicar

Ainda na página **Events & Callbacks**:

<Steps>
  <Step title="Adicione o evento de mensagem">
    Clique em **Add Event**, depois pesquise e adicione `im.message.receive_v1` (evento Receive Message).
  </Step>
  <Step title="Crie e publique uma versão">
    Clique em **Create and Publish Version** no canto superior direito, preencha as notas da versão e confirme.
  </Step>
  <Step title="Pareie com o Verdent">
    Após publicar, volte ao Verdent e envie uma mensagem ao seu bot do Feishu para concluir o pareamento.
  </Step>
</Steps>

### O que cada permissão faz

| Permissão | Finalidade |
|------------|---------|
| Família `im:message:*` | Permite que o bot leia e envie mensagens, incluindo mensagens diretas e menções @ em grupos |
| `im:chat:*` | Lê a lista de conversas às quais o bot pertence |
| `im:resource` | Lê imagens, arquivos e outros recursos anexados às mensagens |
| `contact:*` | Lê informações básicas de contato para identificar quem enviou uma mensagem |
| `docs:document.content:read` / `wiki:wiki:readonly` | Lê o conteúdo do Feishu Docs e Wiki, para que os links de documentos possam ser passados ao Manager como contexto |
| `application:application:self_manage` | Gerencia a própria configuração do app; necessário para a capacidade de conexão longa |

---

## Após a conexão bem-sucedida

Uma vez pareado, o canal aparece na lista de canais da barra lateral esquerda do Manager e exibe:

- Ícone da plataforma e nome do canal
- Status da conexão (**Connected** / **Disconnected** / **Needs attention**)
- Prévia e carimbo de data/hora da mensagem mais recente
- Indicador de mensagem não lida (ponto verde)

A partir daí, cada mensagem enviada ao Bot é tratada diretamente pelo Manager como uma tarefa executável.

---

## Gerenciar canais conectados

- **Ver todos os canais** — todos os canais de mensagens instantâneas conectados são listados na barra lateral.
- **Excluir um canal** — passe o mouse sobre um canal e clique em excluir, depois confirme. Se for o último canal desse tipo, a configuração do bot também é apagada.
- **Reconectar** — se um canal exibir **Disconnected** ou **Needs attention**, um aviso de reparo aparece no topo para reconfiguração.

---

## Casos de uso

<CardGroup cols={3}>
  <Card title="Central de comando móvel" icon="mobile">
    Em movimento, diga ao bot no Telegram: "Implante as últimas alterações da branch main no staging." Quando você voltar, o resultado estará pronto.
  </Card>
  <Card title="Colaboração em equipe" icon="users">
    Mencione seu bot do Manager em um canal do Slack para resumir os status dos PRs de hoje—as respostas aparecem diretamente no canal para toda a equipe ver.
  </Card>
  <Card title="Captura rápida de ideias" icon="lightbulb">
    Antes de dormir, envie uma ideia ao bot e peça ao Manager para transformá-la em uma tarefa para a execução de amanhã.
  </Card>
</CardGroup>