Chat Agent Gateway

Pare de construir integrações. Comece a conversar.

A Sois AI não expõe endpoints. Ela expõe um agente. Você diz a ele em linguagem natural o que precisa. O próprio agente da Sois lê sua mensagem, negocia os detalhes, age em todo o seu espaço de trabalho e responde quando termina.

Esta é a porta de entrada para quem chama sem uma IA própria: webhooks, scripts, sistemas legados e automações. Um único endpoint, linguagem natural, e o agente faz o raciocínio. Para quem chama sem agente, isso torna desnecessária uma API REST tradicional com muitos endpoints. Não há esquemas para aprender, nem mapeamentos de campos para manter, nem mudanças incompatíveis para perseguir. Apenas uma conversa entre o seu sistema e o nosso.

Já tem um agente de IA? Conecte-o diretamente pelo servidor MCP. Esse é o caminho estratégico: o seu próprio Claude, ChatGPT, Cursor ou Gemini raciocina sobre as ferramentas da Sois, então a Sois não gasta IA por você. O Chat Agent Gateway é para quem chama sem trazer o próprio agente.

Como funciona

You:    "Create a contact for Jane Doe, CEO of Acme Corp, [email protected]"
Agent:  Contact created. Added to workspace with company Acme Corp.

Uma mensagem de entrada. Um resultado de saída. O agente da Sois negocia tudo o que está no meio. Como o agente faz o raciocínio, esse caminho consome créditos de IA da Sois.

Três formas de receber a resposta

Método Ideal para
Webhook Defina uma response_url na sua chave. O agente entrega o resultado assinado quando termina. Fire and forget.
Polling Verifique o status da conversa a qualquer momento. Simples, sem infraestrutura necessária.
Ambos Webhooks como entrega principal, polling como reserva. Cinto e suspensório.

Início rápido

1. Obtenha suas credenciais nas Configurações do seu espaço de trabalho Sois AI

2. Envie uma mensagem

curl -X POST "https://your-workspace.sois.ai/api/agent" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Api-Key: sois_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Find all contacts from London"}'

3. Receba a resposta pelo seu webhook ou consultando a conversa

O que o agente pode fazer?

Tudo o que um usuário pode fazer dentro da Sois AI:

  • Pesquisar, criar, atualizar e excluir contatos
  • Gerenciar tarefas e atribuições
  • Redigir e enviar e-mails
  • Navegar e organizar arquivos e documentos
  • Consultar departamentos, equipes e membros
  • Trabalhar com qualquer extensão instalada
  • Combinar várias ações em uma única conversa

O agente não apenas lê os dados, ele age sobre eles. Peça a ele para "enviar a John o relatório do primeiro trimestre" e ele encontra o contato, localiza o documento, redige o e-mail e o envia. Sem orquestração.

De sistema para sistema

Quando os dois lados são inteligentes, eles negociam. Dois espaços de trabalho Sois AI, ou qualquer sistema agêntico, podem trocar dados pelo Chat Agent Gateway sem intervenção humana. Sem mapeamento de campos. Sem middleware. Sem conectores. Apenas dois agentes que se entendem.

Seu ERP fala com o seu CRM. Eles resolvem. Você recebe um resumo.

Governança: o que uma integração pode fazer

O gateway está sujeito à mesma governança de ferramentas que o assistente dentro do app. Cada ação que o agente possa realizar tem um de três modos, e uma chave de API nunca excede as permissões do usuário proprietário.

  • Sempre. Ações seguras (leituras, gravações de rotina) são executadas automaticamente.
  • Perguntar. Ações sensíveis (enviar e-mail, excluir registros, qualquer coisa que envolva dinheiro ou identidade) precisam da aprovação de uma pessoa. Como o gateway é um canal «fire-and-forget» sem ninguém olhando para uma tela, uma ação «perguntar» não é executada por padrão.
  • Negar. Bloqueada em todos os lugares, inclusive no gateway.

Para permitir que uma integração realize uma ação sensível específica sem supervisão, pré-autorize essa ação na chave (Configurações, Chaves de API, aprovação automática). É uma decisão única e auditada que você toma ao emitir a chave, como conceder um escopo a um app. Uma ação «perguntar» pré-autorizada passa então a ser executada automaticamente para essa chave; tudo o que não for pré-autorizado é recusado, e o agente informa que precisa de autorização em vez de fingir que agiu.

Cada ação recusada é informada a você, tanto na resposta do agente quanto de forma legível por máquina na carga do webhook em governance.tools_blocked (cada entrada traz a ação e o motivo: deny ou ask_unauthorised). Assim seu sistema vê exatamente o que foi e o que não foi feito.

Orçamento, não limites de taxa. Cada chave tem um orçamento em dólares: diário, mensal ou total. Você decide quanto vale cada integração. Sem cotas de solicitações arbitrárias. Quando o orçamento se esgota, o agente avisa com clareza.

Pronto? Leia a referência completa da interface Task para os formatos de requisição e webhook, ou traga o seu próprio agente pelo servidor MCP.