Visão geral
Seguidores do ticket
Seção intitulada “Seguidores do ticket”Agentes que acompanham um ticket: o que a aba Seguidores mostra, mais adicionar e remover. 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.
O seguidor não tem id próprio: a chave do vínculo é o par (ticket, agente), e dentro de um ticket o agentId identifica o seguidor sozinho — é ele que vai na rota de remoção e é por ele que a listagem ordena e pagina.
O vínculo não é editável: não há PATCH. Ele existe ou não existe, e por isso as duas escritas são idempotentes — adicionar quem já segue devolve 201 com o mesmo corpo, e remover quem não segue devolve 204.
Seguir continua permitido em ticket concluído ou fechado, como na tela. Em ticket na lixeira, ler continua permitido e escrever responde 422 ticket_deleted.
Não há rota de agentes elegíveis: ela depende de um agente logado para decidir elegibilidade, e uma chave de API não é uma pessoa. Um agente que não alcança o ticket é recusado na adição, com a mensagem da regra.