Disparos de Mensagens
Criar ID de Conversação
Cria uma conversação e retorna os IDs de lead, conversação e sessão para uso com o Tolky Reasoning
Você pode testar esta rota diretamente em nossa documentação interativa.
Cria uma nova conversação no Tolky para interações com o Reasoning. A conversação pode ser associada a um lead existente (externalId) ou criar um novo lead automaticamente.
Endpoint
POST /api/externalAPIs/public/createConversationId
Parâmetros
externalId
string
ID externo de um lead para associar à conversação.
userName
string
Nome do usuário ou lead.
email
string
Email do usuário ou lead.
cpf
string
CPF do usuário ou lead.
phone
string
Telefone do usuário ou lead.
Exemplo
curl -X POST {{BASE_URL}}/api/externalAPIs/public/createConversationId \
-H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"userName": "João Silva",
"email": "joao.silva@exemplo.com",
"phone": "31999999999",
"externalId": "cliente-123"
}'
Resposta
{
"code": 200,
"message": "OK",
"data": {
"leadId": "uuid-do-lead",
"conversationId": "uuid-da-conversacao",
"sessionId": "uuid-da-sessao"
}
}
Campos da Resposta
data.leadId
string
UUID do lead associado ou criado.
data.conversationId
string
UUID da conversação criada.
data.sessionId
string
UUID da sessão.
Se externalId for fornecido e existir no sistema, a conversação será associada a esse lead. Caso contrário, um novo lead será criado.
Erros
| Código | Descrição |
|---|---|
400 | Parâmetros inválidos |
401 | Token inválido ou ausente |
403 | Credenciais insuficientes |
404 | Lead especificado não encontrado |
408 | Timeout — requisição excedeu 30 segundos |
500 | Erro interno do servidor |