# Oratrix API - Motivos

## Status

Documentacao parcial baseada na parte enviada para o projeto Wezapp Shots.

Este grupo trata motivos de encerramento do Oratrix. Para o Wezapp Shots, e recurso auxiliar para atendimento, tickets e relatorios futuros.

## Base URL

```text
https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}
```

## Autenticacao

```http
Authorization: Bearer {token}
```

## Endpoints do grupo

Total documentado nesta parte: 4 endpoints.

---

## 1. Listar motivos

```http
GET /listReasons
```

Nome na documentacao Oratrix:

```text
ListReasons
```

Descricao:

Listar motivos de encerramento disponiveis.

---

## 2. Criar motivo

```http
POST /createReason
```

Nome na documentacao Oratrix:

```text
CreateReason
```

Descricao:

Criar um novo motivo de encerramento.

URL completa:

```text
https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}/createReason
```

Body JSON:

```json
{
  "name": "Resolvido",
  "color": "#00C851"
}
```

---

## 3. Atualizar motivo

```http
POST /updateReason/:id
```

Nome na documentacao Oratrix:

```text
UpdateReason
```

Descricao:

Atualizar um motivo existente.

URL completa:

```text
https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}/updateReason/:id
```

Body JSON:

```json
{
  "name": "Resolvido (atualizado)",
  "color": "#00C851"
}
```

---

## 4. Excluir motivo

```http
POST /deleteReason/:id
```

Nome na documentacao Oratrix:

```text
DeleteReason
```

Descricao:

Excluir um motivo pelo ID.

URL completa:

```text
https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}/deleteReason/:id
```

Body JSON:

```json
{}
```

## Mapeamento sugerido com Wezapp Shots

| Wezapp Shots | Oratrix |
|---|---|
| Encerramento futuro de atendimento | Reason externo |
| Relatorio futuro de atendimento | Motivos de encerramento |
| Ticket externo | `reasonId` |

## Pendencias tecnicas para validar

- Confirmar formato de retorno de `/listReasons`.
- Confirmar se `color` aceita apenas HEX.
- Confirmar impacto de excluir motivo vinculado a tickets.
- Confirmar se motivos sao globais ou por canal/fila.

## Regras recomendadas para o Wezapp Shots

1. Nao usar motivos externos para controlar saldo ou status de campanha.
2. Usar apenas em fluxos de ticket/atendimento.
3. Proteger exclusao por permissao e auditoria.