Passer au contenu principal
POST
Add website knowledge
Scope requis : AGENTS_WRITE

Comportement

Ajoute un site web aux connaissances du réceptionniste. Allo explore le site à partir de l’URL envoyée. L’exploration se fait en arrière-plan : l’appel renvoie 201 tout de suite avec l’entrée (statut ACTIVE). Le réceptionniste peut répondre à partir du site une fois l’indexation terminée. Si l’exploration échoue, l’API ne le signale pas. Envoyez l’URL d’un site accessible publiquement. Une URL sans http:// ni https:// est enregistrée en https://. Le nombre de sites web n’est pas limité, mais la même URL ne peut pas être ajoutée deux fois sur une ligne. Les sites web appartiennent à la bibliothèque de connaissances de votre équipe. Si une autre ligne de l’équipe a déjà ajouté cette URL, Allo relie le site existant à cette ligne au lieu de l’explorer à nouveau. La réponse ne contient jamais le texte extrait. Ce texte est ce que le réceptionniste lit, pas quelque chose que vous configurez.

Erreurs

  • 400 INVALID_KNOWLEDGE_URL : l’URL n’a pas d’hôte public (par exemple acme au lieu de acme.com).
  • 409 AGENT_KNOWLEDGE_ALREADY_EXISTS : cette ligne utilise déjà un site web avec cette URL.
  • 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
url
string
requis

The URL of a publicly reachable site. A URL without a scheme is stored as https://.

Exemple:

"https://acme.test/pricing"

Réponse

The entry that was created

data
object

A website of the team's knowledge library, crawled for the receptionist to answer from. The crawled text itself is not reported: it is what the receptionist reads, not something you configure.