Leve o contexto do seu negócio para os produtos e agentes que você constrói.

APIS DO SOCEO

As APIs do SOCEO conectam dados, fontes, permissões e ações em uma camada operacional que outras aplicações consultam com confiança.

Ver documentação Entender a plataforma

Documentação da API

FONTES E SISTEMAS Relacionamento com clientes Documentos Operação CAMADA OPERACIONAL Contexto Permissões Origem lacunas declaradas SOCEO API do SOCEO FRONTEIRA GOVERNADA O QUE VOCÊ CONSTRÓI Agentes Produtos Fluxos Origem preservada Identidade respeitada Resultado devolvido ao contexto EXPLORAR A API ↓

CONSTRUA SOBRE O CONTEXTO DO NEGÓCIO

Uma camada comum entre o que o negócio sabe e o que você quer construir.

As APIs do SOCEO começam no contexto operacional: o dado certo, dentro do escopo certo, com um caminho claro de volta à origem.

01 RESPOSTA CONTEXTUAL Pedidos Campanhas RESPOSTA Há relação entre queda de conversão e criativos antigos. 2 fontes 1 lacuna Contexto

Consulte informações relacionadas, preservando origem, atualização e permissões.

02 ESCOPO DE TRABALHO IA CONTEXTO DA MISSÃO Objetivo 6 fontes Permissões Sem acesso fora do escopo Agentes

Entregue aos agentes uma visão estruturada da operação, sem repetir o negócio inteiro em cada prompt.

03 EXECUÇÃO GOVERNADA 01 PROPOSTA Revisar campanha preparada 02 CHECKPOINT Aprovação humana aguardando 03 TRABALHO Dono + prazo controlado Fluxos e ações

Transforme respostas em trabalho controlado, com aprovação, dono, prazo e histórico quando necessário.

EXPERIÊNCIA PARA DESENVOLVEDORES

Uma interface feita para quem constrói.

Consulte contexto, preserve fontes e permissões e transforme respostas em ações controladas com uma interface consistente.

01 Consultar contexto 02 Criar uma ação 03 Acompanhar um resultado EXEMPLO DE INTEGRAÇÃO Copiar const leitura = await soceo.contexto.consultar({ identidade: "agente-campanhas", pergunta: "Qual mudança operacional merece atenção?", incluir: ["fontes", "permissoes", "lacunas"] });

return { resposta: leitura.contexto, fontes: leitura.fontes, lacunas: leitura.lacunas }; Resposta com fontes, permissões e lacunas API OPERACIONAL

DOCUMENTAÇÃO

Consulte contratos, referências e exemplos de integração.

Ver documentação OpenAPI + exemplos

CAPACIDADES DA API

Uma API para consultar, decidir e agir com contexto real.

Consulte o que o negócio sabe, preserve a origem de cada resposta e transforme contexto em trabalho controlado.

SOCEO API

TODOS OS SISTEMAS OPERACIONAIS

01 ENTRADA Endpoints POST /v1/context/query Consultar contexto

Pergunte sobre entidades, relações e acontecimentos do negócio.

GET /v1/sources/{id} Rastrear fontes

Volte à origem usada em qualquer resposta, decisão ou ação.

GET /v1/events Acompanhar eventos

Receba mudanças relevantes com histórico e contexto preservados.

POST /v1/actions Criar ações

Converta uma resposta em trabalho com dono, prazo e aprovação.

CORE SOCEO Context API OPERACIONAL Contexto Identidade Permissões Lacunas RESPOSTA Resposta estruturada 200 OK { "contexto": { ... }, "fontes": [ ... ], "lacunas": [ ... ], "proxima_acao": { ... } } Produtos Agentes Fluxos OpenAPI

Contratos, referências e exemplos de integração.

Autorização

Escopo aplicado à identidade de cada pessoa ou agente.

Observabilidade

Trilha completa entre consulta, fonte, ação e resultado.

SEGURANÇA E AUTORIDADE

Contexto útil sem tirar o negócio do comando.

A API é uma fronteira da plataforma. Ela não substitui as regras que definem quem pode ver, interpretar ou fazer alguma coisa.

REGRA CENTRAL Backend SOCEO Autoridade operacional Identidade recebida Regra aplicada Retorno autorizado 01 O backend é a autoridade

A interface solicita. As regras do negócio decidem o que pode ser consultado ou executado.

02 Pessoa e agente no mesmo perímetro

A identidade do agente respeita as permissões ligadas aos mesmos dados.

03 O resultado volta para o contexto

Resposta, decisão e ação retornam ao contexto para refletir o que realmente aconteceu.

04 Fontes acompanham respostas importantes

A origem continua navegável para revisão, explicação e contestação quando necessário.

05 Lacuna não vira certeza

Ausência, atraso ou conflito de dados deve aparecer como limite, nunca como conclusão inventada.

06 Ações sensíveis podem parar no humano

Aprovação, dono e escopo podem ser exigidos antes que uma ação deixe de ser proposta e vire trabalho.

pedido → regra aplicada → resposta ou ação autorizada

PERGUNTAS FREQUENTES

Tudo o que você precisa para começar. Entender a plataforma 01 Como começo a usar as APIs do SOCEO?

Acesse a documentação, crie sua chave e escolha o workspace cujo contexto sua aplicação vai consultar.

02 O que posso construir? 03 Como o SOCEO protege permissões e fontes? 04 Onde encontro a documentação? 05 Posso conectar agentes às APIs?

APIS DO SOCEO

Construa sobre um negócio que a IA consegue entender.

Consulte a documentação, conecte sua aplicação e construa com o contexto real do negócio.

Ver documentação Falar com o time Documentação, referências e exemplos de integração