Add website knowledge
AI Receptionist
Add website knowledge
Adds a page to the receptionist’s knowledge. Allo scrapes and summarizes it during the request, so the call takes a few seconds. Up to 5 websites per receptionist.
POST
Add website knowledge
Required scope:
AGENTS_WRITEBehavior
Adds a page to the receptionist’s knowledge. Allo scrapes it and summarizes it during the request, so this call takes a few seconds and returns201 with the entry once the page has been read.
Send an absolute http(s) URL of a publicly reachable page. A receptionist holds up to 5 websites, and the same URL cannot be added twice.
The response never carries the scraped text. That text is what the receptionist reads, not something you configure.
Point it at the page that carries the answers, not at the site root. Only the page you send is read.
Errors
400 INVALID_KNOWLEDGE_URL: the URL is malformed or cannot be scraped.409 AGENT_KNOWLEDGE_ALREADY_EXISTS: this receptionist already has an entry for that URL.409 AGENT_KNOWLEDGE_LIMIT_REACHED: the receptionist already holds 5 websites. Delete one first.500 AGENT_KNOWLEDGE_SCRAPE_FAILED: the page could not be read. This one is retryable, so try again in a few seconds and check the page is publicly reachable.404 PHONE_NUMBER_NOT_FOUND: the number is not one you have access to.
Authorizations
Path Parameters
Allo phone number in E.164 format
Example:
"+14155551234"
Body
application/json
An absolute http(s) URL of a publicly reachable page.
Example:
"https://acme.test/pricing"
Response
The entry that was created
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.