Skip to main content

Documentation Index

Fetch the complete documentation index at: https://semantiks.mintlify.app/llms.txt

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

Before connecting your agent, make sure your Identity, Knowledge, and Skills are ready.
A well-configured agent gives users better answers from the first conversation.

Connect your agent to real users

The Connect page is organized into two tabs:
  • Channels — connect and manage the channels where your agent talks to users.
  • Messaging Behaviour — configure how your agent handles messages on each connected channel.
This is the step that turns your agent from “configured” into “live”.

Channels tab

The Channels tab is organized in 3 sections:
  • Channels: publish your agent in owned and external channels (Web Bubble, External Chat, WhatsApp, and others)
  • Integrations: connect external tools/services used by your operation
  • API: send and receive messages from your own systems

External Chat (fastest launch)

External Chat gives you a shareable URL you can send in seconds.
1

Go to Connect > Channels

Open your agent and navigate to the Connect page.
2

Open External Chat

Select the External Chat channel card.
3

Copy the public URL

In the Domain setup tab, find the Default URL card and click the copy button to copy the generated link.
4

Test as an end user

Open the link in an incognito window and run a few real use-case questions.
You can also connect a custom domain so users reach your External Chat at a branded URL like chat.example.com/ai-agent. See the External Chat page for full details on the Domain setup tab.

Web Bubble (embed in your website)

Use Web Bubble when you want the agent inside your own site.
1

Open Bubble channel

In Connect > Channels, open the Bubble card.
2

Generate credentials/snippets

The Console provides the snippet and keys needed for embedding.
3

Add snippet to your website

Paste the script where your implementation team manages site code.
4

Customize appearance

Configure brand settings like launcher style and welcome behavior.

Meta channels (WhatsApp, Messenger, Instagram)

The Connect page always displays a Meta section with three channel cards:
ChannelDescription
WhatsAppWhatsApp Business channel via Meta
MessengerFacebook Messenger channel via Meta
InstagramInstagram messaging channel via Meta
Each card shows a Connect button that opens the setup flow for that specific channel. You do not need to configure the Meta integration first — the cards are always visible so you can start the connection at any time.

Messaging Behaviour tab

The Messaging Behaviour tab lets you fine-tune how your agent processes incoming messages on each connected channel. Select a channel from the dropdown at the top of the tab to configure its settings. The tab is organized into two main configuration sections displayed side by side on larger screens (and stacked on smaller screens). Both sections are collapsible — click the section header to expand or collapse it, so you can focus on the settings you need.

Import configuration from another channel

When you have more than one channel connected, you can quickly replicate settings by importing the configuration from another channel. Use the “Import configuration from” dropdown to select a source channel. A confirmation banner appears showing which channel’s settings will be imported and into which target channel. Review the imported values, then click Save import to apply, or Discard to revert.
Importing is useful when you want consistent behaviour across channels — set up one channel first, then import its configuration into the others.

Message Debounce

The Message Debounce section (marked with a ⚡ icon) controls how long the agent waits before processing a burst of consecutive user messages as a single input. This is especially useful on messaging platforms where users tend to send several short messages in a row.
  • Use the slider or the preset buttons (0s, 1s, 3s, 5s, 8s, 10s, 15s) to set the debounce window.
  • A live preview shows how multiple messages are grouped and when the agent responds.
  • When the debounce is set above 0 seconds, a warning reminds you that the agent will wait before replying.
The debounce section is hidden for internal channels like the Playground and API Agent, where message grouping is not applicable.

File Preferences (Multimodal)

The File Preferences section (marked with a 📄 stacked-files icon) lets you control which file types your agent can receive and process on the selected channel. Supported file types include:
File typeDescription
DocumentsPDFs, Word files, and other text documents
ImagesPhotos and image files
AudioVoice notes and audio recordings
VideoVideo files and clips
For each file type you can:
  • Enable or disable reception with a toggle switch.
  • Configure scenarios — define specific instructions for how the agent should handle files of that type.
File preferences configured here affect the agent’s behaviour on the selected channel. Remember to configure them for each channel where you want multimodal support.