# Enregistrer le brouillon du flux d'appel

> 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…

`PUT /v2/api/numbers/{number}/call_flow/draft`

<Note>
**Scope requis :** `PHONE_NUMBERS_WRITE`
</Note>

## 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](/fr/docs/phone-numbers/publish-call-flow), en passant la `lock_version` de cette réponse. Le routage des appels entrants en direct change immédiatement.
- **Le confier à une personne** via la **`confirmation_url`** de 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 envoyez `null`) pour mettre à jour le brouillon sans contrôle de concurrence. Une valeur périmée renvoie `409 CALL_FLOW_STALE_LOCK`.
- `base_published_version` : la version publiée sur laquelle repose votre modification. Lisez-la dans le champ `version` de [Récupérer le flux d'appel](/fr/docs/phone-numbers/get-call-flow) quand son `status` vaut `PUBLISHED`. L'omettre signifie « aucune version publiée » : sur une ligne qui a déjà un flux publié, la requête renvoie `409 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_version` ne correspond pas à la version actuelle du serveur.
- `400 CALL_FLOW_INVALID` : le `definition` est 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.
