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 exemplo2026-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
Datedo JavaScript (com barra, a ordem é MM/DD/AAAA). Data ilegível: 400ERR_INVALID_FIELD, comlimitDateemfield.
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,30e60: 400ERR_INVALID_FIELD, comreminderMinutesemfield.
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 trazlimitHasTime (true = prazo com horário), reminderMinutes e reminderAt.
Listar tarefas
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 porownerIddo seu lado. - Tarefas criadas pela API têm como criador o usuário dono da API usada. Por isso, o
userIddesse 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.
userIdque não é um número inteiro positivo: 400ERR_INVALID_FIELD, comuserIdemfield.
Atualizar tarefa
Regras ao atualizar:
limitDate,reminderMinuteseownerIdseguem as regras de Criar tarefa. UmownerIdque não é de um usuário da sua empresa deixa a tarefa sem responsável, e a resposta trazownerIgnored: true.- Reenviar só o mesmo dia (sem hora) de uma tarefa com horário mantém o horário, e reenviar o
limitDatedevolvido pela API não muda nada. - Mudar o prazo para uma data ainda não vencida troca o status
delayed(atrasada) porpending. contactIdeticketId:nulldesvincula. O atendimento tem de ser do mesmo contato: ao trocar o contato, envie também oticketIdnovo ounull. Vínculo inválido: 400ERR_INVALID_FIELD, com o nome do campo emfield.

