​
6. Obter Informações da Conversa

Retorna informações detalhadas sobre uma conversa específica, incluindo resumo, análise de sentimento e metadados diversos. A resposta é cacheada para melhor performance.

Endpoint: POST /api/externalAPIs/public/tolkyReasoning/getConversationInformation

Parâmetros:

  • conversationId (string, UUID, obrigatório): UUID da conversa a ser consultada

Exemplo cURL:

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/tolkyReasoning/getConversationInformation' \
  -H 'Content-Type: application/json' \
  -d '{
    "conversationId": "uuid-da-conversa"
  }'

Resposta de Exemplo:

{
  "code": 200,
  "message": "Success",
  "data": {
    "id": "uuid-da-conversa",
    "dialogue_summary": "Resumo da conversa",
    "main_topic": "Tópico principal",
    "user_name": "Nome do Usuário",
    "tip": "Dica adicional",
    "wpp_id": "id-do-whatsapp",
    "archived": false,
    "last_message_at": "2024-03-21T00:00:00Z",
    "external_id": "id-externo",
    "heat_score": 75,
    "heat_score_description": "Alta prioridade",
    "sentiment_score": 80,
    "sentiment_score_explanation": "Sentimento positivo",
    "lead_id": "uuid-do-lead",
    "ask_human_help": false,
    "closed": false
  }
}

Códigos de Erro:

  • 400: Campos obrigatórios ausentes ou inválidos
  • 401: Token de autenticação inválido ou ausente
  • 404: Conversa não encontrada
  • 500: Erro interno do servidor

Notas:

  • A resposta é cacheada por 5 minutos para melhor performance
  • O cache é invalidado automaticamente após o período de expiração
  • Requer autenticação válida através do tolkyAuthMiddleware
Tolky ocrCriar ID de Conversa