Skip to main content
POST
/
conversations
/
v1
/
{id}
/
ai-suggest
curl -X POST https://api.whaapy.com/conversations/v1/550e8400-e29b-41d4-a716-446655440000/ai-suggest \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json"

{
  "suggestion": "¡Hola! Gracias por contactarnos. Nuestro horario de atención es de lunes a viernes de 9am a 6pm. ¿En qué puedo ayudarte?",
  "confidence": "high",
  "usedKnowledgeBase": true,
  "documentsCount": 3
}
Genera una respuesta usando el mismo modelo de IA del agente, incluyendo tu knowledge base y personalidad configurada, pero sin enviar el mensaje. Útil para:
  • Modo Copilot: Agentes humanos reciben sugerencias para revisar
  • Validación: Verificar respuestas antes de enviarlas automáticamente
  • Analytics: Comparar sugerencias vs respuestas reales

​
Parámetros

​
id
string
required
UUID de la conversación
curl -X POST https://api.whaapy.com/conversations/v1/550e8400-e29b-41d4-a716-446655440000/ai-suggest \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json"

{
  "suggestion": "¡Hola! Gracias por contactarnos. Nuestro horario de atención es de lunes a viernes de 9am a 6pm. ¿En qué puedo ayudarte?",
  "confidence": "high",
  "usedKnowledgeBase": true,
  "documentsCount": 3
}

​
Response

CampoTipoDescripción
suggestionstringTexto sugerido por la IA
confidence"high" | "medium" | "low"Nivel de confianza
usedKnowledgeBasebooleanSi se usaron documentos del knowledge base
documentsCountnumberCantidad de documentos consultados

​
Niveles de Confianza

NivelScoreSignificado
high> 70%La IA encontró información relevante
medium40-70%Información parcial disponible
low< 40%Información insuficiente
Si confidence es low, considera revisar tu knowledge base o agregar más documentos sobre el tema.

​
Scope Requerido

Este endpoint requiere el scope conversations:write en tu API Key.

​
Casos de Uso

Muestra sugerencias a agentes humanos:
async function showSuggestion(conversationId) {
  const response = await fetch(
    `https://api.whaapy.com/conversations/v1/${conversationId}/ai-suggest`,
    {
      method: 'POST',
      headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
    }
  );
  
  const { suggestion, confidence } = await response.json();
  
  displayInUI({
    text: suggestion,
    badge: confidence === 'high' ? 'Alta confianza' : 'Revisar'
  });
}
Valida la respuesta antes de enviarla:
async function validateAndSend(conversationId) {
  const suggestion = await fetch(
    `https://api.whaapy.com/conversations/v1/${conversationId}/ai-suggest`,
    { method: 'POST', headers: { 'Authorization': 'Bearer wha_TU_API_KEY' } }
  ).then(r => r.json());
  
  if (suggestion.confidence === 'low') {
    await escalateToHuman(conversationId);
    return;
  }
  
  await sendMessage(conversationId, suggestion.suggestion);
}