Leads
Obter Lead por Conversa
Dado um conversation_id, retorna o lead associado e todas as suas conversas
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
requiredUUID do host. Enviado via header da requisição.
host-slug
string
requiredSlug do host. Enviado via header da requisição.
conversationId
string
requiredUUID 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ódigo | Descrição |
|---|---|
400 | conversationId ausente ou inválido |
401 | Headers de autenticação inválidos ou ausentes |
404 | Conversa ou lead não encontrado |
500 | Erro interno do servidor |