A API de IA por trás de cada agente SuperCognit
Uma API REST para criares agentes e servidores MCP, associares ferramentas e conhecimento, leres todas as conversas e enviares eventos para os teus sistemas. OpenAPI 3.1, autenticação por chave, sem SDK.
https://api.supercognit.com/v1A tua primeira chamada
Qualquer cliente HTTP serve — curl, o teu backend, uma ferramenta de automação ou outro agente.
curl https://api.supercognit.com/v1/products \
-H "X-Api-Key: $SUPERCOGNIT_API_KEY"Autentica-te com uma chave da área de trabalho
Cria uma chave no painel e envia-a no cabeçalho X-Api-Key. As chaves têm âmbito de leitura ou escrita e podem ficar limitadas a um único produto — assim, uma integração só toca naquilo que lhe deste.
O que a API cobre
O que fazes no painel, o teu código também faz — a mesma área de trabalho, os mesmos recursos.
Produtos
/v1/productsCria, atualiza, publica e despublica agentes de chat e servidores MCP — prompt, resumo, slug e preço incluídos.
Ferramentas
/v1/toolsGere a biblioteca de ferramentas da área de trabalho: ferramentas LLM, HTTP e estáticas, os seus inputs e que produtos as usam.
Bases de conhecimento
/v1/knowledge-basesLista o conhecimento que sustenta as respostas e vê a que produtos cada base está associada.
Conversas
/v1/sessionsLê conversas e transcrições completas — cada mensagem, modelo e contagem de tokens, prontos para a tua analítica ou o teu CRM.
Webhooks
/v1/webhooksRegista endpoints, vê entregas e tentativas e reativa um endpoint sem abrir o painel.
Carteira
/v1/walletConsulta o saldo de créditos de utilização e cada carregamento, débito e reembolso.
Utilizadores finais
/v1/verify-userValida um token de sessão do lado do servidor, para a tua aplicação saber com quem está a falar.
O que as equipas constroem com ela
Um agente por cliente
Agências e equipas de SaaS criam, configuram e publicam um agente por cliente a partir do seu próprio onboarding — sem passar pelo painel.
Conversas no teu CRM
Envia cada conversa e cada contacto captado para o HubSpot, o Salesforce ou a tua base de dados, à medida que acontecem.
Conhecimento sempre atual
Atualiza uma fonte de conhecimento quando a documentação muda, para que as respostas acompanhem o produto em vez de ficarem para trás.
Utilização que podes faturar
Lê a carteira e as transcrições para saberes exatamente o que uma conta consumiu e cobra por isso dentro do teu produto.
Eventos, enviados para ti
Regista um endpoint e a SuperCognit envia JSON por POST à medida que as conversas acontecem. Cada pedido é assinado com HMAC-SHA256 sobre o corpo original, repetido até cinco vezes com recuo exponencial e guardado num registo de entregas com o estado da resposta.
- conversation.created — alguém iniciou uma nova conversa
- message.created — foi enviada uma mensagem, por um visitante ou pelo agente
- message.completed — o agente terminou a resposta
REST para os teus sistemas, MCP para clientes de IA
A API é a forma de o teu código comandar a SuperCognit. O MCP é a forma de os clientes de IA — Claude, Cursor, os teus próprios agentes — usarem o que publicas. Ambos correm sobre a mesma área de trabalho, por isso uma ferramenta construída uma vez fica acessível dos dois lados.
Ver servidores MCP →Perguntas de quem programa
Sim. Todos os planos incluem acesso à API sem custo adicional — pagas o plano e a utilização que os teus agentes geram, tal como aconteceria a partir do painel. O teste gratuito de 7 dias também a inclui.
Com uma chave de API da área de trabalho, enviada no cabeçalho X-Api-Key. As chaves declaram âmbitos — é preciso escrita para tudo o que não seja um GET — e uma chave pode ficar limitada a um único produto, caso em que não toca em recursos da área de trabalho como ferramentas, bases de conhecimento ou webhooks.
Não. É REST sobre JSON, por isso qualquer cliente HTTP serve. O documento OpenAPI 3.1 é público, o que também te permite gerar um cliente tipado na linguagem que preferires em poucos minutos.
Sim. Cria o produto, associa ferramentas e bases de conhecimento e publica-o — o mesmo ciclo que o painel usa. É assim que as equipas provisionam automaticamente um agente por cliente.
A plataforma corre um modelo curado por trás dos teus agentes, por isso a tua integração nunca lida com chaves de fornecedores nem nomes de modelos. Tu constróis e lanças o agente; nós mantemos o modelo atualizado por baixo.
De duas formas: lendo os endpoints de conversas para sessões e transcrições, ou registando um webhook e recebendo cada mensagem no momento em que acontece. A maioria das equipas usa webhooks para tempo real e os endpoints para histórico.
Constrói com a API
Cria uma área de trabalho, gera uma chave e lança a tua integração — grátis durante 7 dias.