Retorna o lead_id associado a uma conversa identificada por public.conversations.id, junto com a lista completa de conversas pertencentes a esse lead.

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/leads/getLeadByConversation

Parâmetros

host-id
string
required

UUID do host. Enviado via header da requisição.

host-slug
string
required

Slug do host. Enviado via header da requisição.

conversationId
string
required

UUID da conversa (public.conversations.id) a ser consultada.

Exemplo

curl -X POST {{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/leads/getLeadByConversation \
  -H "Content-Type: application/json" \
  -H "host-id: {HOST_ID}" \
  -H "host-slug: {HOST_SLUG}" \
  -d '{
    "conversationId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }'

Resposta

{
  "code": 200,
  "message": "Success",
  "data": {
    "lead_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "conversations": [
      {
        "conversation_id": "c1d2e3f4-0000-0000-0000-000000000001",
        "dialogue_summary": "Usuário perguntou sobre planos e preços.",
        "created_at": "2025-02-20T10:00:00.000Z",
        "ask_human_help": false,
        "closed": true
      },
      {
        "conversation_id": "c1d2e3f4-0000-0000-0000-000000000002",
        "dialogue_summary": "Usuário retornou para confirmar a contratação.",
        "created_at": "2025-03-01T09:30:00.000Z",
        "ask_human_help": false,
        "closed": false
      }
    ]
  }
}

Campos da Resposta

code
number

Código HTTP da resposta (200 em sucesso).

message
string

Mensagem de status da operação.

data
object

Objeto com o lead e suas conversas.

Erros

CódigoDescrição
400conversationId ausente ou inválido
401Headers de autenticação inválidos ou ausentes
404Conversa ou lead não encontrado
500Erro interno do servidor