Verdent Docs
Principais recursos

Mensagens instantâneas

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

PlataformaTipo
TelegramBot pessoal
SlackBot de espaço de trabalho
FeishuBot 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

Abrir Add Channel

Na barra lateral esquerda do Manager, clique no botão + no topo (Add Channel).

Selecionar uma plataforma

Escolha a plataforma que deseja conectar (Telegram, Slack ou Feishu).

Siga as etapas guiadas

Conclua a configuração de duas etapas no painel lateral.


Configuração do Telegram

Etapa 1: criar o Bot e obter o token

Envie uma mensagem ao BotFather

Encontre o @BotFather no Telegram e envie /newbot.

Dê um nome ao seu bot

Siga as instruções para fornecer um nome de exibição e um nome de usuário.

Copie o token

Após a criação, o BotFather retorna um token no formato 123456:ABC-DEF1234....

Cole no Verdent

Cole o token no campo Bot Token no painel de configuração do Verdent e confirme.

Etapa 2: pareamento por mensagem

Envie uma mensagem

Abra seu novo bot no Telegram e envie qualquer mensagem (por exemplo, hello).

Receba o código de pareamento

O bot responde automaticamente com um código de pareamento.

Confirme no Verdent

Insira o código no painel do Verdent e confirme. A conexão está concluída.


Configuração do Slack

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

Crie um novo app

Acesse api.slack.com/apps e clique em Create New App.

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

Selecione um espaço de trabalho

Escolha o espaço de trabalho do Slack e crie o app.

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.

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

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

Abra o console do desenvolvedor

Acesse a Feishu Open Platform e faça login com sua conta Feishu.

Crie um app personalizado

Clique em Create Custom App no canto superior direito.

Preencha as informações básicas

Insira o nome e a descrição do app e conclua a criação.

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:

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

Copie o App ID e o App Secret

Copie o App ID (no formato cli_xxx...) e o App Secret.

Cole no Verdent

Cole ambos os valores nos campos correspondentes do painel de configuração do Verdent.

Conecte

Clique em Connect para concluir a primeira etapa.

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:

Adicione o evento de mensagem

Clique em Add Event, depois pesquise e adicione im.message.receive_v1 (evento Receive Message).

Crie e publique uma versão

Clique em Create and Publish Version no canto superior direito, preencha as notas da versão e confirme.

Pareie com o Verdent

Após publicar, volte ao Verdent e envie uma mensagem ao seu bot do Feishu para concluir o pareamento.

O que cada permissão faz

PermissãoFinalidade
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:resourceLê 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:readonlyLê o conteúdo do Feishu Docs e Wiki, para que os links de documentos possam ser passados ao Manager como contexto
application:application:self_manageGerencia 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

Central de comando móvel

Em movimento, diga ao bot no Telegram: "Implante as últimas alterações da branch main no staging." Quando você voltar, o resultado estará pronto.

Colaboração em equipe

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.

Captura rápida de ideias

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