Skip to main content
PUT
Set the AI receptionist prompt
Scope requis : AGENTS_WRITE

Comportement

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 un title 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 dans knowledge 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 : sections est 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 exemple fields sur objective.
  • 400 MISSING_AGENT_PROMPT_SECTION : objective, personality ou behaviors est absent ou vide.
  • 400 AGENT_PROMPT_SECTION_TOO_LONG : le content d’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

Authorization
string
header
requis

Paramètres de chemin

number
string
requis

Allo phone number in E.164 format

Exemple:

"+14155551234"

Corps

application/json

Replaces the whole prompt. objective, personality and behaviors are required; each section may appear once; a content section holds at most 3000 characters.

sections
object[]
requis

Réponse

The prompt after the write, with server-derived titles

data
object

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.