Skip to main content
POST
Add website knowledge
Scope requis : AGENTS_WRITE

Comportement

Ajoute une page aux connaissances du réceptionniste. Allo l’analyse et la résume pendant la requête : l’appel prend quelques secondes et renvoie 201 avec l’entrée une fois la page lue. Envoyez une URL http(s) absolue d’une page accessible publiquement. Un réceptionniste accepte jusqu’à 5 sites web, et la même URL ne peut pas être ajoutée deux fois. La réponse ne contient jamais le texte analysé. Ce texte est ce que le réceptionniste lit, pas quelque chose que vous configurez. Visez la page qui porte les réponses, pas la racine du site. Seule la page envoyée est lue.

Erreurs

  • 400 INVALID_KNOWLEDGE_URL : l’URL est mal formée ou ne peut pas être analysée.
  • 409 AGENT_KNOWLEDGE_ALREADY_EXISTS : ce réceptionniste a déjà une entrée pour cette URL.
  • 409 AGENT_KNOWLEDGE_LIMIT_REACHED : le réceptionniste a déjà 5 sites web. Supprimez-en un d’abord.
  • 500 AGENT_KNOWLEDGE_SCRAPE_FAILED : la page n’a pas pu être lue. Cette erreur est réessayable : retentez dans quelques secondes et vérifiez que la page est accessible publiquement.
  • 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

An absolute http(s) URL of a publicly reachable page.

Exemple:

"https://acme.test/pricing"

Réponse

The entry that was created

data
object

A page Allo scraped and summarized for the receptionist to answer from. The scraped text itself is not reported: it is what the receptionist reads, not something you configure.