# Appel vocal

Le déclencheur Appel vocal publie un **lien d'appel**. Un visiteur l'ouvre,
clique sur Appeler et parle à votre agent à voix haute — l'expérience d'un
appel téléphonique, pas d'un talkie-walkie. Un restaurant met le lien sur son
site et ses clients appellent pour réserver une table.

## L'ajouter à un workflow

1. Déposez un nœud **Appel vocal** depuis la palette Déclencheurs.
2. Réglez la **durée maximale d'appel**. C'est le réglage qui compte — voir plus bas.
3. Choisissez une **voix**, écrivez un **message d'accueil** et les **instructions système**.
4. Vérifiez le **modèle temps réel**.
5. Enregistrez le workflow, puis copiez le **lien d'appel** affiché en haut du panneau.

## Durée maximale d'appel

Le lien d'appel est **ouvert par défaut** : pas de connexion, pas de jeton,
toute personne qui a le lien peut appeler. C'est ce qui fait de la durée
maximale la principale protection contre l'abus, et contre un onglet oublié qui
consomme des minutes toute la nuit.

- Défaut : **300 secondes** (5 minutes).
- Plage autorisée : **10 à 900 secondes** (le plafond plateforme `VOICE_CALL_MAX_SECONDS_CEILING` ramène toute valeur supérieure).
- À l'échéance, l'appel se termine. Le plafond est porté par
  **l'expiration de la session éphémère côté serveur**, pas par un minuteur
  JavaScript — un minuteur navigateur se contourne en dix secondes avec la
  console.

L'appelant voit le temps restant défiler avant la coupure : elle n'est jamais
une surprise.

## Modèle temps réel

Le modèle vocal temps réel est un **réglage du nœud**, jamais une constante
enfouie dans la plateforme. Le défaut du nœud est `gpt-realtime` ; le champ accepte n'importe quel
identifiant de modèle temps réel. Laissez-le vide et c'est le réglage
plateforme `VOICE_CALL_REALTIME_MODEL` qui s'applique. Si le modèle configuré est
indisponible, l'appel échoue avec une erreur explicite qui le nomme, pour que
vous sachiez quoi changer.

## Voix, accueil, instructions système

- **Voix** — ce que l'appelant entend. `marin` et `cedar` sont les plus
  naturelles au téléphone.
- **Message d'accueil** — la première phrase prononcée une fois l'appel
  connecté. Laissez vide pour que l'agent ouvre lui-même la conversation.
- **Instructions système** — le rôle et les règles. Dites ce que l'agent peut
  promettre et ce qu'il ne doit jamais inventer.
- **Titre de la page d'appel** — le titre vu par l'appelant. Vide, le nom du
  workflow est utilisé.

## Protection

Le lien est ouvert par défaut : c'est tout l'intérêt — un client clique et
parle, sans compte. Activer **Protection** oblige l'appelant à présenter
d'abord un jeton de session, via le mot de passe de partage ou la connexion
visiteur déjà configurés pour ce workflow. Laissez désactivé pour une ligne de
réservation publique ; activez pour une ligne interne.

## Ce que fait le graphe sous le déclencheur

Le chemin audio ne touche jamais le workflow. L'audio va du navigateur
directement au modèle vocal et revient : c'est ce qui garde une latence de
conversation.

Les nœuds branchés sous le déclencheur sont le **gestionnaire de délégation** :
ils s'exécutent chaque fois que le modèle vocal a besoin d'un vrai travail —
vérifier la disponibilité d'une table, enregistrer une réservation, retrouver
une commande. Leur sortie revient dans la session en **guidance** pendant que
la conversation continue, ce qui permet à l'agent d'agir et pas seulement de
discuter.

Lisez la charge utile de délégation avec `{event.*}` dans les nœuds en aval.

## Remarques

- Un nœud **Répondre** n'a pas de sens ici : la réponse de délégation est une
  guidance formatée par la plateforme, pas une réponse HTTP que vous rédigez.
- La transcription est conservée avec la session d'appel et consultable depuis
  Production.
- Des limites par workflow sur les appels simultanés et les appels par jour
  s'appliquent en plus du plafond de durée par appel.

## Exemple de workflow

Utilisez la carte ci-dessous pour créer un workflow Appel vocal qui traite les
demandes de réservation et enregistre ce que l'appelant a demandé.

---

*Source: https://agentbuilder.systalink.sn/docs/trigger-voice-call — human documentation.*
*Other language: [/docs-md/en/trigger-voice-call.md](/docs-md/en/trigger-voice-call.md).*
*Machine-readable index: [/llms.txt](/llms.txt).*