# Mensagens instantâneas (/pt/docs/verdent-manager/core-features/instant-messaging)

> 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 [#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 [#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 [#como-acessar-a-configuração]

<Steps>
  <Step title="Abrir Add Channel">
    Na barra lateral esquerda do Manager, clique no botão &#x2A;*+** 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 [#configuração-do-telegram]

### Etapa 1: criar o Bot e obter o token [#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 [#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 [#configuração-do-slack]

### Etapa 1: criar o app do Slack e obter os tokens [#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 [#etapa-2-pareamento-por-mensagem-1]

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