Visão geral
Chat do ticket
Seção intitulada “Chat do ticket”Conversas do MSP Talks vinculadas a um ticket: o que a aba Chat mostra, mais vincular, trocar a conversa principal, desvincular, anotar no atendimento e iniciar uma conversa. 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.
As escritas falam com o MSP Talks dentro da requisição. Vincular confirma a conversa do outro lado antes de gravar, anotar escreve na conversa e iniciar manda a mensagem. Três consequências: a latência é a do fornecedor; a integração precisa estar configurada e ativa na empresa, senão a operação responde 422 business_rule_violation (é condição permanente — ligar a integração resolve, repetir não); e uma falha do próprio fornecedor responde 503 service_unavailable, o único erro destas rotas que vale repetir.
Iniciar conversa custa dinheiro (a Meta cobra por conversa iniciada), e por isso a rota nunca responde erro depois de a mensagem ter saído: se o envio foi aceito e o resto falhar, a resposta é 202. Use Idempotency-Key — a repetição devolve a resposta original, 201 ou 202, sem mandar uma segunda mensagem.
Quem age vai explícito em agentId ao vincular e ao iniciar: o vínculo registra quem o criou, e uma chave de API não é uma pessoa. Trocar a principal, desvincular e anotar não têm ator — nem na tela.
Vincular a mesma conversa a dois tickets é permitido (um atendimento longo vira dois chamados): a resposta do vínculo traz alsoLinkedToTicketId como aviso, não como erro.
Escrever 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á busca de conversas candidatas, abertura da conversa no navegador nem resumo por IA: a primeira é consulta ao diretório da conta do MSP Talks (o integrador já conhece o sessionId), a segunda devolve um endereço autenticado que só faz sentido dentro da tela, e a API pública não publica rota de IA.