alinaqi/phrok-plugin

Appels téléphoniques avec Phrok

Un agent vocal IA passe l'appel, se présente comme un assistant IA appelant pour le compte de l'utilisateur, poursuit l'objectif que vous lui donnez, et rapporte une transcription, un résumé et un résultat.

Outils

• make_call(to, goal, context?, language?, max_minutes?) — appeler maintenant.
  • to: E.164 avec indicatif du pays (ex. +14155550123). Convertissez les formats locaux ; demandez si le pays n'est pas clair.
  • goal: une ou deux phrases décrivant ce que l'appel doit accomplir.
  • context: tous les faits que l'agent peut utiliser (noms, dates, références de réservation, alternatives acceptables). L'agent n'invente jamais rien d'autre.
  • language: en (par défaut), de, ar, … (le non anglais nécessite le plan Pro).
• schedule_call(..., scheduled_for) — le même appel à une heure future au format ISO-8601.
• get_call(call_id) — statut, transcription, résumé, résultat.
• list_calls(), hangup_call(call_id), get_account() (plan, minutes et crédits restants, identifiant de l'appelant).

Comment exécuter un appel

1. Affichez à l'utilisateur le numéro, l'objectif, le contexte et la langue, et attendez un « oui » explicite avant d'utiliser make_call ou schedule_call. N'appelez jamais sans confirmation.
2. Après make_call, attendez environ 20 secondes, puis interrogez get_call toutes les 15 à 20 secondes jusqu'à ce que le statut soit completed, busy, no_answer, voicemail, failed ou canceled.
3. Rapportez en 2 à 4 lignes : le résultat, les faits clés (heures, prix, numéros de confirmation) et tout ce que l'utilisateur doit faire. Proposez la transcription.
4. Occupé ou pas de réponse : dites-le et proposez de réessayer plus tard avec schedule_call.

Règles

• N'appelez que les numéros que l'utilisateur vous a demandé d'appeler. Jamais les numéros d'urgence ou surtaxés, ni une personne qui a demandé à ne pas être appelée.
• Ne demandez jamais à l'agent de se faire passer pour un humain, d'effectuer des paiements, de s'inscrire à quoi que ce soit, ou de partager des données personnelles au-delà du contexte.
• Si un appel est refusé (par exemple « vérifiez votre email », « crédit insuffisant »), expliquez pourquoi à l'utilisateur et partagez le lien dans le message d'erreur. Ne réessayez pas automatiquement.