Outils intégrés

​

Les outils autonomes

​

Activer un outil

​

Fin d’appel

​

Transfert d’appel (à froid)

• Numéro de téléphone — la destination fixe.
• L’IA peut déterminer le numéro de transfert dynamiquement — expose la destination sous forme d’argument de fonction à la place.
• Message de transfert accompagné — annonce optionnelle et non interruptible avant le transfert à froid.

​

Transfert d’appel accompagné

• Téléphone du superviseur — qui appeler ; le trunk sortant configuré de l’espace de travail est utilisé.
• Musique d’attente — activée ou non, plus un message d’attente vocal optionnel.
• Briefing — instructions de résumé (comment résumer l’appel pour le collègue) et une phrase d’ouverture du briefing adressée au collègue ; les deux prennent en charge les {{variables}}.
• Délai de sonnerie et repli — poursuivre la conversation, raccrocher, ou basculer sur un transfert à froid si l’appel de consultation échoue.

​

Transfert vers un assistant (IA → IA)

• Assistant cible (assistant_id) — obligatoire ; doit appartenir à l’espace de travail.
• Message avant transfert — ligne non interruptible optionnelle prononcée avant la bascule.
• Énoncer le message d’accueil du transfert — activé par défaut : le premier message / message d’accueil de l’assistant cible est joué juste après la bascule.
• Description — obligatoire : indiquez au modèle quand transférer (par exemple des questions tarifaires → assistant commercial).

​

Envoyer un SMS

• Destinataire (sms_to_mode) — caller (par défaut : le numéro de l’appelant) ou custom avec un numéro personnalisé fixe (sms_custom_number, au format E.164, par exemple +491701234567).

​

Envoyer un e-mail

• Destinataire (email_to_mode) — ask passe par un flux dédié de capture d’e-mail pour normaliser une parole bruitée et obtenir une confirmation explicite ; fixed utilise email_fixed_to. Une adresse mal formée ou dictée à l’oral n’est jamais devinée au moment de l’envoi.
• Expéditeur (email_sender_mode) — auto essaie d’abord l’adresse SendGrid vérifiée de l’assistant, puis le SMTP de l’espace de travail/revendeur, puis la messagerie de la plateforme. Vous pouvez aussi choisir explicitement SMTP de l’espace de travail, Messagerie de la plateforme, ou une adresse vérifiée issue de GET /api/v1/email-senders. Un choix explicite échoue clairement plutôt que de basculer silencieusement sur un autre expéditeur.
• Nom d’affichage (email_from_name) — surcharge optionnelle par outil.
• Contenu (email_content_mode) — llm laisse le modèle rédiger l’objet et le corps à partir de l’appel ; fixed envoie toujours le texte littéral configuré ; template résout les {{call_variables}} et bloque l’envoi si une valeur est manquante.
• Signature (email_signature_mode) — signature par défaut de l’espace de travail (avec {agent_name} / {{assistant_name}}), une signature personnalisée par outil, ou aucune. Elle est ajoutée une seule fois par le code applicatif, jamais improvisée par le modèle.
• Statut de livraison — un résultat d’outil réussi signifie que le fournisseur SMTP a accepté le message, pas qu’il est arrivé dans la boîte de réception. Les suppressions SendGrid connues (rebonds, blocages, spam) sont vérifiées avant l’envoi et remontées à l’assistant comme un échec de livraison.

​

Heures d’ouverture

• Heures d’ouverture (business_hours) — un planning hebdomadaire, avec une ou plusieurs plages horaires par jour de la semaine ({"mon": [["09:00", "17:00"]], ...} — le même format que les plages d’appel de campagne).
• Note (hours_note) — un indice en texte libre optionnel, renvoyé avec le résultat (par exemple « Fermé les jours fériés »).

​

Planifier un rappel

• Numéro de rappel (callback_to_mode) — caller (par défaut : rappeler l’appelant sur son propre numéro) ou custom avec un numéro personnalisé fixe (callback_custom_number, au format E.164).
• Nombre maximum de jours à l’avance (max_days_ahead) — jusqu’à combien de jours dans le futur un rappel peut être réservé (1 à 365 jours).

​

Collecter la carte de paiement

1. Ajoutez votre clé secrète Stripe dans Outils → App Store → Stripe.
2. Créez un outil intégré de type collect_payment_card et sélectionnez ce compte Stripe (stripe_connection_id).
3. Attribuez l’outil à un assistant.
4. Ajoutez un nœud Collecte de type Carte de paiement dans le flow.

​

Définir une variable d’appel

• Clés autorisées (allowed_keys) — liste blanche optionnelle en snake_case. Vide = n’importe quelle clé valide, sauf les clés réservées de la plateforme (assistant_name, direction, call_id, date, time, datetime, weekday).
• Description — indiquez au modèle quand enregistrer (par exemple une fois que l’appelant a donné le nom de son entreprise).

​

Outil système : get_current_time

​

API et MCP

curl -X PATCH https://app.famulor.io/api/v1/assistants/{id} \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tools": [
      { "type": "end_call", "description": "Hang up politely once the caller is done." },
      { "type": "send_email", "email_to_mode": "ask",
        "email_sender_mode": "auto", "email_content_mode": "llm",
        "email_signature_mode": "workspace" }
    ]
  }'