Acciones y Herramientas

Used to transfer the call to a person in the following cases:

- The user directly rejects the proposal or service
- The user expressly requests to speak with a human person
- The user shows distrust towards the virtual assistant
- Specific information is needed that is not available in the system
- User requires authorization or management of sensitive personal data
- The customer expresses frustration or needs personalized attention
- The query requires specialized technical knowledge
- Request to speak with a supervisor or manager

Utilisé pour transférer l'appel à une personne dans les cas suivants:

- L'utilisateur rejette directement la proposition ou le service
- L'utilisateur demande expressément à parler avec une personne humaine
- L'utilisateur montre de la méfiance envers l'assistant virtuel
- Des informations spécifiques sont nécessaires qui ne sont pas disponibles
- L'utilisateur nécessite une autorisation ou gestion de données sensibles
- Le client exprime sa frustration ou a besoin d'attention personnalisée
- La demande nécessite des connaissances techniques spécialisées
- Demande de parler avec un superviseur ou responsable

Wird verwendet, um das Gespräch in folgenden Fällen an eine Person zu übertragen:

- Der Benutzer lehnt den Vorschlag oder Service direkt ab
- Der Benutzer möchte ausdrücklich mit einer echten Person sprechen
- Der Benutzer zeigt Misstrauen gegenüber dem virtuellen Assistenten
- Spezifische Informationen werden benötigt, die nicht verfügbar sind
- Der Benutzer benötigt Autorisierung oder sensible Datenverwaltung
- Der Kunde äußert Frustration oder benötigt persönliche Betreuung
- Die Anfrage erfordert spezialisiertes technisches Wissen
- Anfrage, mit einem Supervisor oder Manager zu sprechen

Common phrases detected automatically:
- "Please leave your message after the tone"
- "We're sorry, but at this time we cannot..."
- "The person you are calling is not available"
- "You have reached the voicemail of..."
- "Thank you for calling, we are currently..."
- "Your call is important to us, please hold..."
- "We cannot take your call right now"
- "Leave your message at the sound of the beep"
- "This is the answering machine of..."
- "Please try your call again later"

Phrases communes détectées automatiquement:
- "Veuillez laisser votre message après le signal"
- "Nous sommes désolés, mais en ce moment..."
- "La personne que vous appelez n'est pas disponible"
- "Vous avez joint la messagerie de..."
- "Merci d'appeler, nous sommes actuellement..."
- "Bienvenue sur le répondeur de..."
- "Laissez votre message après le bip"

{
  "name": "consultar_inventario",
  "description": "Verificar disponibilidad de productos en inventario cuando el cliente pregunta por stock, disponibilidad, precios, o quiere realizar una compra",
  "api_schema": {
    "url": "https://api.miempresa.com/inventory/check",
    "method": "GET",
    "request_headers": {
      "X-API-Key": "YOUR_INVENTORY_API_KEY",
      "Accept": "application/json"
    },
    "query_params_schema": {
      "properties": {
        "product_id": {
          "type": "string",
          "description": "ID, código SKU, o nombre del producto a consultar"
        },
        "location": {
          "type": "string", 
          "description": "Código de sucursal o almacén para verificar disponibilidad local",
          "enum": ["MAD001", "BCN001", "VLC001", "SEV001", "ONLINE"]
        },
        "quantity": {
          "type": "integer",
          "description": "Cantidad específica que el cliente necesita",
          "minimum": 1
        },
        "variant": {
          "type": "string",
          "description": "Variante del producto (color, talla, modelo) si aplica"
        }
      },
      "required": ["product_id"]
    }
  },
  "disable_interruptions": false,
  "execution_mode": "immediate",
  "response_timeout_secs": 8,
  "tool_call_sound": "typing"
}

