Conectar o Feishu ao Elisi Agent

Conecte um bot do Feishu ao Elisi Agent

Depois da configuração, você pode conversar em particular com o bot da sua empresa no Feishu e pedir ao Elisi Agent para registrar ou localizar tarefas, listas e outros itens.

Antes de começar

Você precisa de:

Uma conta do Elisi.
Permissão para criar e publicar um app personalizado do Feishu.
Aprovação do administrador da empresa para as permissões do app, se necessário.

1. Crie um app do Feishu

Abra a plataforma aberta do Feishu e acesse o console de desenvolvedores.
Crie um app empresarial personalizado.
Em Adicionar recursos ao app, ative Bot.
Em Permissões, adicione:
- Ler mensagens privadas que os usuários enviam ao bot.
- Enviar mensagens como o app.
- Para usar o bot em grupos, adicione também a permissão para receber mensagens que mencionem o bot.

Guarde o App ID e o App Secret.

2. Conecte o bot no Elisi

Abra Configurações no Elisi.
Em Elisi AI, selecione Bot do Feishu / Lark.
Escolha Feishu como plataforma. Se usa o serviço internacional Lark, escolha Lark.
Informe um nome opcional para o bot, o App ID, o App Secret e o Verification Token exibido no console do Feishu.
Selecione Conectar bot.

Após a verificação, o Elisi mostra:

Uma URL de callback de eventos.
Um comando de uso único para vincular a conta.

O App Secret aparece apenas uma vez. O Elisi o armazena criptografado e não o envia ao Agent.

3. Configure callbacks de eventos

Volte à plataforma aberta do Feishu:

Abra Eventos e callbacks ou Inscrições de eventos.
Selecione Enviar eventos para um servidor de desenvolvedor.
Copie a URL de callback de eventos exibida no Elisi e cole-a como URL da solicitação.
Deixe Encrypt Key em branco.
Salve a URL e aguarde a confirmação do Feishu.

Selecione Adicionar evento e inclua:

Receber mensagens (im.message.receive_v1)

A verificação da URL não é suficiente; também é preciso adicionar im.message.receive_v1.

4. Publique e instale o app

Crie uma nova versão na plataforma aberta do Feishu.
Confirme que ela inclui as permissões e o evento recém-adicionados.
Envie para análise e publique. Se necessário, obtenha primeiro a aprovação do administrador.
Instale o app na empresa e confirme que sua conta do Feishu está no escopo de usuários disponíveis.

Depois de alterar permissões ou eventos, publique uma nova versão para que as mudanças entrem em vigor.

5. Vincule sua conta do Elisi

A configuração e publicação podem levar mais de 15 minutos. Depois da publicação, volte ao Elisi:

No cartão do bot, selecione Gerar novo código de vinculação.
Copie o comando de uso único completo, por exemplo:
```
/elisi-bind AbCdEf123
```
Em até 15 minutos, abra uma conversa privada com o bot e envie o comando.
Depois da mensagem de sucesso, volte ao Elisi e atualize o status.

A configuração está concluída quando o status mudar de Aguardando vinculação para Conectado. A primeira vinculação deve ocorrer em uma conversa privada, não em um grupo.

6. Use o bot

Conversa privada: Envie texto diretamente ao bot.
Conversa em grupo: Um usuário vinculado precisa mencionar o bot na mensagem.
Desconectar: Selecione Desconectar no cartão do bot no Elisi.

A versão atual aceita mensagens de texto. Ela não aceita callbacks criptografados com Encrypt Key, anexos, cartões interativos ou o compartilhamento de uma conta do Elisi entre várias pessoas.

Solução de problemas

Problema	O que verificar
A verificação da URL falha ou não retorna challenge	Confirme a URL completa e se o `Verification Token` corresponde. Apague `Encrypt Key` e salve novamente.
A URL é verificada, mas o bot não responde em uma conversa privada	Confira se `im.message.receive_v1` foi adicionado. Depois de adicionar eventos e permissões, publique, aprove e instale novamente a versão mais recente.
O Elisi continua mostrando “Aguardando vinculação”	Gere outro código e envie o comando completo em uma conversa privada dentro de 15 minutos. Os códigos antigos expiram.
A conta foi vinculada, mas o bot não responde	Confira se a permissão para enviar mensagens como app foi aprovada e incluída na versão publicada mais recente.
O bot não responde em um grupo	Primeiro vincule a conta em uma conversa privada. Depois, um usuário vinculado deve mencionar o bot no grupo.
Não é possível encontrar ou enviar mensagem ao bot	Confirme que o app está instalado e que sua conta está no escopo de usuários disponível.

Se o problema continuar, confira em Registros de envio de eventos na plataforma aberta do Feishu se im.message.receive_v1 aparece. Se não houver registro, o evento, as permissões, a versão publicada ou o escopo do app talvez ainda não estejam ativos.