# Gerar sumarização de atendimentos

**POST /transformersapi/1.0/text_summarization/{hostname}/{document}**

| Campo | Obrigatório | Descrição |
|-------|-------------|-----------|
| provider | Sim | Provider de LLM: `OpenAI`, `IAN`, `AWS` |
| model | Sim | Identificador do modelo a ser utilizado |
| token | Sim | Objeto com `access_key`, `secret_key` e `token` |
| query | Não | Filtros da busca histórica. Aceita os seguintes formatos:<br><br><ul><li><strong>String:</strong> Busca por um termo exato (ex: <code>"CTE = 30237"</code>).</li><li><strong>Array de Strings:</strong> Busca por múltiplos termos simultâneos (ex: <code>["CTE = 30237", "CTE = 30238"]</code>).</li><li><strong>Objeto:</strong> Filtros estruturados <code>start_period</code>, <code>finished_period</code> e <code>size</code>.<br><br>Os campos de data devem seguir o padrão <code>YYYY-MM-DD</code>, por exemplo:<br><code>"start_period": "2026-04-01"</code><br><code>"finished_period": "2026-05-01"</code><br><br>Para o campo <code>size</code>, o limite máximo é <strong>1000</strong> e o padrão é <strong>100</strong>.</li></ul> |
| prompt | Não | Prompt para orientar a sumarização. Se omitido, usa prompt padrão |
| include_user_chat_history | Não | `true` usa histórico consolidado; `false` busca histórico bruto no banco (padrão: `true`) |


## Servers
- Ambiente de Produção: https://api.neppo.com.br (Ambiente de Produção)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **hostname** (string)
  Hostname do ambiente do cliente

- **document** (string)
  Documento do cliente (CPF, telefone ou e-mail)



### Body: application/json (object)

- **provider** (string)

- **model** (string)

- **token** (array[object])

- **prompt** (string)

- **include_user_chat_history** (boolean)

- **query** (object)



## Responses
### 200
Requisição processada com sucesso. Retorna os dados correspondentes ao filtro informado.

#### Body: application/json (object)
- **provider** (string)

- **model** (string)

- **summary** (string)

- **token_usage** (object)


### 400
Requisição inválida. Verifique a sintaxe do corpo e os campos obrigatórios.

#### Body: application/json (object)
- **detail** (string)


### 401
Token de autenticação ausente ou inválido. Envie o header `Authorization: Bearer {token}`.

#### Body: application/json (object)
- **status** (string)


### 406
Formato de requisição não aceito. Verifique os cabeçalhos `Content-Type`/`Accept`.

#### Body: application/json (object)
- **detail** (string)


### 500
Erro interno no servidor. Tente novamente mais tarde ou contate o suporte Neppo.

#### Body: application/json (object)
- **detail** (string)



[Powered by Bump.sh](https://bump.sh)