Comportement
Crée ou met à jour le brouillon de travail du flux d'appel d'un numéro. Le brouillon est validé de manière souple et n'affecte pas le routage en direct tant qu'il n'est pas publié. Le paramètre de chemin {number} est le numéro Allo au format E.164.
Envoyez le document definition complet ainsi que la schema_version à laquelle il se conforme.
Sous-ensemble du moteur
engine_subset détermine quelle part de votre flux s'exécute sur les appels réels. Envoyez "engine_subset": "FULL_FLOW" pour tout flux que vous construisez via l'API.
| Valeur | Ce qui s'exécute sur un appel réel |
|---|---|
FULL_FLOW | L'arbre entier : chaque nœud et chaque branche de definition |
NESTED_IVR | Uniquement le menu téléphonique racine, et seulement sur une ligne déjà réglée pour répondre par un menu téléphonique. La publication remplace les touches de ce menu par celles de la racine du flux. Une touche qui mène à un sous-menu, une condition, une messagerie ou un raccrochage est retirée du menu en direct. Ce mode existe pour les lignes qui n'avaient qu'un menu téléphonique simple |
Si vous omettez engine_subset, Allo le déduit des nœuds. Un flux qui contient un nœud horaires d'ouverture, propriété de contact, indicatif pays ou envoi de SMS est FULL_FLOW. Tout autre flux est déduit en NESTED_IVR, même s'il contient des sous-menus, des sonneries et une réceptionniste IA : seul son menu racine s'exécuterait alors.
Une fois que le flux d'une ligne est FULL_FLOW, un brouillon ultérieur ne peut pas le rétrograder en NESTED_IVR : la requête conserve FULL_FLOW.
Mise en ligne
Enregistrer un brouillon ne modifie jamais le routage en direct. Deux façons de le mettre en ligne :
- Le publier vous-même avec Publier le flux d'appel, en passant la
lock_versionde cette réponse. Le routage des appels entrants en direct change immédiatement. - Le confier à une personne via la
confirmation_urlde cette réponse : un lien où un utilisateur connecté ouvre ce brouillon, le vérifie et le publie. Préférez cette option lorsqu'un humain doit approuver la modification.
Traitez la confirmation_url comme opaque : renvoyez-la telle quelle, ne la reconstruisez jamais à partir d'un hôte d'application codé en dur et ne l'analysez pas. (Elle n'est présente que lorsque le status de la réponse est DRAFT.)
Concurrence
lock_version: passez la valeur du brouillon que vous avez lu. Omettez-la (ou envoyeznull) pour mettre à jour le brouillon sans contrôle de concurrence. Une valeur périmée renvoie409 CALL_FLOW_STALE_LOCK.base_published_version: la version publiée sur laquelle repose votre modification. Lisez-la dans le champversionde Récupérer le flux d'appel quand sonstatusvautPUBLISHED. L'omettre signifie « aucune version publiée » : sur une ligne qui a déjà un flux publié, la requête renvoie409 CALL_FLOW_CONCURRENT_EDIT. La même erreur est renvoyée si quelqu'un a publié une nouvelle version pendant votre édition.
Erreurs
400 CALL_FLOW_SCHEMA_VERSION_MISMATCH:schema_versionne correspond pas à la version actuelle du serveur.400 CALL_FLOW_INVALID: ledefinitionest mal formé ou a échoué à la validation.404 PHONE_NUMBER_NOT_FOUND: le numéro ne fait pas partie des numéros de votre compte.409 CALL_FLOW_STALE_LOCK/409 CALL_FLOW_CONCURRENT_EDIT: voir Concurrence ci-dessus.