​

Criar ID de Conversa

Cria um novo ID de conversa para o processamento do Tolky Reasoning.

Endpoint: POST /api/externalAPIs/public/createConversationId

Parâmetros:

• hostId (string, UUID, obrigatório): UUID do host
• hostSlug (string, obrigatório): Slug do host
• globalData (object, opcional): Dados globais adicionais

Exemplo cURL:

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/createConversationId' \
  -H 'Content-Type: application/json' \
  -d '{
    "hostId": "uuid-do-host",
    "hostSlug": "seu-host-slug",
    "globalData": {
      "additionalInfo": "Informações adicionais"
    }
  }'

Resposta de Exemplo:

{
  "code": 200,
  "message": "Success",
  "data": {
    "conversationId": "uuid-da-nova-conversa"
  }
}

Códigos de Erro:

• 400: Campos obrigatórios ausentes ou inválidos
• 401: Token de autenticação inválido ou ausente
• 500: Erro interno do servidor

Notas:

• Requer autenticação válida através do tolkyAuthMiddleware
• O ID de conversa gerado é único e pode ser usado em outras chamadas da API