Chaque ligne Allo a un réceptionniste IA. Ces endpoints lisent toute sa configuration en un appel et en modifient chaque partie : informations sur l'activité, voix et langue, prompt avec lequel il répond, ce qu'il a le droit de faire pendant un appel, horaires d'ouverture, règles de transfert, agendas sur lesquels il réserve, et ce qu'il sait de votre activité.
Connectez le MCP Allo à votre assistant IA : configurer un réceptionniste devient une conversation sur votre activité au lieu d'une série de requêtes à écrire. Ce sont les mêmes endpoints que cette page, avec une bien meilleure expérience.
Comment la configuration est organisée
GET /v2/api/numbers/{number}/agent répond à la question « comment ce réceptionniste est-il configuré ? » en une réponse, découpée en sept blocs.
| Bloc | Ce qu'il contient |
|---|---|
agent | Qui est le réceptionniste : nom, informations sur l'activité, langue, voix, message d'accueil et de fin, ton, longueur des réponses. Ainsi que son status, en lecture seule ici. |
prompt | Ce qu'il cherche à obtenir et comment il se comporte, en six sections. Modifié par son propre endpoint. |
capabilities | Ce qu'il a le droit de faire pendant un appel : SCHEDULING, CALL_TRANSFER, WARM_TRANSFER. |
business_hours | Les horaires d'ouverture, jour par jour, dans le fuseau que vous définissez. |
transfer_rules | Les motifs pour lesquels il transfère un appel, et la destination de chacun. |
scheduling | Les agendas sur lesquels il réserve, avec les types d'événement sélectionnés pour chacun. |
knowledge | Les informations à partir desquelles il répond : sites web et documents importés de la bibliothèque de connaissances de l'équipe, et text, qui est déprécié. |
Deux règles de fusion
PATCH /v2/api/numbers/{number}/agent applique deux règles différentes, et les confondre est la seule erreur qui fait perdre de la configuration :
- 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.
Ajouter une seule règle de transfert suppose donc de lire les règles existantes et de les renvoyer avec la nouvelle. Même chose pour les capacités : une capacité absente de la map est désactivée, pas conservée.
Un champ que l'API ne connaît pas est refusé avec 400 UNKNOWN_FIELD plutôt qu'ignoré, pour qu'une faute de frappe ne réponde jamais 200 OK.
Écrire le prompt
Le prompt a son propre endpoint parce qu'il n'est valide qu'entier. objective, personality et behaviors sont obligatoires, et chaque écriture régénère le prompt avec lequel le réceptionniste répond : Définir le prompt remplace donc la liste complète des sections.
Les informations factuelles sur l'activité vont dans knowledge, pas dans le prompt. Tarifs, horaires, règles et questions fréquentes changent souvent et doivent se trouver là où le réceptionniste va les chercher.
Ce que cette API ne fait pas
- Importer des documents. Les fichiers s'importent dans l'app Allo. Ici, vous les listez et les supprimez.
- Connecter un agenda. C'est un flux OAuth, réalisé dans l'app Allo. Ici, vous listez ce qui est connecté et choisissez sur quoi le réceptionniste réserve.
- Créer un réceptionniste. Une ligne en a un dès qu'elle existe.
Endpoints
Toute la configuration du réceptionniste d'une ligne, en un appel
Informations, voix, capacités, horaires, règles de transfert, agendas, texte de connaissances
Remplacer les sections du prompt avec lequel le réceptionniste répond
Mettre le réceptionniste sur la ligne, ou renvoyer les appels vers votre téléphone professionnel
Explorer un site web pour que le réceptionniste puisse en tirer ses réponses
Désactiver un site pour cette ligne sans perdre son contenu extrait
Retirer un site web de la bibliothèque de connaissances de l'équipe
Retirer un document importé de la bibliothèque de connaissances de l'équipe
Les agendas connectés à votre espace de travail
Un agenda avec les types d'événement proposés par son fournisseur
Les voix avec lesquelles un réceptionniste peut parler