Pular para o conteúdo principal
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

Prazo (limitDate)

  • Só a data (AAAA-MM-DD, recomendado): tarefa para o dia, que só fica atrasada quando o dia acaba.
  • Data com hora (AAAA-MM-DD HH:mm, ou ISO 8601 com fuso, por exemplo 2026-12-15T14:30:00-03:00): tarefa com horário, que atrasa no horário. Sem fuso, vale o fuso horário do servidor.
  • O formato que a própria API devolve para tarefa do dia (por exemplo 2026-12-15T00:00:00.000Z) continua sendo tarefa para o dia, e todo prazo exatamente na meia-noite (00:00, com ou sem fuso) também vira tarefa para o dia. Para uma tarefa às 00:00, use 00:01.
  • Outros formatos são lidos pelo Date do JavaScript (com barra, a ordem é MM/DD/AAAA). Data ilegível: 400 ERR_INVALID_FIELD, com limitDate em field.

Lembrete (reminderMinutes)

  • Só vale para tarefa com hora (em tarefa para o dia, é ignorado) e só é enviado quando a tarefa tem ownerId: sem responsável não há a quem avisar.
  • Qualquer valor diferente de 0, 10, 30 e 60: 400 ERR_INVALID_FIELD, com reminderMinutes em field.

Responsável (ownerId)

  • 0, vazio ou ausente: tarefa sem responsável.
  • ID que não é de um usuário da sua empresa: a tarefa é criada sem responsável e a resposta traz ownerIgnored: true.

Vínculos (contactId e ticketId)

Os dois precisam existir na sua empresa, e o atendimento tem de ser do mesmo contato. Só com ticketId, o contato do atendimento também é ligado. Vínculo inválido: 400 ERR_INVALID_FIELD, com o nome do campo em field.

Resposta

A tarefa devolvida traz limitHasTime (true = prazo com horário), reminderMinutes e reminderAt.

Listar tarefas

Retorna todas as tarefas da sua conta, das mais recentes para as mais antigas. Esta rota não aceita filtros. Cada tarefa traz limitHasTime (true = prazo com horário; false = tarefa para o dia), reminderMinutes e reminderAt.

Listar tarefas criadas por um usuário

Retorna as tarefas criadas pelo usuário informado, das mais recentes para as mais antigas, em qualquer status. Cada item traz os dados da tarefa no mesmo formato de Listar tarefas.
Regras importantes:
  • O filtro é pelo criador da tarefa. Quem é só o responsável (ownerId) não entra: para as tarefas de um responsável, use Listar tarefas e filtre por ownerId do seu lado.
  • Tarefas criadas pela API têm como criador o usuário dono da API usada. Por isso, o userId desse usuário devolve as tarefas que a sua integração criou.
  • Mostra o estado atual de cada tarefa. Não é um histórico de alterações: mudanças de prazo, de responsável ou de status não ficam registradas.
  • userId que não é um número inteiro positivo: 400 ERR_INVALID_FIELD, com userId em field.

Atualizar tarefa

Regras ao atualizar:
  • limitDate, reminderMinutes e ownerId seguem as regras de Criar tarefa. Um ownerId que não é de um usuário da sua empresa deixa a tarefa sem responsável, e a resposta traz ownerIgnored: true.
  • Reenviar só o mesmo dia (sem hora) de uma tarefa com horário mantém o horário, e reenviar o limitDate devolvido pela API não muda nada.
  • Mudar o prazo para uma data ainda não vencida troca o status delayed (atrasada) por pending.
  • contactId e ticketId: null desvincula. O atendimento tem de ser do mesmo contato: ao trocar o contato, envie também o ticketId novo ou null. Vínculo inválido: 400 ERR_INVALID_FIELD, com o nome do campo em field.

Excluir tarefa

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

Resposta Padrão