Conversas
Criar ID de Conversa
Criar ID de Conversa
Cria um novo ID de conversa para o processamento do Tolky Reasoning.
Endpoint: POST /api/externalAPIs/public/tolkyReasoning/conversations/create
Parâmetros:
hostId(string, UUID, obrigatório): UUID do hosthostSlug(string, obrigatório): Slug do hostglobalData(object, opcional): Dados globais adicionais
Exemplo cURL:
curl -X POST \
'{{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/conversations/create' \
-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álidos401: Token de autenticação inválido ou ausente500: 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