alinaqi/phrok-plugin

Llamadas telefónicas con Phrok

Un agente de voz de IA realiza la llamada, se presenta como un asistente de IA que llama en nombre del usuario, persigue el objetivo que le indiques y reporta una transcripción, resumen y resultado.

Herramientas

• make_call(to, goal, context?, language?, max_minutes?) — llamar ahora.
  • to: E.164 con código de país (ej. +14155550123). Convierte formatos locales; pregunta si el país no está claro.
  • goal: una o dos frases sobre lo que la llamada debe lograr.
  • context: todos los hechos que el agente puede usar (nombres, fechas, referencias de reserva, alternativas aceptables). El agente nunca inventa nada más.
  • language: en (por defecto), de, ar, … (idiomas no inglés necesitan el plan Pro).
• schedule_call(..., scheduled_for) — lo mismo en una hora futura en formato ISO-8601.
• get_call(call_id) — estado, transcripción, resumen, resultado.
• list_calls(), hangup_call(call_id), get_account() (plan, minutos y créditos restantes, ID de llamada).

Cómo ejecutar una llamada

1. Muéstrale al usuario el número, objetivo, contexto e idioma, y espera un "sí" explícito antes de make_call o schedule_call. Nunca llames sin confirmación.
2. Después de make_call, espera unos 20 segundos, luego consulta get_call cada 15–20 segundos hasta que el estado sea completed, busy, no_answer, voicemail, failed o canceled.
3. Informa en 2–4 líneas: el resultado, datos clave (horarios, precios, números de confirmación) y cualquier acción que el usuario deba realizar. Ofrece la transcripción.
4. Ocupado o sin respuesta: indícalo y ofrece reintentar más tarde con schedule_call.

Reglas

• Solo llama a números que el usuario te haya pedido llamar. Nunca a números de emergencia o tarificación especial, ni a personas que hayan solicitado no ser llamadas.
• Nunca pidas al agente que finja ser humano, realice pagos, se registre en nada o comparta datos personales más allá del contexto.
• Si una llamada es rechazada (por ejemplo, "verifica tu correo", "sin minutos"), dile al usuario por qué y comparte el enlace en el mensaje de error. No reintentes automáticamente.