Passer au contenu principal
POST
Publish call flow
Scope requis : PHONE_NUMBERS_WRITE

Comportement

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.
Cette route modifie immédiatement le routage des appels entrants en direct. Si vous préférez qu’une personne confirme la modification, n’appelez pas cette route : Enregistrer le brouillon du flux d’appel renvoie une confirmation_url où un utilisateur connecté vérifie le brouillon et le publie lui-même.
La publication conserve l’engine_subset du brouillon. Un flux NESTED_IVR n’exécute que son menu téléphonique racine sur les appels réels : enregistrez le brouillon avec "engine_subset": "FULL_FLOW" pour exécuter l’arbre entier. Voir Sous-ensemble du moteur. 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œud CONTACT_PROPERTY n’a pas de propertyKey.
  • 400 CALL_FLOW_CONTACT_PROPERTY_VALUE_REQUIRED : un nœud CONTACT_PROPERTY n’a pas d’expectedValue.
  • 400 CALL_FLOW_CONTACT_PROPERTY_UNKNOWN : la propertyKey d’un nœud CONTACT_PROPERTY ne 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 avec PUT /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 : la lock_version est périmée ; récupérez à nouveau le brouillon et réessayez.

Autorisations

Authorization
string
header
requis

Paramètres de chemin

number
string
requis

Allo phone number in E.164 format

Exemple:

"+14155551234"

Corps

application/json
lock_version
integer
requis

The lock_version of the draft you are publishing.

Exemple:

0

Réponse

The published call flow

data
object

A version of a phone number's call flow.