API de Tarefas (To-Do List): Crie e Acompanhe Pendências

A lista de tarefas (To-Do List) do PanÐá Zap permite que agentes acompanhem pendências internas — ligações de retorno, follow-ups, checklists — associadas ou não a um atendimento. Use os endpoints abaixo para criar e sincronizar tarefas a partir de um sistema externo de produtividade ou automação. Todas as requisições exigem o cabeçalho Authorization: Bearer {BearerToken}.

Criar tarefa

POST https://{BaseUrl}/v2/api/external/{ApiID}/todo/create

{
  "name": "Ligar para cliente",
  "description": "Confirmar proposta",
  "owner": "João",
  "ownerId": 7,
  "status": "pending",
  "priority": "high"
}

Campo	Tipo	Obrigatório	Descrição
`name`	string	Sim	Título da tarefa.
`description`	string	Não	Detalhes adicionais sobre a tarefa.
`owner`	string	Não	Nome de exibição do responsável.
`ownerId`	integer	Não	ID do usuário responsável pela tarefa.
`status`	string	Não	Status inicial — por exemplo, `pending` ou `finished`.
`priority`	string	Não	Prioridade da tarefa — por exemplo, `low`, `medium` ou `high`.

Listar tarefas

GET https://{BaseUrl}/v2/api/external/{ApiID}/todo/list

Consultar histórico de tarefas por usuário

Retorna o log de alterações de tarefas atribuídas a um usuário específico — útil para auditoria de produtividade.

GET https://{BaseUrl}/v2/api/external/{ApiID}/todo/logs/{userId}

Parâmetro de Caminho	Tipo	Obrigatório	Descrição
`userId`	integer	Sim	ID do usuário cujo histórico de tarefas será consultado.

Atualizar tarefa

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

{ "status": "finished" }

Parâmetro	Tipo	Obrigatório	Descrição
`id` (caminho)	integer	Sim	ID da tarefa a atualizar.
`status`, `name`, `description`, `owner`, `ownerId`, `priority` (body)	—	Não	Aceita os mesmos campos de Criar tarefa — envie apenas os campos que deseja alterar.

Excluir tarefa

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

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

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 Tarefas (To-Do List): Crie e Acompanhe Pendências

Criar tarefa

Listar tarefas

Consultar histórico de tarefas por usuário

Atualizar tarefa

Excluir tarefa

Resposta Padrão

​Criar tarefa

​Listar tarefas

​Consultar histórico de tarefas por usuário

​Atualizar tarefa

​Excluir tarefa

​Resposta Padrão

Criar tarefa

Listar tarefas

Consultar histórico de tarefas por usuário

Atualizar tarefa

Excluir tarefa

Resposta Padrão