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ódigoDescrição
400Parâmetros inválidos
401Token inválido ou ausente
403Credenciais insuficientes
404Lead especificado não encontrado
408Timeout — requisição excedeu 30 segundos
500Erro interno do servidor