Buscar Conversa

GET /external/v1/conversations/:id

Recupera uma conversa especifica junto com suas mensagens — a trilha completa de perguntas/respostas da qualificacao por IA e do follow-up humano.

Autenticacao

Requer permissao conversations:read.

Parametros de Caminho

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	Identificador unico da conversa

Parametros de Query

Parametro	Tipo	Padrao	Descricao
messages_limit	integer	200	Numero maximo de mensagens a retornar (1-500)

Requisicao

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/conversations/conv_88?messages_limit=200" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const conversationId = 'conv_88';

const response = await axios.get(
  `https://app.getraze.com/external/v1/conversations/${conversationId}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' }, params: { messages_limit: 200 } }
);

console.log(response.data);

Python

import requests

conversation_id = 'conv_88'

response = requests.get(
    f'https://app.getraze.com/external/v1/conversations/{conversation_id}',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    params={'messages_limit': 200}
)

print(response.json())

Resposta

{
  "success": true,
  "data": {
    "id": "conv_88",
    "status": "active",
    "channel": "LINKEDIN",
    "contact_id": "cnt_abc123",
    "opportunity_id": "opp_abc123",
    "qualification_score": 85,
    "qualification_stage": "qualified",
    "qualification_reasons": ["budget_ok", "decision_maker"],
    "objections_history": [],
    "contact_name": "John Doe",
    "ai_agent_name": "Qualificador Bot",
    "assigned_user_name": "Maria Silva",
    "last_message_at": "2026-01-20T14:00:00Z",
    "created_at": "2026-01-15T10:30:00Z",
    "messages": [
      {
        "id": "msg_1",
        "sender_type": "ai",
        "content": "Oi John, qual seu orcamento mensal?",
        "channel": "LINKEDIN",
        "sent_at": "2026-01-15T10:31:00Z",
        "read_at": "2026-01-15T10:35:00Z",
        "created_at": "2026-01-15T10:31:00Z"
      },
      {
        "id": "msg_2",
        "sender_type": "lead",
        "content": "Cerca de 5k/mes.",
        "channel": "LINKEDIN",
        "sent_at": "2026-01-15T10:40:00Z",
        "read_at": null,
        "created_at": "2026-01-15T10:40:00Z"
      }
    ]
  }
}

Campos de Resposta

O objeto da conversa carrega os mesmos campos de Listar Conversas, mais um array messages.

Objeto de mensagem

Campo	Tipo	Descricao
id	string	Identificador da mensagem
sender_type	string	Quem enviou: lead, ai ou user
content	string	Texto da mensagem
channel	string	Canal pelo qual a mensagem foi enviada
sent_at	string	Timestamp ISO 8601 de envio
read_at	string	Timestamp ISO 8601 de leitura (nullable)
created_at	string	Timestamp ISO 8601 de criacao

Erros

Status	Codigo	Descricao
404	NOT_FOUND	Conversa com este ID nao encontrada