Consultar uma conversa — GET /v1/conversations/:id

Retorna o histórico completo de mensagens de uma conversa.

Requisição

GET /v1/conversations/:id
Authorization: Bearer f2a_live_...

Resposta

{
  "conversation_id": "uuid",
  "title": "título da conversa",
  "messages": [
    { "role": "user", "content": "...", "created_at": "...", "credits_charged": null, "interrupted": false },
    { "role": "assistant", "content": "...", "created_at": "...", "credits_charged": 2, "interrupted": false }
  ]
}

Isolamento por visitante (tokens de widget)

Como um token de widget é compartilhado entre todos os visitantes anônimos de um mesmo agente, essa rota tem uma checagem adicional: se a conversa foi criada por um visitante identificado (visitor_id), a consulta exige o parâmetro ?visitor_id= na URL, batendo exatamente com o valor gravado na criação daquela conversa:

GET /v1/conversations/:id?visitor_id=SEU-VISITOR-ID

Sem isso, qualquer chamador com o mesmo token de widget conseguiria ler o histórico de qualquer visitante daquele agente — não só o próprio. Um visitor_id incorreto ou ausente (quando a conversa exige um) retorna 403 Forbidden. Uma conversa de organização (id inexistente ou de outra organização) retorna 404, não 403 — para não confirmar nem a existência do id a quem não tem acesso a ele.