{
  "name": "programar_cita_medica",
  "description": "Programar nueva cita médica cuando el paciente solicita una cita, quiere reprogramar una existente, o necesita atención médica específica",
  "api_schema": {
    "url": "https://api.clinica.com/appointments",
    "method": "POST",
    "request_headers": {
      "Authorization": "Bearer YOUR_CLINIC_TOKEN",
      "Content-Type": "application/json"
    },
    "request_body_schema": {
      "type": "object",
      "required": ["patient_name", "preferred_date", "service_type", "contact_phone"],
      "properties": {
        "patient_name": {
          "type": "string",
          "description": "Nombre completo del paciente según documento de identidad"
        },
        "patient_phone": {
          "type": "string",
          "description": "Teléfono principal del paciente para confirmaciones"
        },
        "patient_email": {
          "type": "string",
          "description": "Email del paciente para envío de confirmaciones (opcional)"
        },
        "preferred_date": {
          "type": "string",
          "format": "date",
          "description": "Fecha preferida en formato YYYY-MM-DD"
        },
        "preferred_time": {
          "type": "string",
          "enum": ["09:00", "10:00", "11:00", "12:00", "15:00", "16:00", "17:00"],
          "description": "Hora preferida según disponibilidad médica"
        },
        "service_type": {
          "type": "string",
          "enum": ["Consulta General", "Especialidad", "Urgencia", "Revisión", "Telemedicina"],
          "description": "Tipo de servicio médico requerido"
        },
        "doctor_preference": {
          "type": "string",
          "description": "Nombre del médico preferido si el paciente tiene preferencia"
        },
        "insurance_provider": {
          "type": "string",
          "description": "Nombre del seguro médico del paciente"
        },
        "reason": {
          "type": "string",
          "description": "Motivo de la consulta o síntomas principales"
        }
      }
    }
  },
  "response_timeout_secs": 20,
  "tool_call_sound": "typing",
  "force_pre_tool_speech": true,
  "execution_mode": "immediate"
}

## Protocolo de Finalización de Llamada

DETECCIÓN DE CONTESTADOR AUTOMÁTICO:
Finalizar inmediatamente cuando se detecten estas frases:
- "Deje su mensaje después de la señal"
- "En este momento no podemos atenderle"
- "El número marcado no está disponible"
- "Gracias por llamar a [empresa/servicio]"
- "Buzón de voz de [nombre/empresa]"
- "Ha contactado con el servicio de..."
- "Bienvenido al contestador automático"
- "Su llamada es importante para nosotros"
- "No podemos atender su llamada ahora"
- "Por favor, inténtelo de nuevo más tarde"

FINALIZACIÓN POR CUMPLIMIENTO DE OBJETIVOS:
- Todos los objetivos de la llamada han sido completados
- El cliente ha proporcionado toda la información requerida
- Se ha completado exitosamente el proceso solicitado
- El cliente confirma satisfacción con la resolución

FINALIZACIÓN POR DESPEDIDA NATURAL:
- El cliente se despide de forma clara e inequívoca
- Intercambio de despedidas protocolarias completado
- El cliente indica que no necesita nada más
- Finalización cortés y profesional del diálogo

## Protocolo de Rellamada Automática

ACTIVAR RELLAMADA EN ESTOS CASOS:

CONDICIONES TÉCNICAS:
- No se obtiene respuesta después de timbre prolongado
- La línea telefónica está ocupada o congestionada
- Se detecta contestador automático o buzón de voz
- La llamada se corta inesperadamente por fallas técnicas
- Problemas de calidad de audio que impiden conversación
- Rechazo automático por parte del sistema del operador

CONDICIONES DE NEGOCIO:
- No se completaron los objetivos principales de la llamada
- El cliente solicitó ser contactado en horario específico
- Información crítica pendiente de recopilación o confirmación
- Proceso de venta o gestión interrumpido antes de finalizar
- Seguimiento requerido según protocolo empresarial
- Confirmación de cita, servicio, o compromiso pendiente

CONFIGURACIÓN DE REINTENTOS:
- Máximo 3 intentos de rellamada por contacto
- Intervalos progresivos: 30 min → 4 horas → 1 día
- Respetar horarios comerciales (9:00-18:00) zona local
- Excluir fines de semana y días festivos nacionales
- Detener rellamadas si cliente solicita no ser contactado
- Cumplir con regulaciones de protección de datos (LOPD/GDPR)

# Test de latencia completa
curl -w "@curl-format.txt" -o /dev/null -s \
  -X POST "https://your-api.com/webhook" \
  -H "Content-Type: application/json" \
  -d '{"test": "data"}'

# Verificar certificados SSL
openssl s_client -connect your-api.com:443 -servername your-api.com

# Test de carga básica
for i in {1..10}; do
  curl -s -o /dev/null -w "%{http_code} %{time_total}\n" \
    https://your-api.com/webhook &
done
wait

// Revisar logs del sistema recall
{
  "recall_id": "rec_12345",
  "status": "failed",
  "error_code": "INVALID_TIMEZONE",
  "last_attempt": "2025-01-20T15:30:00Z",
  "attempts_remaining": 1,
  "failure_reason": "Outside business hours",
  "next_scheduled": "2025-01-21T09:00:00Z"
}