Publish call flow
Numéros de téléphone
Publier le flux d'appel
Publishes the working draft, making it the live call flow for the phone number. This changes live inbound routing immediately. Runs full validation, which is stricter than the lenient validation a draft save runs, so a draft that saved successfully can still fail to publish; the whole publish rolls back if validation fails. Publishing consumes the draft, so the line is left with no draft afterwards.
POST
Publish call flow
Scope requis :
PHONE_NUMBERS_WRITEComportement
Publie le brouillon de travail, ce qui en fait le flux d’appel en direct du numéro. Le paramètre de chemin{number} est le numéro Allo au format E.164.
Passez la lock_version du brouillon que vous publiez — récupérez-la avec Récupérer le brouillon du flux d’appel.
La publication exécute la validation complète, plus stricte que la validation souple appliquée à l’enregistrement d’un brouillon — un brouillon enregistré avec succès peut donc échouer à la publication. Si une règle échoue, toute la publication est annulée et le flux précédemment en direct continue de router les appels.
La publication consomme le brouillon : la version brouillon devient la version publiée, le numéro se retrouve donc sans brouillon et la réponse ne contient pas de confirmation_url. Commencez le cycle d’édition suivant par un nouveau PUT …/call_flow/draft.
Erreurs
400 CALL_FLOW_INVALID— le brouillon a échoué à la validation complète.400 CALL_FLOW_ROOT_MENU_TOO_SMALL— le numéro utilise un SVI et ce flux laisserait son menu avec moins de 2 options.400 CALL_FLOW_CONTACT_PROPERTY_KEY_REQUIRED— un nœudCONTACT_PROPERTYn’a pas depropertyKey.400 CALL_FLOW_CONTACT_PROPERTY_VALUE_REQUIRED— un nœudCONTACT_PROPERTYn’a pas d’expectedValue.400 CALL_FLOW_CONTACT_PROPERTY_UNKNOWN— lapropertyKeyd’un nœudCONTACT_PROPERTYne correspond à aucune propriété de personne personnalisée de votre équipe. Renommer ou supprimer une propriété dans le CRM invalide un flux qui s’appuie dessus.404 CALL_FLOW_DRAFT_NOT_FOUND— il n’y a aucun brouillon à publier. Enregistrez-en un d’abord avecPUT /v2/api/numbers/{number}/call_flow/draft.404 PHONE_NUMBER_NOT_FOUND— le numéro ne fait pas partie des numéros de votre compte.409 CALL_FLOW_STALE_LOCK— lalock_versionest périmée ; récupérez à nouveau le brouillon et réessayez.
Autorisations
Paramètres de chemin
Allo phone number in E.164 format
Exemple:
"+14155551234"
Corps
application/json
The lock_version of the draft you are publishing.
Exemple:
0
Réponse
The published call flow
A version of a phone number's call flow.