> ## Documentation Index
> Fetch the complete documentation index at: https://quintus.tec.br/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> API para uso com sessões de agentes ou execuções únicas em integrações diversas.

## O que é

Esta API foi desenhada para uso com sessões de agentes ou execuções únicas em integrações como N8N, Make, sistemas internos, CRMs, ERPs e outras automações.

## Quando usar

* N8N;
* Make;
* sistemas internos;
* automações em CRM;
* triagem e enriquecimento em helpdesk;
* copilotos internos;
* fluxos operacionais em ERP;
* jobs assíncronos e orquestrações server-to-server.

## Como funciona

1. Sua aplicação autentica com `X-API-Key`.
2. Opcionalmente cria ou identifica um usuário.
3. Cria uma sessão ou usa `run` para uma execução direta.
4. Envia mensagens, consulta histórico, reutiliza arquivos e encerra a sessão quando necessário.

## Recursos principais

* Usuários: CRUD de usuários finais do tenant.
* Sessões: criação, consulta e encerramento.
* Mensagens: envio síncrono, streaming e histórico.
* Arquivos: upload e reutilização no tenant.
* Runs: execução única sem precisar montar o fluxo completo de sessão.