Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iblueprint.ai/llms.txt

Use this file to discover all available pages before exploring further.

iBlueprint lets you publish any Blueprint as a live chat interface and embed it on your website in minutes. Visitors interact with the chatbot through a floating widget or a full-page frame, and every message is processed by the Blueprint chain you configure — so the AI behavior, knowledge base access, and business logic are fully under your control.

​
Create a chatbot

1

Open Chatbots

From the main navigation, go to Chatbots and click New chatbot.
2

Name and describe your chatbot

  • Name (3–120 characters) — shown in the widget header and in your chatbot list.
  • Description (optional, up to 1,000 characters) — internal notes about what this chatbot does.
3

Connect a Blueprint

Select the Blueprint that will process each incoming message. Every chat message from a visitor becomes an input to that Blueprint chain, and the Blueprint’s final output is returned as the chatbot’s reply.
4

Choose an AI connection

Select the AI provider connection the chatbot should use by default for language model calls. You can use your own API key (BYOK) or a platform-provided connection.
5

Set visibility

  • Private — only you can see and use the chatbot.
  • Shared — accessible to members of your organization.
  • Public — accessible to anyone with the embed code or direct link.
6

Save

Click Create chatbot. iBlueprint provisions the chatbot and takes you to its settings page.

​
Customize the widget

Open the chatbot’s Widget tab to adjust its appearance and behavior.
  • Header title — the name shown at the top of the chat widget.
  • Welcome message — the first message visitors see when the chat opens.
  • Placeholder text — the hint text shown inside the message input field.
  • Primary color — the accent color for buttons and highlights (hex code).
  • Logo URL — your brand logo, displayed in the widget header.
  • Position — anchor the widget to the bottom-right or bottom-left corner of the page.
  • Show “Powered by iBlueprint” — toggle the iBlueprint attribution badge on or off.
Prevent abuse by capping how many messages a single visitor can send:
  • Max messages per minute
  • Max messages per hour
  • Max messages per day
Visitors who exceed a limit see a friendly message and can resume when the window resets.

​
Embed on your website

After creating the chatbot, go to the Embed tab to get your embed code. iBlueprint provides two options:
Paste this snippet just before the closing </body> tag of any page where you want the widget to appear:
<script
  src="https://cdn.iblueprint.io/widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>
The script loads asynchronously and renders a floating chat button. Visitors click the button to open the widget.
Replace YOUR_CHATBOT_ID with the ID shown on the chatbot’s Embed tab.

​
Configure CORS rules

By default, iBlueprint restricts which domains can load the chat widget. Add an allowed origin for each domain where you plan to embed the chatbot.
1

Open CORS settings

Go to the chatbot’s Security → CORS rules tab.
2

Add an allowed origin

Click Add origin and enter the full origin, including the scheme and port if non-standard:
https://www.your-company.com
3

Save

Click Save. iBlueprint immediately enforces the new rule for all embed requests.
Do not use a wildcard (*) for public chatbots that handle sensitive data or trigger backend actions. Always restrict origins to the specific domains you control.
You can update or delete CORS rules at any time without redeploying the embed code.

​
Collect visitor information with data capture forms

Data capture forms let you collect structured information from visitors during a chat session — for example, a name and email address before the conversation starts, or a support ticket category mid-conversation.
1

Open Data capture

Go to the chatbot’s Data capture tab and click New form.
2

Name the form

Give it a descriptive name (for example, Lead qualification or Pre-chat contact info).
3

Define the schema

Add the fields you want to collect. Each field has a name, type (string, number, boolean), and optional description. iBlueprint stores this as a JSON schema and uses it to validate responses.
4

Configure question mode

Choose whether the chatbot should ask questions one at a time (conversational) or display a form UI (structured). Use question mappings to control which question the AI asks for each field.
5

Activate the form

Toggle the form Active. iBlueprint begins presenting it to new visitors according to your configuration.
Captured responses are stored as sessions under the Data capture → Sessions tab. You can review responses, export them, or pass the collected data into downstream Blueprint nodes for further processing.