Ask AI widget

Install

One script tag, on every page where you want the Ask AI button. Replace YOUR_ASSISTANT_SLUG with your assistant's slug: the portal shows the line ready to copy on the assistant's Overview and under Install.

<script src="https://widget.almanzor.cloud/embed.js" data-agent-id="YOUR_ASSISTANT_SLUG" defer></script>

Static site generators and docs frameworks (Docusaurus, Mintlify, MkDocs, VitePress…) have a setting or a layout file for extra scripts in the page: add the same tag there.

Allowed domains

The widget only runs on sites you allow, so nobody can put your assistant on their page. When you create an assistant from a URL, that domain is allowed already. To add more (a staging site, a second domain), go to Install → MCP and API → Allowed domains in the portal.

• Sites that can show the assistant: the pages where the widget appears.
• Sites that can call the chat API: keep https://widget.almanzor.cloud in the list if you use the hosted widget.

Appearance

Under Install → Appearance: the name in the chat header and a role under it, the greeting, up to eight starter shortcuts, your brand color and logo, and whether the chat opens on its own when the page loads (off by default). Changes apply to the widget, the share link and the test chat.

Share link and QR code

Every published assistant also has its own page, useful for a support email, a README or a QR code on a slide:

https://almanzor.cloud/agent/YOUR_ASSISTANT_SLUG

The QR code for it is under Install → Web, link and QR.

WordPress

There's a plugin, so you don't have to edit your theme:

1. Download almanzor-cloud.zip from GitHub Releases and install it under Plugins → Add New.
2. In the portal, create an API key under Settings → API and integrations (Starter and up).
3. In WordPress, open Settings → Almanzor Cloud, paste the API key and your assistant's ID and slug, and test the connection.

More on the WordPress page (in Spanish).