Pular para o conteúdo principal
GET
/
conversations
/
{id}
Obter conversa
curl --request GET \
  --url https://api.meuassistente.rdstationmentoria.com.br/rest/conversations/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "title": "<string>",
  "createdAt": "2025-11-26T20:01:11.929Z",
  "status": "active",
  "summary": null,
  "messages": []
}

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

​
id
string
obrigatório

Identificador da conversa

Resposta

Successful response

​
id
string
obrigatório

Identificador da conversa

​
title
string
obrigatório

Título

​
createdAt
string<date-time>
padrão:2025-11-26T20:01:11.929Z

Data de criação

​
status
enum<string>
padrão:active

Status

Opções disponíveis:
active,
finished
​
summary
string | null

Resumo da conversa

​
messages
object[]

Histórico completo de mensagens trocadas nesta conversa, ordenadas cronologicamente.

Cada mensagem possui:

  • id: identificador único da mensagem
  • conversationId: identificador da conversa à qual a mensagem pertence
  • role: quem falou (system, assistant, user, tool)
  • name: nome associado à mensagem, se aplicável
  • content: conteúdo textual da mensagem
  • toolCallId: identificador da chamada de ferramenta associada, se houver
  • toolCalls: lista de chamadas de ferramentas associadas, se houver
  • metadata: metadados adicionais em formato livre
  • feedback: indica se há feedback (booleano ou null)
  • usage: informações de uso, como tokens (se disponíveis)
  • createdAt e updatedAt: datas de criação e atualização da mensagem

Exemplo de retorno

[
  {
    "id": "msg_abc123",
    "conversationId": "convo_001",
    "role": "user",
    "name": "João",
    "content": "Olá, tudo bem?",
    "createdAt": "2025-07-08T14:30:00.000Z",
    "updatedAt": "2025-07-08T14:30:00.000Z"
  },
  {
    "id": "msg_def456",
    "conversationId": "convo_001",
    "role": "assistant",
    "name": null,
    "content": "Olá! Como posso te ajudar?",
    "feedback": true,
    "usage": {
      "inputTokens": 6,
      "outputTokens": 9,
      "totalTokens": 15
    },
    "createdAt": "2025-07-08T14:30:02.000Z",
    "updatedAt": "2025-07-08T14:30:02.000Z"
  }
]