Conversation
| * A **channel** carries the conversations between your users and an [agent](../overview.mdx#ai-agent) | ||
| of your app: user messages reach the agent through the channel, and replies return the same way. | ||
| Quill offers four channel types: a chat widget on your site, or a bot on Telegram, Slack, or Discord, reaching your users where | ||
| Quill offers four channel types: a web widget channel with a chat box on your website, or a bot on Telegram, Slack, or Discord, reaching your users where |
There was a problem hiding this comment.
It can also be embeded in other places, e.g. an app
There was a problem hiding this comment.
/channels/overview:
"Quill offers four channel types: a web widget channel with a chat box embedded in your website or app"
/channels/web-widget (an additional bullet):
"The chat box can also be embedded in a phone app, in a component that displays web pages as a browser does.
This article follows the website case."
when the embed tab changes are applied I'll updated the Embed tab section with its capture and a few words about the app options.
| A different section is shown here for each channel type: | ||
| - For the web widget channel depicted here: the websites allowed to embed the chat box | ||
| (see [Editing the channel name and allowed origins](../../channels/web-widget.mdx#editing-the-channel-name-and-allowed-origins)). | ||
| - for a Telegram bot: the option to replace the bot token (see [Channels: Telegram bot](../../channels/telegram-bot.mdx#rotating-the-bot-token)). | ||
| - for a Slack bot: the option to rotate the credentials (see [Channels: Slack bot](../../channels/slack-bot.mdx#rotating-the-credentials)). | ||
| - for a Discord bot: the option to replace the bot token (see [Channels: Discord bot](../../channels/discord-bot.mdx#rotating-the-bot-token)). |
There was a problem hiding this comment.
The last three points aren't related to allowed origins at all
There was a problem hiding this comment.
clarified (it's a general channels-view page, so it has to explain that this section changes for each channel type)
-->
The websites allowed to embed the chat box (see Editing the channel name and allowed origins).
This area of the form holds a different section for each channel type:
- For a Web widget: the allowed origins, as depicted above.
- For a Telegram bot: the option to replace the bot token.
- For a Slack bot: the option to rotate the credentials.
- For a Discord bot: the option to replace the bot token.
|
|
||
| A web widget channel is added using Quill's management dashboard, in a short form that asks you to: | ||
| * Select the agent that will answer the chat box's users. | ||
| * Give the channel a name (optional). |
There was a problem hiding this comment.
text updated, captures will have to wait for a working version that includes the change.
| and further messaging will be disabled. | ||
| A new conversation requires a new embed link. | ||
|
|
||
|  |
There was a problem hiding this comment.
Usually it's the same page, just accessed by different users
There was a problem hiding this comment.
added a "Two ways to generate the link" section with the two options explained and a diagram for each.
|
|
||
| #### The link is unknown: | ||
|
|
||
| The channel was deleted, or the link expired long ago and Quill has removed its record. |
There was a problem hiding this comment.
I think we should be precise with expiration time here
There was a problem hiding this comment.
-->
The channel was deleted, or the link expired and its record was already removed.
Quill removes an expired link's record about a minute after it expires.
And in "The link has expired or was revoked, or the channel is paused":
-->
An expired link shows this notice for about a minute, until Quill removes its record.
|
|
||
| - When the agent receives a chat box user's question over the channel, the agent forwards the question to the LLM. | ||
| - While composing an answer, the LLM may send the agent a query request, naming the query tool to use. | ||
| The agent will find the requested tool in its configuration, fetch the [RQL](/7.2/querying/rql/what-is-rql) query |
There was a problem hiding this comment.
Let's use an absolute, versionless URL here
There was a problem hiding this comment.
| Strings and numbers are entered in a text field. | ||
| Booleans are set using a toggle. | ||
| Arrays are entered one value at a time using the **Add value** button. | ||
| A **Null** parameter requires no value. |
There was a problem hiding this comment.
I wouldn't mention null parameter here, it's a bug that it's visible on the list
2 participants
Issue link
RDoc-4102 add a web widget channel page
RDoc-4112 rename channel and interface names
Type of change
/templatesor readme)Changes in docs URLs
/scripts/redirects.jsonfile, setDocuments MovedPR label)Changes in UX/UI