Elohia

Documentação

Integrações

Como a Elohia se conecta ao restante da sua stack — canais de mensagem, MCPs, webhooks e SDK.

7 min de leitura

Canais de mensagem

Canais são onde seu cliente ou seu time encontra o agente. Cada agente pode atender em um ou vários canais simultaneamente. Os canais oficiais hoje incluem WhatsApp, Instagram DM, Meta/Google Ads, Slack, Telegram, Discord, e-mail, voz e web chat. Canais adicionais podem ser conectados via MCP.

MCPs

MCPs (Model Context Protocol) são a forma oficial de dar ao agente acesso a sistemas externos — CRMs, bancos de dados, APIs internas, observabilidade. A Elohia disponibiliza um conjunto verificado e permite que você configure os seus. Consulte a doc de MCP para detalhes do protocolo.

Importante: o seu plano define quais comandos e pacotes são aceitos na configuração de MCP. A policy filtra tudo que foge do allowlist antes de escrever .mcp.json — e você ve no log o motivo da rejeicao.

Integrações mais comuns no onboarding

  • GitHub + GitHub Actions (revisão de PR, triagem de issues)
  • Jira / Linear (refinamento de ticket, pre-sprint)
  • Slack / Microsoft Teams (chat, aprovação humana)
  • Postgres / MongoDB (consulta read-only ou restrita)
  • Datadog / Grafana (diagnostico de incidentes)
  • Zendesk / Freshdesk (atendimento)
  • HubSpot / Pipedrive (CRM)

Webhooks

Cada agente pode receber eventos por HTTP — utilize quando o sistema de origem não tem MCP ou quando você prefere um gatilho push. A configuração vive em <slug>__webhooks e os eventos em <slug>__webhook_events (TTL de 90 dias para o histórico).

  • authMode: "hmac" ou "token" — assinatura validada antes do evento entrar na fila
  • mode: "sync" (resposta inline) ou "async" (webhook dispara job, responde depois)
  • rateLimit: maxPerMinute e maxPerHour por webhook, avaliados no tenant
  • filters.headers: conjunto de headers obrigatorios para aceitar o payload

API / SDK

Tudo o que a UI faz esta disponível via REST em /v1 (alias /api). Você pode automatizar criação de agentes, invocacoes e gestão de skills a partir do seu pipeline de CI/CD ou de um app próprio. O JWT obtido no login e o único token necessário e já leva o tenant no claim tslug.