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

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}.

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/carteira usada para segmentar contatos (veja kanban/kanbanId em Contatos e Tickets).

Criar coluna de kanban

POST https://{BaseUrl}/v2/api/external/{ApiID}/createKanban

{ "name": "Coluna 1" }

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

Listar colunas de kanban

GET https://{BaseUrl}/v2/api/external/{ApiID}/listKanban

Atualizar coluna de kanban

POST https://{BaseUrl}/v2/api/external/{ApiID}/updateKanban/{id}

{ "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

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).

Criar fila

POST https://{BaseUrl}/v2/api/external/{ApiID}/createQueueData

{ "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

POST https://{BaseUrl}/v2/api/external/{ApiID}/updateQueueData/{id}

{ "queue": "Suporte v2", "isActive": true }

Excluir fila

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).

Criar motivo

POST https://{BaseUrl}/v2/api/external/{ApiID}/createReason

{ "name": "Resolvido" }

Listar motivos

GET https://{BaseUrl}/v2/api/external/{ApiID}/listReasons

Atualizar motivo

POST https://{BaseUrl}/v2/api/external/{ApiID}/updateReason/{id}

{ "name": "Resolvido com sucesso" }

Excluir motivo

POST https://{BaseUrl}/v2/api/external/{ApiID}/deleteReason/{id}

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

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`.

Resposta Padrão

{
  "success": true,
  "data": { ... }
}

Primeiros Passos

Mensagens

Mensagens Interativas

Tickets e Contatos

Campanhas e CRM

Canais e Recursos

Organização e Produtividade

Dados e Relatórios

Administração da Plataforma

Webhooks e Eventos

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

Kanban

Criar coluna de kanban

Listar colunas de kanban

Atualizar coluna de kanban

Excluir coluna de kanban

Filas

Criar fila

Atualizar fila

Excluir fila

Motivos

Criar motivo

Listar motivos

Atualizar motivo

Excluir motivo

Tags

Criar tag

Atualizar tag

Excluir tag

Resposta Padrão

​Kanban

​Criar coluna de kanban

​Listar colunas de kanban

​Atualizar coluna de kanban

​Excluir coluna de kanban

​Filas

​Criar fila

​Atualizar fila

​Excluir fila

​Motivos

​Criar motivo

​Listar motivos

​Atualizar motivo

​Excluir motivo

​Tags

​Criar tag

​Atualizar tag

​Excluir tag

​Resposta Padrão

Kanban

Criar coluna de kanban

Listar colunas de kanban

Atualizar coluna de kanban

Excluir coluna de kanban

Filas

Criar fila

Atualizar fila

Excluir fila

Motivos

Criar motivo

Listar motivos

Atualizar motivo

Excluir motivo

Tags

Criar tag

Atualizar tag

Excluir tag

Resposta Padrão