Pular para o conteúdo principal
Estes quatro tipos de entidade organizam o atendimento no PanÐá Zap: Kanban (colunas do Kanban de atendimento, usadas para segmentar contatos), 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}.
Para listar filas e tags, veja Listagens Gerais: 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.

Kanban

Um registro de Kanban representa uma coluna do Kanban de atendimento (o quadro de contatos do menu Kanban, diferente do Kanban do Funil de Vendas, que mostra oportunidades), usada para segmentar contatos (veja kanban/kanbanId em Contatos e Tickets).

Criar coluna de kanban

Esta rota não define cor: a coluna nasce sem cor, e a cor só pode ser ajustada pelo painel, em Configurações → CRM → Colunas (onde também se ajusta a ordem das colunas). Sem name, a rota responde 400 ERR_MISSING_FIELDS.

Listar colunas de kanban

Atualizar coluna de kanban

A cor atual é preservada: esta rota não altera a cor. Sem name, a rota responde 400 ERR_MISSING_FIELDS, mesmo quando a intenção é mudar só a position.

Excluir coluna de kanban

Nenhum corpo de requisição é necessário.
A exclusão não limpa os contatos que estavam na coluna: eles continuam com o ID dela gravado e somem do quadro do painel. Antes de excluir, mova esses contatos com Atualizar kanban do contato ou tire-os do quadro com Atualizar contato, enviando "kanban": null.

Filas

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

Criar fila

A fila nasce sem cor e vinculada ao usuário dono do token da API: cor e responsável não são definidos por esta rota.

Atualizar fila

Esta rota zera a cor da fila e refaz o vínculo dela com o usuário dono do token. Para preservar a cor, edite a fila pelo painel.

Excluir fila

Nenhum corpo de requisição é necessário.
Fila que já recebeu atendimento não é excluída: a rota responde 404 { "error": "ERR_QUEUE_TICKET_EXISTS" } (o código é 404, não 409). Mesmo depois de tirar os tickets da fila, a exclusão pode continuar recusada por causa do histórico de mensagens registrado com ela. Nesse caso, desative a fila com Atualizar fila enviando "isActive": false.

Motivos

Um motivo é uma categoria aplicada a um ticket, tipicamente no momento do encerramento (veja reasonId em Criar ticket).

Criar motivo

Esta rota não define cor: o motivo nasce sem cor, e a cor só pode ser ajustada pelo painel. Ao atualizar um motivo pela API, a cor atual é preservada.

Listar motivos

Atualizar motivo

Excluir motivo

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

Tags

Uma tag é uma etiqueta livre aplicável a tickets (Adicionar tag ao ticket) e contatos (Adicionar tag ao contato).

Criar tag

Erros:

Atualizar tag

O nome da tag vai no campo tag, como na criação. Erros:

Excluir tag

Nenhum corpo de requisição é necessário.
Tag aplicada a algum contato não é excluída: a rota responde 409 com a lista dos contatos que a usam, sem o campo success: { "message": "ERR_TAG_HAS_ASSIGNMENTS", "statusCode": 409, "contacts": [ { "id": 123, "name": "Maria", "number": "5511999999999" } ] }. Remova a tag desses contatos com Remover tag do contato e tente de novo.

Resposta Padrão

Nas listagens (listKanban, listReasons), data é uma lista e vem acompanhada de pagination.total. Nas exclusões, data traz deleted: true e o id excluído. Algumas recusas não seguem esse formato: veja os avisos de Excluir fila e Excluir tag.