> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Kanban, Filas, Motivos e Tags: Organize seu Atendimento

> Crie, atualize, liste e exclua colunas de kanban, filas de atendimento, motivos de encerramento e tags via API externa do PanÐá Zap.

Estes quatro tipos de entidade organizam o atendimento no PanÐá Zap: **Kanban** (carteiras/colunas usadas para segmentar contatos e tickets), **Filas** (departamentos que recebem tickets), **Motivos** (categorias de encerramento de ticket) e **Tags** (etiquetas livres aplicáveis a tickets e contatos). Use os endpoints abaixo para manter essas listas sincronizadas com um sistema de configuração externo.

Todas as requisições exigem o cabeçalho `Authorization: Bearer {BearerToken}`.

<Note>
  Para **listar** filas e tags, veja [Listagens Gerais](/api/listings#listar-filas) — os endpoints `listQueues` e `listTags` ficam nessa página. Esta página cobre criação, atualização e exclusão para as quatro entidades, além da listagem de kanban e motivos.
</Note>

***

## Kanban

Um registro de Kanban representa uma coluna/carteira usada para segmentar contatos (veja `kanban`/`kanbanId` em [Contatos](/api/contacts) e [Tickets](/api/tickets)).

### Criar coluna de kanban

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/createKanban
```

```json theme={null}
{ "name": "Coluna 1" }
```

| Campo  | Tipo   | Obrigatório | Descrição                             |
| ------ | ------ | ----------- | ------------------------------------- |
| `name` | string | Sim         | Nome de exibição da coluna de kanban. |

### Listar colunas de kanban

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listKanban
```

### Atualizar coluna de kanban

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/updateKanban/{id}
```

```json theme={null}
{ "name": "Coluna Atualizada" }
```

| Parâmetro      | Tipo    | Obrigatório | Descrição                           |
| -------------- | ------- | ----------- | ----------------------------------- |
| `id` (caminho) | integer | Sim         | ID da coluna de kanban a atualizar. |
| `name` (body)  | string  | Sim         | Novo nome da coluna.                |

### Excluir coluna de kanban

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/deleteKanban/{id}
```

Nenhum corpo de requisição é necessário.

***

## Filas

Uma fila representa um departamento ou equipe para o qual tickets podem ser roteados (veja `queueId` em [Tickets](/api/tickets)).

### Criar fila

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/createQueueData
```

```json theme={null}
{ "queue": "Suporte", "isActive": true }
```

| Campo      | Tipo    | Obrigatório | Descrição                                                                       |
| ---------- | ------- | ----------- | ------------------------------------------------------------------------------- |
| `queue`    | string  | Sim         | Nome de exibição da fila.                                                       |
| `isActive` | boolean | Não         | Define se a fila fica disponível para roteamento imediatamente. Padrão: `true`. |

### Atualizar fila

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/updateQueueData/{id}
```

```json theme={null}
{ "queue": "Suporte v2", "isActive": true }
```

### Excluir fila

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/deleteQueueData/{id}
```

Nenhum corpo de requisição é necessário.

***

## Motivos

Um motivo é uma categoria aplicada a um ticket, tipicamente no momento do encerramento (veja `reasonId` em [Criar ticket](/api/tickets#criar-ticket)).

### Criar motivo

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/createReason
```

```json theme={null}
{ "name": "Resolvido" }
```

### Listar motivos

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/listReasons
```

### Atualizar motivo

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/updateReason/{id}
```

```json theme={null}
{ "name": "Resolvido com sucesso" }
```

### Excluir motivo

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/deleteReason/{id}
```

Nenhum corpo de requisição é necessário.

***

## Tags

Uma tag é uma etiqueta livre aplicável a tickets ([Adicionar tag ao ticket](/api/tickets#adicionar-tag-ao-ticket)) e contatos ([Adicionar tag ao contato](/api/contacts#adicionar-tag-ao-contato)).

### Criar tag

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/createTag
```

```json theme={null}
{ "tag": "Urgente", "color": "#FF0000", "isActive": true }
```

| Campo      | Tipo    | Obrigatório | Descrição                                                               |
| ---------- | ------- | ----------- | ----------------------------------------------------------------------- |
| `tag`      | string  | Sim         | Nome de exibição da tag.                                                |
| `color`    | string  | Não         | Código de cor hexadecimal usado no badge da tag.                        |
| `isActive` | boolean | Não         | Define se a tag fica disponível para uso imediatamente. Padrão: `true`. |

### Atualizar tag

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/updateTagData/{id}
```

```json theme={null}
{ "tag": "Urgente v2", "color": "#CC0000" }
```

### Excluir tag

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/deleteTag/{id}
```

Nenhum corpo de requisição é necessário.

***

## Resposta Padrão

```json theme={null}
{
  "success": true,
  "data": { ... }
}
```