Skip to main content
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é.
Scopes requis : AGENTS_READ pour lire, AGENTS_WRITE pour écrire. Créez une clé avec ces scopes dans Paramètres > API.

Laissez le MCP Allo le configurer pour vous

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.

​
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_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.
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

Lire la configuration

Toute la configuration du réceptionniste d’une ligne, en un appel

Modifier la configuration

Informations, voix, capacités, horaires, règles de transfert, agendas, texte de connaissances

Définir le prompt

Remplacer les sections du prompt avec lequel le réceptionniste répond

Activer ou désactiver

Mettre le réceptionniste sur la ligne, ou renvoyer les appels vers votre téléphone professionnel

Ajouter un site web

Analyser une page pour que le réceptionniste puisse en tirer ses réponses

Activer ou désactiver un site

Désactiver une entrée sans perdre son contenu analysé

Supprimer un site web

Retirer une page analysée des connaissances du réceptionniste

Supprimer un document

Retirer un document importé des connaissances du réceptionniste

Lister les agendas

Les agendas connectés à votre espace de travail

Lire un agenda

Un agenda avec les types d’événement proposés par son fournisseur

Lister les voix

Les voix avec lesquelles un réceptionniste peut parler