# Oratrix API - Tags CRUD

## Status

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

Este grupo trata criacao, atualizacao e exclusao de tags no Oratrix. Para o Wezapp Shots, tags podem ser auxiliares para segmentacao, atendimento ou conciliacao, mas nao devem substituir segmentacoes internas de campanha.

## 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 tag

```http
POST /createTag
```

Nome na documentacao Oratrix:

```text
CreateTag
```

Descricao:

Criar uma nova tag.

URL completa:

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

Body JSON:

```json
{
  "name": "Tag Nova",
  "color": "#FF5733",
  "isActive": true
}
```

---

## 2. Atualizar tag

```http
POST /updateTagData/:id
```

Nome na documentacao Oratrix:

```text
UpdateTagData
```

Descricao:

Atualizar dados de uma tag existente.

URL completa:

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

Body JSON:

```json
{
  "name": "Tag Atualizada",
  "color": "#33A1FF",
  "isActive": true
}
```

---

## 3. Excluir tag

```http
POST /deleteTag/:id
```

Nome na documentacao Oratrix:

```text
DeleteTag
```

Descricao:

Excluir uma tag pelo ID.

URL completa:

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

Body JSON:

```json
{}
```

## Mapeamento sugerido com Wezapp Shots

| Wezapp Shots | Oratrix |
|---|---|
| Segmentacao auxiliar futura | Tag externa |
| Filtros de contato externos | Tags do Oratrix |
| Ticket externo | Tags vinculadas a tickets |

## Pendencias tecnicas para validar

- Confirmar formato de retorno ao criar tag.
- Confirmar se `color` aceita apenas HEX.
- Confirmar se excluir tag remove vinculos com contatos/tickets.
- Confirmar se tags sao globais ou por canal/fila.
- Confirmar se tags inativas aparecem em listagens.

## Regras recomendadas para o Wezapp Shots

1. Nao depender de tags externas para segmentacao principal de campanha.
2. Usar tags externas apenas como apoio operacional.
3. Proteger exclusao por permissao e auditoria.
4. Registrar IDs externos se uma tag for criada pelo Wezapp.