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.
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_typeetknowledge.textgardent leur valeur actuelle si vous les omettez. - Les collections sont remplacées.
capabilities,business_hours,transfer_rulesetscheduling.calendarssont 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. 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. 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.
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é dansparam.400 INVALID_REQUEST_BODY: un champ déclaré n'a pas passé la validation. Le champ fautif est danserrors[].400 MISSING_FIELD: une partie obligatoire d'une collection manque, nommée dansparam.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.timezonen'est pas un identifiant IANA.400 INVALID_PHONE_NUMBER:business_phonen'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 cevoice_id. Listez-les avec Lister les voix.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.