Smart Feedback

O endpoint Smart Feedback permite o processamento assíncrono de múltiplas conversas, retomando-as de maneira inteligente a partir do contexto original. Este endpoint é especialmente útil para:

​

📑 Índice

• 🎯 Visão Geral
• 🔑 Autenticação
• ⚙️ Parâmetros da Requisição
• 📦 Estrutura da Resposta
• 💡 Exemplos de Uso
• ⚠️ Tratamento de Erros
• ✨ Boas Práticas

​

🎯 Visão Geral

O endpoint Smart Feedback é responsável por:

​

🔑 Autenticação

Para utilizar o endpoint, é necessário incluir um token de autenticação no header da requisição:

Authorization: Bearer {seu-token-de-acesso}

​

⚙️ Parâmetros da Requisição

​

📋 Parâmetros Obrigatórios

​

🔧 Parâmetros Opcionais

• ⚙️ reasoningConfig

{
  "rebounce": boolean,
  "rebounceInstructions": string
}

​

📦 Estrutura da Resposta

A resposta da API segue o seguinte formato:

{
  "code": 200,
  "message": "Success",
  "data": {
    "message": "Conversas enviadas para processamento",
    "queuedCount": number
  }
}

​

💡 Exemplos de Uso

• 📤 Requisição

• 📥 Resposta

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/smartFeedback' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {seu-token}' \
  -d '{
    "reasoningConfig": {
      "rebounce": true,
      "rebounceInstructions": "O usuário enviou uma mensagem num momento em que o servidor estava fora do ar. CRIE a mensagem que faça sentido no contexto da conversa. Na dúvida, pergunte se está tudo certo e retome o que for possível da conversa. Demonstre que se interessa em resolver o problema do usuário ou ajudar no que ele precisa."
    },
    "conversationIds": [
      "5893c3b4-7cfd-4348-a190-b228a5381d7a"
    ]
  }'

​

⚠️ Tratamento de Erros

​

⏱️ Timeout

Todas as requisições têm um timeout de 60 segundos. Se a requisição exceder este limite, será retornado um erro 408 (Request Timeout).

​

✨ Boas Práticas