Pré-requisitos
- Uma conta no DingTalk com acesso de administrador empresarial
- Uma instância Claw (crie uma aqui)
Guia de Configuração
Criar um App no DingTalk
- Acesse a DingTalk Open Platform
- Clique em Application Development → Enterprise Internal Development
- Clique em Create Application
- Insira um nome e descrição para o app
- Clique em Confirm
Ativar a Funcionalidade de Robô
- No seu app, vá em App Features → Robot
- Ative a configuração do robô
- Selecione Stream Mode (recomendado — nenhuma URL pública é necessária)
- Clique em Publish
Publicar o App
- Vá em Version Management
- Crie uma nova versão (no mínimo uma versão de teste)
- Defina o alcance de visibilidade (quais usuários/departamentos podem ver o bot)
- Envie e publique
Configurar no Painel da LemonData
- Vá para o seu Claw Dashboard
- Clique no ícone de configurações na sua instância
- Abra a aba IM Integrations
- Expanda a seção DingTalk
- Cole seu AppKey e AppSecret
- Clique em Save
Configurações de Grupo
Configure o comportamento do chat em grupo na aba IM Integrations do seu Dashboard:| Configuração | Opções | Descrição |
|---|---|---|
| Group Policy | Open (padrão) / Allowlist / Disabled | Controla quem pode acionar o bot em grupos |
| Group Allowed Users | Lista de IDs de usuário | Apenas estes usuários podem acionar o bot (modo allowlist) |
O DingTalk sempre exige @menção para acionar o bot em grupos — esta é uma limitação da plataforma e não pode ser configurada. A filtragem por IDs de Grupo não está disponível para o DingTalk; use a configuração Group Policy para controlar o acesso.
Solução de Problemas
O bot não responde
O bot não responde
- Verifique se o AppKey e o AppSecret estão corretos
- Verifique se o app está publicado (pelo menos a versão de teste)
- Certifique-se de que o Stream Mode está selecionado na configuração do robô
- Verifique se o bot está visível para sua conta de usuário
A conexão cai frequentemente
A conexão cai frequentemente
- O modo Stream mantém uma conexão WebSocket persistente
- Desconexões breves são normais — o bot irá se reconectar automaticamente
- Se persistir, tente reiniciar a instância a partir do dashboard