Skip to main content
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 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.