# Modifier la configuration

> Modifie toute partie de la configuration du réceptionniste, sauf le prompt et l'activation. Renvoie la configuration complète après l'écriture, dans la même…

`PATCH /v2/api/numbers/{number}/agent`

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

## Comportement

Modifie toute partie de la configuration du réceptionniste, sauf le prompt et l'activation. Renvoie la configuration complète après l'écriture, dans la même forme que [Lire la configuration](/fr/docs/agent/get-agent).

Deux règles de fusion s'appliquent :

- **Les valeurs simples sont fusionnées.** `name`, les informations sur l'activité, `language`, `voice_id`, `greeting_message`, `closing_message`, `tone_of_voice`, `answer_type` et `knowledge.text` gardent leur valeur actuelle si vous les omettez.
- **Les collections sont remplacées.** `capabilities`, `business_hours`, `transfer_rules` et `scheduling.calendars` sont des ensembles complets. Envoyez-en un et il remplace ce qui était configuré, omettez-le et il reste intact.

Pour ajouter une seule règle de transfert, lisez d'abord les règles existantes et renvoyez-les avec la nouvelle. Pour garder une capacité activée, incluez-la dans chaque map `capabilities` que vous envoyez.

Un champ que cet endpoint ne déclare pas est refusé avec `400 UNKNOWN_FIELD`, y compris les champs en lecture seule comme `custom_prompt`, `prompt_metadata` et `status`. Rien n'est ignoré en silence.

## Règles de transfert

`description` est le champ qui décide si un transfert fonctionne. Le réceptionniste compare ce que dit l'appelant à ce texte : écrivez-le comme le motif de l'appelant (« questions de facturation », « veut réserver une intervention »), pas comme une instruction adressée au réceptionniste.

Chaque règle a besoin de la cible qu'implique son `type` :

| Type | Champ requis | Destination |
|---|---|---|
| `EXTERNAL_NUMBER` | `target_number` | N'importe quel numéro, au format E.164 |
| `MEMBER` | `target_member_id` | Un membre de l'équipe, par son id issu de `GET /v2/api/users` |
| `INBOX` | `target_line_number` | Une autre de vos lignes Allo |

Visez une cible autre que la ligne que vous configurez. Une règle qui renvoie l'appelant vers la même ligne le rend au réceptionniste qui vient de le transférer, et l'appel boucle. L'API accepte une telle règle : c'est à vous de l'éviter.

Les règles sont recréées à chaque écriture : une erreur désigne l'entrée fautive par son index, par exemple `transfer_rules[1].description`.

## Horaires d'ouverture

`schedule` est obligatoire dès que vous envoyez `business_hours`. Les heures sont exprimées en secondes depuis minuit : 9h à 17h s'écrit `32400` à `61200`, et un jour absent de la liste est fermé.

## Agendas de réservation

`scheduling.calendars` est une map dont les clés sont des `id` d'agenda issus de [Lister les agendas](/fr/docs/agent/list-calendars). Un agenda que le réceptionniste n'a pas encore lui est rattaché, un agenda associé à `[]` reste rattaché sans type d'événement sélectionné, et un agenda absent de la map perd l'accès.

Les types d'événement viennent de [Lire un agenda](/fr/docs/agent/get-calendar). Renvoyez `id`, `slug`, `title` et `length_in_minutes` tels quels, et ajoutez votre propre `description` pour indiquer quand le réceptionniste doit réserver celui-là plutôt qu'un autre.

Connecter un agenda à l'espace de travail est un flux OAuth, réalisé dans l'app Allo. Cet endpoint choisit parmi les connexions qui existent déjà.

## Texte de connaissances

`knowledge.text` est déprécié. Ajoutez plutôt des sites web avec [Ajouter un site web](/fr/docs/agent/add-website-knowledge).

Il fonctionne toujours. Allo l'enregistre comme une source texte nommée « Business knowledge » dans la bibliothèque de connaissances de l'équipe, utilisée par cette ligne. Un texte différent modifie cette même source, et une chaîne vide la désactive pour cette ligne.

## Limites des champs

| Champ | Limite |
|---|---|
| `name`, `business_name`, `business_email`, `business_website`, `business_industry` | 64 caractères |
| `business_address` | 255 caractères |
| `greeting_message`, `closing_message` | 1000 caractères |
| `transfer_rules[].description` | 255 caractères |
| `transfer_rules[].transfer_message` | 1000 caractères |
| `knowledge.text` (déprécié) | 25000 caractères |

## Erreurs

- `400 UNKNOWN_FIELD` : un champ que cet endpoint n'accepte pas, nommé dans `param`.
- `400 INVALID_REQUEST_BODY` : un champ déclaré n'a pas passé la validation. Le champ fautif est dans `errors[]`.
- `400 MISSING_FIELD` : une partie obligatoire d'une collection manque, nommée dans `param`.
- `400 INVALID_AGENT_LANGUAGE` / `400 INVALID_AGENT_CAPABILITY` : une valeur inconnue. Les valeurs acceptées sont listées dans le message.
- `400 INVALID_TIMEZONE` : `business_hours.timezone` n'est pas un identifiant IANA.
- `400 INVALID_PHONE_NUMBER` : `business_phone` n'est pas un numéro exploitable.
- `400 AGENT_TRANSFER_RULE_TARGET_REQUIRED` : une règle n'a pas la cible qu'exige son type.
- `403 AGENT_TRANSFER_RULE_MEMBER_NO_LINE_ACCESS` : le membre visé n'a pas accès à cette ligne.
- `404 AGENT_VOICE_NOT_FOUND` : aucune voix ne porte ce `voice_id`. Listez-les avec [Lister les voix](/fr/docs/agent/list-voices).
- `404 AGENT_CALENDAR_NOT_FOUND` : un id d'agenda de la map n'est pas visible pour vous.
- `404 PHONE_NUMBER_NOT_FOUND` : ce numéro n'est pas un numéro auquel vous avez accès.
