Visão geral

Notas do ticket

Notas, respostas e encaminhamentos registrados em um ticket. Toda requisição exige o cabeçalho Authorization: Bearer <chave de API>.

O ticket da rota é sempre resolvido na empresa da chave antes de qualquer outra verificação: um ticket de outra empresa, ou inexistente, responde 404 not_found, e uma nota que não pertence ao ticket da rota responde o mesmo.

Toda nota escrita por aqui nasce com origem API e guarda o identificador da chave usada, que voltam em origin e apiKeyId. O autor humano é opcional: com agentId a nota é assinada por aquele agente — e só assim ela dispara a automação de fluxo por comentário de agente; sem ele a nota fica sem autor, como as automáticas.

Ler continua permitido em ticket na lixeira; escrever, não (422 ticket_deleted). Em ticket concluído ou fechado, criar nota segue a regra do produto, mas editar e excluir respondem 422 ticket_not_editable — a chave não tem como ganhar a permissão de editar ticket encerrado.

GET /v1/tickets/{ticketId}/message-templates/{templateId} fica nesta aba porque é o que prepara o corpo de uma nota, de uma resposta ou de um encaminhamento: ele devolve o texto do modelo com os placeholders já trocados pelos dados do ticket, e só isso — o produto não tem assunto no modelo nem anexa os arquivos dele.