Définir le prompt
Replaces the receptionist’s prompt: what it is trying to achieve, who it is, how it handles the call. A prompt is only valid whole, so read the current sections with GET /v2/api/numbers/{number}/agent and send them all back, including the ones you are not changing. Facts about the business belong in knowledge, not here.
AGENTS_WRITEComportement
Remplace le prompt du réceptionniste : ce qu’il cherche à obtenir, qui il est et comment il mène l’appel. Un prompt n’est valide qu’entier, et chaque écriture régénère ce avec quoi le réceptionniste répond. Lisez donc les sections actuelles avec Lire la configuration et renvoyez-les toutes, y compris celles que vous ne modifiez pas. La réponse renvoie le prompt avec untitle dérivé côté serveur de chaque clé section.
Sections
required_fields est la seule section qui porte fields au lieu de content, avec une entrée par information que le réceptionniste doit recueillir. Toutes les autres sections portent un content non vide et pas de fields. Chaque section apparaît au maximum une fois, et content accepte jusqu’à 3000 caractères.
Les trois sections obligatoires sont le minimum imposé par l’API, pas le prompt dont une activité a besoin. Un réceptionniste sans section prohibited n’a jamais appris ce qu’il ne doit pas dire.
Ce qui se place ailleurs
Les informations factuelles sur l’activité vont dansknowledge sur Modifier la configuration, pas ici. Tarifs, horaires, règles et questions fréquentes changent souvent, et le réceptionniste va les y chercher au lieu de les réciter depuis le prompt.
Le message d’accueil et le message de fin ont eux aussi leurs propres champs. Allo gère déjà l’accueil, la clôture, le changement de langue, la confirmation des coordonnées, le transfert et la mécanique de réservation : les répéter dans le prompt dégrade l’appel au lieu de l’améliorer.
Erreurs
400 PROMPT_SECTIONS_REQUIRED:sectionsest absent ou vide. Il remplace tout le prompt et doit donc porter chaque section à conserver.400 INVALID_AGENT_PROMPT_SECTION: une clé de section inconnue. Les valeurs acceptées sont listées dans le message.400 DUPLICATE_AGENT_PROMPT_SECTION: une section apparaît plusieurs fois.400 INVALID_AGENT_PROMPT_SECTION_BODY: une section porte le mauvais corps, par exemplefieldssurobjective.400 MISSING_AGENT_PROMPT_SECTION:objective,personalityoubehaviorsest absent ou vide.400 AGENT_PROMPT_SECTION_TOO_LONG: lecontentd’une section dépasse 3000 caractères.400 AGENT_PROMPT_TOO_LONG: le prompt généré depuis toutes les sections dépasse 25000 caractères.404 PHONE_NUMBER_NOT_FOUND: ce numéro n’est pas un numéro auquel vous avez accès.
Autorisations
Paramètres de chemin
Allo phone number in E.164 format
"+14155551234"
Corps
Replaces the whole prompt. objective, personality and behaviors are required; each section may appear once; a content section holds at most 3000 characters.
Réponse
The prompt after the write, with server-derived titles
The receptionist's prompt. Exactly one of the two keys is present: sections for a prompt written in the section format, custom_prompt for an older line whose prompt was written as freeform text. custom_prompt is the render of the sections, so it is never reported alongside them.