Leads
Obter Detalhes do Lead
Retorna dados completos de um lead, incluindo suas conversas e tickets associados
Retorna os dados completos de um lead identificado por public.leads.id, incluindo propriedades do lead, lista de conversas e tickets associados.
Endpoint
POST /api/externalAPIs/public/tolkyReasoning/leads/getLeadDetails
Parâmetros
host-id
string
requiredUUID do host. Enviado via header da requisição.
host-slug
string
requiredSlug do host. Enviado via header da requisição.
leadId
string
requiredUUID do lead (public.leads.id) a ser consultado.
Exemplo
curl -X POST {{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/leads/getLeadDetails \
-H "Content-Type: application/json" \
-H "host-id: {HOST_ID}" \
-H "host-slug: {HOST_SLUG}" \
-d '{
"leadId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}'
Resposta
{
"code": 200,
"message": "Success",
"data": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"external_id": null,
"lead_name": "Maria Silva",
"user_name": "maria.silva",
"email": "maria@empresa.com",
"phone": "5511999990000",
"created_at": "2025-01-10T14:00:00.000Z",
"updated_at": "2025-03-01T09:30:00.000Z",
"host_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"lead_summary": "Lead demonstrou interesse em planos empresariais.",
"sentiment": "positive",
"location": "São Paulo, SP",
"last_interaction_at": "2025-03-01T09:30:00.000Z",
"pipeline_stage": 2,
"user_score": 85,
"user_score_explain": "Alto engajamento e perfil qualificado.",
"ask_human_help": false,
"is_paused": false,
"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
}
],
"tickets": [
{
"id": "t1u2v3w4-0000-0000-0000-000000000001",
"subject": "Solicitação de proposta comercial",
"description": "Lead solicitou proposta detalhada para plano empresarial.",
"status_name": "Em Análise",
"status_level": 2,
"closed": false,
"created_at": "2025-02-21T08:00:00.000Z",
"conversation_id": "c1d2e3f4-0000-0000-0000-000000000001",
"friendly_protocol": "TKT-2025-0042"
}
]
}
}
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 os dados completos do lead.
Erros
| Código | Descrição |
|---|---|
400 | leadId ausente ou inválido |
401 | Headers de autenticação inválidos ou ausentes |
404 | Lead não encontrado |
500 | Erro interno do servidor |