DingTalk — IA para Locais de Trabalho Chineses

Imagine entrar em um escritório em Xangai onde as conversas de corredor acontecem dentro de um ícone de aplicativo azul brilhante — o DingTalk. É parte Slack, parte Trello, parte portal de RH e, para centenas de milhões de usuários, ele é o ambiente de trabalho. Agora imagine seu agente de IA, o Hermes, vivendo silenciosamente dentro desse aplicativo — respondendo perguntas, triando tarefas e disparando follow-ups sem nunca sair da conversa. Essa é a promessa da integração com DingTalk no Hermes Agent.

Por que o DingTalk é importante para agentes de IA

A maioria dos tutoriais de agentes de IA assume ferramentas ocidentais e falantes de inglês. Mas na China, o DingTalk é o sistema operacional padrão para comunicação empresarial. Se você está construindo um agente open-source para uma equipe em Shenzhen ou uma fábrica em Chengdu, você precisa de uma ponte nativa. O Hermes Agent agora oferece exatamente isso — uma integração limpa e orientada por configuração que transforma qualquer grupo do DingTalk em um centro de comando para o seu agente.

Configurando o bot do DingTalk

Você tem dois caminhos: webhook (mais simples, unidirecional) ou callback (full duplex, recebe mensagens). Para um assistente de verdade, você vai querer o callback. Veja o fluxo:

1. Crie um bot no Console de Desenvolvedor do DingTalk.
2. Obtenha seu AppKey e AppSecret.
3. Configure uma URL de callback pública (HTTPS obrigatório) para mensagens recebidas.
4. Configure o webhook de saída do bot para as respostas.

No Hermes, você define isso no config.yaml:

channels:
  dingtalk:
    enabled: true
    mode: callback          # ou "webhook" para alertas unidirecionais
    app_key: "your_app_key"
    app_secret: "your_app_secret"
    callback_url: "https://your-server.com/dingtalk/callback"
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx"  # para respostas
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

Recebendo mensagens

Assim que a URL de callback estiver ativa, o DingTalk envia cada mensagem de grupo para o Hermes. O agente analisa o payload JSON, extrai o remetente, o ID da conversa e o texto, e então roteia para o seu pipeline de skills. Você pode filtrar por palavra-chave, menção ou até grupos específicos. Por exemplo, responder apenas quando o bot for mencionado com @:

channels:
  dingtalk:
    filters:
      require_mention: true
      allow_groups:
        - "ops-alerts"
        - "ai-assistant"

Enviando respostas

As respostas voltam pela URL do webhook. O Hermes automaticamente envolve a resposta no formato de mensagem correto do DingTalk — texto puro, markdown ou cards interativos. Aqui está uma skill mínima que responde com uma saudação:

@agent.skill
async def greet(ctx, text):
    return f"Hello from Hermes! You said: {text}"

Sem chamadas HTTP manuais. O Hermes cuida da assinatura, timestamp e do envelope JSON para você.

Resumo

A integração com o DingTalk transforma o Hermes de um brinquedo de terminal em um cidadão do ambiente de trabalho para equipes chinesas. Com algumas linhas no config.yaml, você obtém mensagens bidirecionais, filtro por menção e formatação automática de respostas. Seja criando um bot de QA para o chão de fábrica ou um assistente pessoal para um gerente ocupado, Hermes + DingTalk significa que sua IA fala a língua do escritório chinês moderno — fluentemente, de forma confiável e sem um único caractere chinês no seu código.

---