# Oratrix API - Filas CRUD

## Status

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

Este grupo trata filas de atendimento do Oratrix. Para o Wezapp Shots, e um recurso auxiliar, principalmente se campanhas criarem tickets ou encaminharem respostas para atendimento.

## 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: 3 endpoints.

---

## 1. Criar fila de atendimento

```http
POST /createQueueData
```

Nome na documentacao Oratrix:

```text
CreateQueueData
```

Descricao:

Criar uma nova fila de atendimento.

URL completa:

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

Body JSON:

```json
{
  "name": "Fila Suporte",
  "color": "#4A90E2",
  "greetingMessage": "Ola! Como posso ajudar?",
  "userId": null
}
```

---

## 2. Atualizar fila de atendimento

```http
POST /updateQueueData/:id
```

Nome na documentacao Oratrix:

```text
UpdateQueueData
```

Descricao:

Atualizar uma fila de atendimento existente.

URL completa:

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

Body JSON:

```json
{
  "name": "Fila Suporte Atualizada",
  "color": "#E24A4A",
  "greetingMessage": "Ola! Aguarde um momento.",
  "userId": 1
}
```

---

## 3. Excluir fila de atendimento

```http
POST /deleteQueueData/:id
```

Nome na documentacao Oratrix:

```text
DeleteQueueData
```

Descricao:

Excluir uma fila de atendimento pelo ID.

URL completa:

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

Body JSON:

```json
{}
```

## Mapeamento sugerido com Wezapp Shots

| Wezapp Shots | Oratrix |
|---|---|
| Fluxo futuro de atendimento | Queue no Oratrix |
| Campanhas que criam tickets | Possivel fila destino |
| Respostas de campanha | Possivel encaminhamento para fila |

## Pendencias tecnicas para validar

- Confirmar se existe endpoint de listagem de filas neste grupo ou em outro grupo.
- Confirmar formato de retorno ao criar fila.
- Confirmar se `userId` define responsavel, atendente ou proprietario da fila.
- Confirmar impacto de excluir fila com tickets vinculados.
- Confirmar se `color` aceita apenas HEX.

## Regras recomendadas para o Wezapp Shots

1. Nao depender de filas externas para controlar disparos.
2. Usar filas apenas quando houver criacao de tickets ou atendimento posterior.
3. Proteger exclusao de fila por permissao alta.
4. Registrar auditoria local quando o Wezapp acionar criacao, edicao ou exclusao de fila externa.