# Oratrix API - WaVoIP e Chamadas

## Status

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

Este grupo trata chamadas WaVoIP e logs de chamadas do sistema. Para o Wezapp Shots, e recurso auxiliar/futuro, mais ligado a atendimento e auditoria de comunicacao do que ao disparo em massa.

## 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 chamadas WaVoIP

```http
GET /wavoip/calls
```

Nome na documentacao Oratrix:

```text
WavoipCallList
```

Descricao:

Listar chamadas WaVoIP do tenant.

URL completa:

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

Query params:

| Parametro | Obrigatorio | Descricao | Exemplo |
|---|---:|---|---|
| pageNumber | Sim | Numero da pagina | 1 |
| startDate | Nao | Data inicial | 2025-01-01 |
| endDate | Nao | Data final | 2025-01-31 |

---

## 2. Exibir chamada WaVoIP

```http
GET /wavoip/calls/:id
```

Nome na documentacao Oratrix:

```text
WavoipCallShow
```

Descricao:

Exibir dados de uma chamada WaVoIP pelo ID.

---

## 3. Listar logs de chamadas

```http
GET /callLog/list
```

Nome na documentacao Oratrix:

```text
CallLogList
```

Descricao:

Listar logs de chamadas do sistema.

URL completa:

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

Query params:

| Parametro | Obrigatorio | Descricao | Exemplo |
|---|---:|---|---|
| pageNumber | Sim | Numero da pagina | 1 |
| startDate | Nao | Data inicial | 2025-01-01 |
| endDate | Nao | Data final | 2025-01-31 |

---

## 4. Exibir log de chamada

```http
GET /callLog/show/:id
```

Nome na documentacao Oratrix:

```text
CallLogShow
```

Descricao:

Exibir dados de um log de chamada pelo ID.

## Mapeamento sugerido com Wezapp Shots

| Wezapp Shots | Oratrix |
|---|---|
| Atendimento telefonico futuro | WaVoIP/call logs |
| Auditoria de comunicacao | Logs de chamadas |
| Relatorio futuro | chamadas por periodo |

## Pendencias tecnicas para validar

- Confirmar formato de retorno de `/wavoip/calls`.
- Confirmar formato de retorno de `/wavoip/calls/:id`.
- Confirmar formato de retorno de `/callLog/list`.
- Confirmar formato de retorno de `/callLog/show/:id`.
- Confirmar campos disponiveis: duracao, status, usuario, canal, contato e gravacao.
- Confirmar se ha link de gravacao ou anexo de chamada.

## Regras recomendadas para o Wezapp Shots

1. Nao usar chamadas como metrica primaria de shots.
2. Tratar chamadas como recurso auxiliar de atendimento.
3. Registrar apenas referencias externas quando houver necessidade operacional.
4. Respeitar permissoes e privacidade caso chamadas tenham gravacao.