# Welcome

**Welcome to our documentation!** We hope you find the answers you're looking for and discover helpful information for future reference. If you have any questions, feel free to reach out to us at **<support@tailrec.io>**.

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>My Quizzes</strong></td><td>The Ultimate Slack Native Quiz</td><td></td><td></td><td><a href="/getting-started/quickstart">Quickstart</a></td></tr><tr><td><strong>General Tips &#x26; Tricks</strong></td><td>Helpful Tips and Tricks</td><td></td><td></td><td><a href="/general-tips-and-tricks">General Tips &amp; Tricks</a></td></tr><tr><td><strong>Troubleshooting</strong></td><td>Common Issues and Solutions</td><td></td><td></td><td><a href="/basics/editor">Basics</a></td></tr></tbody></table>


# Quickstart

<figure><img src="https://gitbookio.github.io/onboarding-template-images/quickstart-hero.png" alt=""><figcaption></figcaption></figure>

Beautiful documentation starts with the content you create — and GitBook makes it easy to get started with any pre-existing content.

{% hint style="info" %}
Want to learn about writing content from scratch? Head to the [Basics](https://github.com/GitbookIO/onboarding-template/blob/main/getting-started/broken-reference/README.md) section to learn more.
{% endhint %}

### Import

GitBook supports importing content from many popular writing tools and formats. If your content already exists, you can upload a file or group of files to be imported.

<div data-full-width="false"><figure><img src="https://gitbookio.github.io/onboarding-template-images/quickstart-import.png" alt=""><figcaption></figcaption></figure></div>

### Sync a repository

GitBook also allows you to set up a bi-directional sync with an existing repository on GitHub or GitLab. Setting up Git Sync allows you and your team to write content in GitBook or in code, and never have to worry about your content becoming out of sync.


# Publish your docs

Once you’ve finished writing, editing, or importing your content, you can publish your work to the web as a docs site. Once published, your site will be accessible online only to your selected audience.

You can publish your site and find related settings from your docs site's homepage.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/publish-hero.png" alt=""><figcaption></figcaption></figure>


# Franky


# Franky's OAuth Scopes

We request only the scopes that are currently needed by My Intros. If additional scopes are required due to the addition of new functionalities, we will need to resubmit the application to Slack. As a result, you will need to reinstall My Intros and provide consent again in order to access the new functionalities.

| Scope                | Reason                                                                                                                                                                                                                                                |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| channels:join        | Enables the bot to automatically join a public channel upon receiving a user request.                                                                                                                                                                 |
| channels:read        | Enables the bot to read the information of a public channel and test its accessibility. This scope **doesn't** provide the bot with the ability to read messages in a channel.                                                                        |
| chat:write           | Enables the bot to send messages as "@Franky" (itself), delete or update its own messages. This is a crucial capability that allows the bot to effectively communicate with users.                                                                    |
| chat:write.customize | Enables the bot to send messages as "@Franky" using a user profile and name. This capability allows the bot to post updates on behalf of users.                                                                                                       |
| commands             | Enables the bot to support slash command features. You can view all available commands in the bot's home tab, specifically in the "About" section.                                                                                                    |
| groups:read          | Enables the bot to access the information of private channels it has been added to (excluding the channel content). This capability is necessary to retrieve the member list of the private channel.                                                  |
| mpim:read            | Enables the bot to access the information of groups it has been added to (excluding the group content). This capability is necessary to retrieve the member list of the group.                                                                        |
| users:read           | Enables the bot to access user information, including user name, time zone, locale, avatar, and status. The bot does not receive user email. User information is not stored in our database, but it may be temporarily cached to enhance performance. |
| users:read:email     | Enables the bot to access user email. We will never share your email or personal information. Your email is solely used to communicate with you regarding the plan and updates.                                                                       |

To learn more about app permissions and understand how they work, please visit the following page: [Understand app permissions](https://slack.com/help/articles/115003461503-Understand-app-permissions).


# Elegant Chat

Enhance your writing with ease. Our app provides real-time grammar corrections, style improvement, and vocabulary enhancements to help you write like a language expert.

To get started, simply pass your chat message to the <mark style="color:orange;">`/chat`</mark> command. The app will polish your message and post it on your behalf, making it appear as though you crafted the elegant message yourself. No one will know you're using the app unless you choose to share that secret.Example:

> <mark style="color:orange;">/chat</mark> Make this message more elegant\ <mark style="color:orange;">/e</mark> Use '/e' instead of '/chat' to save keystrokes

For a seamless experience, no complex setup is needed. The default settings work perfectly out of the box. However, if you're curious about customization options, feel free to explore <mark style="color:orange;">`/chat settings`</mark> or use the settings wizard below.


# Post a Message Elegantly

Learn how to use real-time language improvement tools through the command line.

## Basic Usage

Using this app is as easy as pie  - just type the command in any channel:

> <mark style="color:orange;">`/chat`</mark>

Or provide the text in one go:

> <mark style="color:orange;">`/chat`</mark>` ``put your text here`

When you use /chat followed by your message, the app will apply the default linguist action you've set. If you haven't set one, the factory default is Proofread. You can override the default linguist action directly within the command. For more details, see the command reference.

You don't even need to invite the app to the channel, whether it’s public, private, group chat, or even DM. It just works.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FTg4SqFzbYwSxsxkgXTd4%2Fquick-guide-1.gif?alt=media&amp;token=b2a1c696-1543-4285-bdcf-e1f1254e8d81" alt=""><figcaption></figcaption></figure>

## Chat Using a Different Language

If the common language in your organization differs from your native language and you're not comfortable chatting in the common language, you can use the translation feature. To make this easier, set the default linguist action to Translate, so you won’t need to provide the override argument every time.

> <mark style="color:orange;">`/chat`</mark>`ฉันสามารถใช้ภาษาที่ฉันถนัดในการคุยได้`

If translation isn’t your primary use case, you can override the linguist action by adding an argument right after the command, like this:

> <mark style="color:orange;">`/chat`</mark><mark style="color:green;">`translate`</mark>`ฉันสามารถใช้ภาษาที่ฉันถนัดในการคุยได้`

Or you can use the shorthand version of the linguist action.

> <mark style="color:orange;">`/chat`</mark><mark style="color:green;">`t`</mark>` ``ฉันสามารถใช้ภาษาที่ฉันถนัดในการคุยได้`

## Elegantly Speedy Chat

If you choose Proofread or Correct Grammar as your default action, it’s generally safe, so you may want to skip the preview for a quicker, smoother chat experience. Typing <mark style="color:orange;">`/chat`</mark> can feel a bit long, so you can use <mark style="color:orange;">`/e`</mark> instead — a shorthand for Elegant Chat.&#x20;

Let Elegant Chat handle the elegance of your messages.Start using <mark style="color:orange;">`/e`</mark> instead of <mark style="color:orange;">`/chat`</mark> for all your posts!


# Reply to a Message Elegantly

Slack doesn’t support slash commands in threads, but you can still reply elegantly using a shortcut.

## How to Reply Using Elegant Chat

The <mark style="color:orange;">/chat</mark> command doesn’t work in threads due to [Slack's limitations](https://api.slack.com/interactivity/slash-commands), not ours. To reply, use the message shortcut instead:

1. Hover over the message you want to reply to.
2. Look for the quick actions that appear in the upper right corner of the message.
3. Click the three vertical dots to access more options.
4. Select the Reply elegantly shortcut. If you don’t see it, click More message shortcuts... and find Reply elegantly in the list.

After selecting the Reply elegantly shortcut, a modal dialog will appear. You can override the default action and preview your message, just like when using the <mark style="color:orange;">`/chat`</mark> command.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FaQnNcqoopkU0eDbMvJY0%2Fquick-guide-2.gif?alt=media&amp;token=495d84df-65fa-496b-8c7e-269be730ecc3" alt=""><figcaption></figcaption></figure>


# Translate Any Message with One Click

You can easily translate and summarize any message by hovering over it and selecting the Translate shortcut from the quick action menu in the upper right corner. You can also customize the language you want the app to translate into. By default, it will use the Primary Language you've set in the app settings.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FJL1QaB0yH9rtA0tkbzbD%2Fquick-guide-3.gif?alt=media&amp;token=3deb55f2-a6b4-41c6-b0c0-0164a43974d0" alt=""><figcaption></figcaption></figure>


# A Quick Command Cheat Sheet

## Basic Usage

The chat command works right out of the box:

> <mark style="color:orange;">`/chat`</mark>` ``your text`

The text you provide will be edited to enhance overall readability and effectiveness.\
If you use the command without any text, the app will prompt you for input, giving you the option to override the default action:

> <mark style="color:orange;">`/chat`</mark>

## Overriding Default Action

You can change the default action to one you use frequently.

* If you just want to correct grammar and typos, set the default action to <mark style="background-color:yellow;">**Correct Grammar.**</mark>
* If your native language differs from the one used in your workplace, you can set the default action to <mark style="background-color:yellow;">**Translate**</mark><mark style="background-color:yellow;">.</mark>

Occasionally, you might want to override the default action for linguistic work you don't often use. You can do this by providing the argument directly after the /chat command, like so:

> <mark style="color:orange;">`/chat`</mark><mark style="color:green;">`translate`</mark>`ฉันชอบกินผัดไทยกุ้ง`\ <mark style="color:orange;">`/chat`</mark><mark style="color:green;">`edit`</mark>`I go to the office every day`

You can also use shorthand for the linguist actions:

> <mark style="color:orange;">`/chat`</mark><mark style="color:green;">`t`</mark>`ฉันชอบกินผัดไทยกุ้ง` -- t is a shorthand for 'translate'\ <mark style="color:orange;">`/chat`</mark><mark style="color:green;">`e`</mark>`I go to work every day` -- e is a shorthand for 'edit'

Read more about [the action shorthands here](/elegant-chat/built-in-linguist-actions).

If the first word of your sentence matches a linguist action and you want it to be treated as part of the sentence, enclose your sentence in double quotes like this:

> <mark style="color:orange;">`/chat`</mark>` ``"translate this into Thai"`

In this case, **"translate"** is part of your sentence and won't be used as an action intent.


# Built-in Linguist Actions

## Linguist Actions

* <mark style="background-color:yellow;">**Edit**</mark> <mark style="color:green;">`edit`</mark> or <mark style="color:green;">`e`</mark>: Improve clarity and coherence by adjusting sentences, changing word choices, and reorganizing content. This process enhances overall readability and effectiveness.
* <mark style="background-color:yellow;">**Proofread**</mark> <mark style="color:green;">`proofread`</mark> or <mark style="color:green;">`pr`</mark>: Check for spelling, grammar, punctuation, and typographical errors to ensure the text is polished and error-free. This helps maintain professionalism and accuracy.
* <mark style="background-color:yellow;">**Rephrase**</mark> <mark style="color:green;">`rephrase`</mark> or <mark style="color:green;">`r`</mark>: Express the same ideas in different words to improve clarity or engagement. This can help make complex or repetitive text more accessible and interesting.
* <mark style="background-color:yellow;">**Correct Grammar**</mark> <mark style="color:green;">`correct`</mark> or <mark style="color:green;">`c`</mark>: Specifically focusing on fixing grammatical errors in the text. This includes correcting sentence structure, verb tenses, subject-verb agreement, and other grammatical issues.
* <mark style="background-color:yellow;">**Polish**</mark> <mark style="color:green;">`polish`</mark> or <mark style="color:green;">`pl`</mark>: Refining the text to enhance its overall quality, including fine-tuning language, style, and tone to make it more engaging or professional.
* <mark style="background-color:yellow;">**Translate**</mark> <mark style="color:green;">`translate`</mark> or <mark style="color:green;">`t`</mark>: Converting text from one language to another while preserving the meaning and context. This involves understanding both the source and target languages.

You can override the action by specifying the name in a red block, like <mark style="color:green;">`translate`</mark> or <mark style="color:green;">`t`</mark> for short, in the command line when you want to translate instead of performing another action.

**Example:**&#x20;

> <mark style="color:orange;">`/chat`</mark><mark style="color:green;">`t`</mark>`We can translate between a wide variety of languages.`

The `t` argument is special because it overrides your default action with the translation action.


# Elegant Chat's OAuth Scopes

We request only the scopes that are currently needed by Elegant Chat. If additional scopes are required due to the addition of new functionalities, we will need to resubmit the application to Slack. As a result, you will need to reinstall the app and provide consent again in order to access the new functionalities.

| Scope            | Reason                                                                                                                                                                                                                                                                                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| chat:write       | Enables the bot to send messages as "@Elegant Chat" (itself), delete or update its own messages. This is a crucial capability that allows the bot to effectively communicate with users.                                                                                                                                  |
| commands         | Enables the bot to support slash command features. You can view all available commands in the bot's home tab, specifically in the "About" section.                                                                                                                                                                        |
| users:read       | Enables the bot to access user information, including user name, time zone, locale, avatar, and status. User information is not stored in our database, but it may be temporarily cached to enhance performance.                                                                                                          |
| users:read:email | Enables the bot to access user email. We use this information to protect your billing details, ensuring that others in your organization can't access your billing information. We will never share your email or personal information. Your email is solely used to communicate with you regarding the plan and updates. |

To learn more about app permissions and understand how they work, please visit the following page: [Understand app permissions](https://slack.com/help/articles/115003461503-Understand-app-permissions).


# My Quizzes

The Ultimate Slack Native Quiz


# Quiz Types

Currently, there are two types of quizzes that you can create, and you can change the quiz type at any time. The only thing affected by this change is your future quiz sessions. Feel free to explore, as you can change your mind at any time.

### Interactive Quiz <a href="#interactive-quiz" id="interactive-quiz"></a>

This quiz type resembles Kahoot!, where all participants must respond to the same question within the time limit (if applicable). Essentially, everyone progresses at the same pace, creating a competitive game-like atmosphere. If a time limit isn't specified, the quiz moderator must manually click "Next" to proceed to the next question

### Standard Quiz <a href="#standard-quiz" id="standard-quiz"></a>

This quiz type is designed for a traditional setting where participants can proceed at their own pace, akin to a paper quiz where each individual has their own copy. Your answers are private, and you have the freedom to skip questions and return to them later, or even opt not to start the quiz at all. The quiz moderator may set a deadline for completion, requiring participants to finish before it expires for their answers to be accepted. Various configurations set by the quiz moderator determine the actions participants can and cannot take.


# Creating a New Quiz

You can easily create a new quiz using the Slack native quiz builder in the app's home tab. Currently, we support three question types: multiple choice, checkboxes, and short text. A multiple-choice question allows users to select only one option from the available choices, while a checkboxes question allows users to select as many as they want. Short text is a free-form text format where users have to type their answers.

### 1. Exploring the Quiz Home Tab <a href="#id-1-exploring-the-quiz-home-tab" id="id-1-exploring-the-quiz-home-tab"></a>

The Quiz Home Tab is where you can create a new quiz, start a quiz session, or view the quiz results. You can do a number of things from the home tab interface without leaving Slack at all. Let's create a new quiz from scratch. Go ahead and click on **New Quiz**.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2F9aA0Ya6ORUGJwK5wYbW1%2Fauthoring-1.jpg?alt=media&amp;token=34133105-84b8-49b8-813f-595d4feb845a" alt=""><figcaption></figcaption></figure>

### 2. Creating a New Quiz <a href="#id-2-creating-a-new-quiz" id="id-2-creating-a-new-quiz"></a>

After clicking **New Quiz**, the Quiz dialog will appear as shown below. Don't worry about the details here, as you can change any of them anytime in the quiz builder. We'll explore the quiz types later, but for now, you can choose either of them. More details about the quiz types can be found [here](https://docs.bubbletea.cloud/quizzes/quiz-types/). The quiz cover image and closing image are provided by default, but you can change or remove them if you prefer.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Ffxb97sNmWaxcKzhwaQK2%2Fauthoring-2.jpg?alt=media&amp;token=102f0c15-a61a-415b-8262-a9680310cc1a" alt=""><figcaption></figcaption></figure>

### 3. Designing a Quiz in the Quiz Builder <a href="#id-3-designing-a-quiz-in-the-quiz-builder" id="id-3-designing-a-quiz-in-the-quiz-builder"></a>

After creating the quiz, the system will redirect you to the quiz builder interface where you can begin adding questions. You can edit the quiz information entered earlier, preview your quiz before publishing, publish your quiz, or start a new quiz session from this interface. Since there are currently no questions in the quiz, let's scroll down to the **Add New Question** section. We will add a question for each question type in the same order as the buttons.

<div align="center"><figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FipnIadDIkmhHSVLt1sC7%2Fauthoring-3.jpg?alt=media&amp;token=dbdfda39-a96c-4029-ac77-21451c24f9d5" alt="" width="563"><figcaption></figcaption></figure></div>

### 4. Adding a Multiple Choice Question <a href="#id-4-adding-a-multiple-choice-question" id="id-4-adding-a-multiple-choice-question"></a>

When you click the Multiple Choice button, the question dialog will appear. In this interface, you can enter the question, the choices, the score for this question, and the explanation for the answer. Initially, you will see two question choices, and you can add or remove them as needed.

If each choice requires multiple lines to be clear, you can click the Switch to Multiline button to activate multiline mode. Multiline mode is useful for displaying multiple paragraphs or code blocks.

Please note that all text fields here support [Slack markdown](https://slack.com/help/articles/202288908-Format-your-messages) and emojis. The possibilities are limited only by your imagination!

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FyytjMva77RRVqSRoxHUB%2Fauthoring-4.jpg?alt=media&amp;token=76c0fbc0-8d7a-4e5b-a61b-8781063463ef" alt=""><figcaption></figcaption></figure>

### 5. Adding a Checkboxes Question <a href="#id-5-adding-a-checkboxes-question" id="id-5-adding-a-checkboxes-question"></a>

After creating the first question in multiple-choice format, you can explore another question type: checkboxes format. This format allows users to select more than one option. Everything is the same as the multiple-choice question, except that you can add more than one correct answer to the question.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FeBm0ZYaML6UzxICo8dgH%2Fauthoring-5.jpg?alt=media&amp;token=6e213e09-e836-46e9-9ff0-6587d625ae4a" alt=""><figcaption></figcaption></figure>

### 6. Adding a Short Text Question <a href="#id-6-adding-a-short-text-question" id="id-6-adding-a-short-text-question"></a>

Now that we've created two questions, one with the multiple-choice format and the other with the checkboxes format, let's create the final question. We'll use the short text format for this question. A short text question allows users to type their answer. Don't worry about case or spacing; the system will normalize the string before comparing it with the correct answer.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FUeePwqTUZJk3tTagc9iN%2Fauthoring-6.jpg?alt=media&amp;token=8bcbdb73-2379-4994-a196-a326a5bf2790" alt=""><figcaption></figcaption></figure>

### 7. Managing Quiz Questions <a href="#id-7-managing-quiz-questions" id="id-7-managing-quiz-questions"></a>

Now we have three questions. If you're not satisfied with the order, you can rearrange the questions. You have the option to edit or delete any question. Please note that once a question type is created, it cannot be changed. If you wish to change the question type, you'll need to create a new question and copy the values over. At this stage, you may want to preview your quiz before publishing it.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2F98FKNTAmkQCWaaJLpbO1%2Fauthoring-7.jpg?alt=media&amp;token=0da9617f-103e-4467-85a9-ea5f5e9f6832" alt=""><figcaption></figcaption></figure>

### Things You Need to Know About Quizzes <a href="#things-you-need-to-know-about-quizzes" id="things-you-need-to-know-about-quizzes"></a>

* Your quiz can undergo unlimited revisions.
* Quiz revisions are immutable. You cannot alter a quiz that users have taken or completed.
* You can make changes at any time, and the changes are committed to your quiz template (which is not yet published).
* When you're ready, you can publish your changes to the latest revision.
* The latest revision won't affect ongoing quizzes; it only affects new quiz sessions.

***

We apologize if this concept seems a bit complex. Data integrity is our top priority. You can rest assured that no one can alter the quiz session or its results.


# Interactive Quiz Explained

An Interactive Quiz is a game-style quiz where all participants progress through the quiz at the same pace. Each participant completes the same question one at a time until the quiz concludes. At the end of each question, quiz participants may view the leaderboard, which displays the top five users with the highest scores. This type of quiz is suitable for ice-breaking activities like trivia games, birthday party games (where questions may be about the birthday person), or competitive games where participants vie for rewards.

<details>

<summary>Number of participants</summary>

We recommend that the number of participants should not exceed 20 users, or 10 users for quizzes with a significant number of questions. While you might be able to accommodate more users, such as 50 or even 100, please note that the limit imposed by the Slack API applies per workspace.

</details>

When creating a quiz for the first time, you must specify the quiz type. In the [Creating a New Quiz](/my-quizzes/creating-a-new-quiz) tutorial, we selected the **Interactive** type. If you followed the tutorial in order, there's no need to change anything. However, if you deviated from the tutorial sequence, please edit the quiz and change the type to **Interactive** before proceeding.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FOmt7lsogtmXOuJHxZCHH%2Fedit.jpg?alt=media&amp;token=dc742c37-4bf7-4788-9535-5febd13aa25f" alt=""><figcaption></figcaption></figure>

### Starting a New Session <a href="#starting-a-new-session" id="starting-a-new-session"></a>

A quiz session is the event during which participants can take part in the quiz. In an interactive quiz, it's important to ensure that all participants are online and ready to take the quiz, with you acting as the moderator. The interactive quiz will occur in the specified Slack channel, whether it's a private or public channel. For private channels, please ensure that the bot is added to the channel before proceeding to avoid permission errors.

You can initiate a quiz session directly from the quiz home tab, the quiz builder interface, or in any channel using the slash command `/quiz` or `/myquiz`

Please proceed by clicking the **New Quiz Session** button or running the `/quiz` command. If you run it from the command and have more than one quiz, you'll be prompted to select which one you want to start.

**Note:** When initiating a quiz session for the first time, the system will automatically publish your quiz if it hasn't been published previously. Otherwise, the latest revision will be used.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Fikhhgy7ddzUNfCweOe1p%2Fquiz-selection.jpg?alt=media&amp;token=6e694880-0dc6-4891-b743-afa16840cd19" alt="" width="427"><figcaption></figcaption></figure>

### Configuring an Interactive Session <a href="#configuring-an-interactive-session" id="configuring-an-interactive-session"></a>

Each time you begin a new session, you'll have the opportunity to designate the posting channel for the quiz, determine participants, and specify the information to be displayed. Additionally, in the premium version, you can set a time limit per question.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FkW2QDGdN91RYV8LxynIo%2Finteractive-1.jpg?alt=media&amp;token=4bd6c9f9-dc6e-4af1-892e-06b33c2e5d91" alt="" width="362"><figcaption></figcaption></figure>

1. **Session Name:** This field is optional. It serves as the session name for your recording, providing a memorable identifier for this quiz session.
2. **Channel:** The channel to which this quiz session will be posted. If you initiate a new session using the slash command `/quiz`, the system will automatically select the current channel as your desired channel.
3. **Settings:**
   * **Show the leaderboard after every question** After each question, the top 5 participants with the highest scores will be displayed.
   * **Show the quiz starter** Display who initiated this quiz session. The quiz starter is also considered a moderator.
   * **Show users' response history** When this option is selected, user responses will be recorded in a thread. You will only see your own responses since the messages will be posted in ephemeral mode.
   * **Show response count** The response count is per question and will be posted as the first message in a thread instead of updating the main message. This approach is necessary due to limitations imposed by the concurrent nature of this use case and Slack API.
4. **Participation Settings:**
   * **Anyone can join prior to the quiz's start** Anyone can participate in the quiz, but they must join before the quiz starts.
   * **Anyone can join the quiz at any time** Anyone can participate in the quiz, and they can join at any time while the quiz is in progress.
   * **Restricted participants can join prior to the quiz's start** Only selected users can participate in the quiz, and they must join before the quiz starts.
   * **Restricted participants can join the quiz at any time** Only selected users can participate in the quiz, and they can join at any time while the quiz is in progress.
5. **Eligible Participants:** A list of users who can participate in the quiz. You must specify this list if the participation setting is restricted.
6. **Question Time Limit:** You can specify the time limit for each question. When the time is up, users won't be able to provide an answer, and the quiz will automatically move to the next question.

### Starting an Interactive Session <a href="#starting-an-interactive-session" id="starting-an-interactive-session"></a>

Once the quiz is posted (started), the quiz cover will appear in the targeted channel. If the quiz session settings require participants to join before the quiz starts, you will see a button named **Join**. In this case, you won't be able to start the quiz unless at least one user has participated. All users who want to participate will appear under the **Join** button. The quiz moderator can observe the number of participants before starting the quiz.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2F3ObTOfDjajLX0xGvy5oa%2Finteractive-2.jpg?alt=media&amp;token=125d454c-9d47-41d5-9bfb-51d91d27d064" alt="" width="563"><figcaption></figcaption></figure>

### Answering the Question <a href="#answering-the-question" id="answering-the-question"></a>

Once the quiz is started, the first question will appear automatically. If a time limit is set, an animated countdown image will be displayed. When the time is up, the quiz will proceed to the next question. As a quiz moderator, you can move to the next question without waiting for the time to expire.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FstDrffaEmINNKASSGmsD%2Finteractive-3.jpg?alt=media&amp;token=399aa113-3fe5-4592-9abd-b145dd85e34c" alt="" width="480"><figcaption></figcaption></figure>

Before the next question appears, you will see the result screen showing the performance of the participant in the previous question. If the option **Show the quiz starter** is checked, you will see the leaderboard underneath the questions. At this point, a quiz moderator has to click **Next** to start the next question.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FEMgYAAW2eu1RVQzJgaNh%2Finteractive-4.jpg?alt=media&amp;token=79c5b765-f7ce-4ac2-8e13-afae3f29a205" alt="" width="479"><figcaption></figcaption></figure>

### After the Quiz Ends

At the conclusion of the quiz, you will be presented with the closing image you've chosen, and the scoreboard will be displayed. At this juncture, you'll have the chance to view a detailed report of this quiz session. Simply click the **View Summary** button to do so.<br>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FzI1Gt4owCynGHtFeFfHc%2Finteractive-5.jpg?alt=media&amp;token=c080fa5f-866b-4fad-a142-d1695f0011a5" alt="" width="482"><figcaption></figcaption></figure>

### Viewing the Quiz Session Summary <a href="#viewing-the-quiz-session-summary" id="viewing-the-quiz-session-summary"></a>

The session summary will provide insightful information about the quiz and its participants. You'll discover which question took the longest time and which ones most users answered incorrectly. Additionally, statistical data on scores, including total average, highest, lowest, and median scores, will be available. Utilize this information to enhance the quiz in future versions.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Fpc5LtwzykMfQOB7qjpz4%2Finteractive-6.jpg?alt=media&amp;token=3afa481e-732a-4797-89cf-f8e4b1b10ce7" alt="" width="375"><figcaption></figcaption></figure>


# Standard Quiz Explained

A standard quiz allows participants to proceed at their own pace. However, participants must complete the quiz before the set deadline, if applicable, to receive a score. This type of quiz supports a large number of participants, unlike the interactive quiz.

<details>

<summary>Number of participants</summary>

Because this quiz does not update messages in a channel, it theoretically supports an unlimited number of participants. However, for regular licenses, we recommend not exceeding 500 users, and for enterprise licenses, not exceeding 3,000 users. If you require support for larger numbers, please don't hesitate to contact us, and we'll gladly assist you.

</details>

When creating a quiz for the first time, you must specify the quiz type. If the quiz type is not set to **Standard**, please change it to **Standard** by clicking **Edit Info** and then selecting **Standard** as the type before proceeding.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FOmt7lsogtmXOuJHxZCHH%2Fedit.jpg?alt=media&amp;token=dc742c37-4bf7-4788-9535-5febd13aa25f" alt=""><figcaption></figcaption></figure>

### Starting a New Session <a href="#starting-a-new-session" id="starting-a-new-session"></a>

A standard quiz session differs from an interactive quiz in several ways. Firstly, in a standard session, participants aren't required to take the same questions simultaneously; they can proceed at their own pace. Additionally, participants won't see each other's scores by default; the quiz moderator can decide whether to share them or not. The quiz moderator also has the option to export the quiz results to a CSV file. Secondly, standard quiz sessions typically span longer durations, lasting for days or even months, whereas interactive quizzes are much shorter, usually lasting from a few minutes to an hour.

The quiz will be delivered to all invitees via direct message channels at a specified time. You need not worry about channel permissions, as the bot can send direct messages to individuals based on OAuth permissions.

You can initiate a quiz session directly from the quiz home tab, the quiz builder interface, or in any channel using the slash command `/quiz` or `/myquiz`

Please proceed by clicking the **New Quiz Session** button or running the `/quiz` command. If you run it from the command and have more than one quiz, you'll be prompted to select which one you want to start.

### Configuring a Standard Session <a href="#configuring-a-standard-session" id="configuring-a-standard-session"></a>

Each time you start a new session, you'll be able to establish the quiz rules, select users who will receive the quiz, set the start time and deadline, and determine the passing percentage if applicable.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FpyILKnGLf0vvo2X29PaL%2Fstandard-1.jpg?alt=media&amp;token=4c4ff8f3-9789-4070-bd80-7c6234b7a058" alt="" width="359"><figcaption></figcaption></figure>

1. **Session Name:** This field is optional. It serves as the session name for your recording, providing a memorable identifier for this quiz session.
2. **Settings:**
   * **Reveal answers at the end** If this option is selected, quiz participants can review their answers at the end of the quiz. Otherwise, the system will not reveal the answers.
   * **Show results upon completion** If this option is selected, quiz participants will have the ability to view their total scores at the end of the quiz.
   * **Allow skipping of questions** If this option is selected, quiz participants will have the option to skip questions and return to them later. Additionally, at the end of the quiz, participants can view which questions they haven't answered and jump directly to those unanswered questions.
   * **Allow unanswered questions** If this option is selected, quiz participants will have the option to leave some or all questions unanswered before submitting the quiz. Otherwise, they won't be able to submit the quiz if there are unanswered questions.
   * **Anonymous participants** If this option is selected, participant names won't be recorded. The quiz moderator will not know which quiz results belong to whom.
3. **Invite Message:** The invite message will be shown along with the quiz title, description, and other quiz information. You can customize this or use the default one.
4. **Invitees:** You can select private channels, public channels, or individual users, up to 20 items. For example, if the channel named 'general' has 200 users, all those users will be included in the invitee list. The final invitee list will be deduplicated, as users may be members of multiple channels. You can export the invitee list to review and exclude specific participants if needed.
5. **Exclusions:** You can add up to 50 users to the exclusion list.
6. **Start Time:** You can specify the future date and time for when the quiz will be delivered to all invitees. If not specified, the start time will default to the current time.
7. **Deadline:** You can specify the future date and time when the quiz will no longer accept responses from users. If not specified, it means there is no deadline.
8. **Passing Percent:** You can specify the passing percentage from 0% to 100%. If you specify 0 or leave it blank, it means there is no passing percentage.

### Loading Invitees <a href="#loading-invitees" id="loading-invitees"></a>

Since this type of quiz supports a large number of participants, we won't ask you to manually input all individuals, as it could range from 10 to 1,000 users or anywhere outside of this range. This would be impractical and quite a cumbersome process. We aim to make this process as easy as possible for you. You can specify channels, and we will retrieve all members from those channels, deduplicating them across channels for you. This may require multiple API calls and could take more than a minute if the audience is particularly large. Once the loading is complete, you'll be able to export the list of invitees, allowing you to identify who you want to include or exclude.

When you initiate the **Load Invitee List** action, the system will commence the loading task in the background. Typically, this process takes only a few seconds if your list is not large.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FVvlC1NNvk3Yn1VgpJ4Sk%2Fstandard-2.jpg?alt=media&amp;token=f4c26294-6ea9-4682-a46d-0ec4f48e7436" alt=""><figcaption></figcaption></figure>

After the invitee list is ready, the system will report the total number of invitees. In this case, we have only 2 invitees. Please click **Next** to proceed to the preview window.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FPU6EV3f2k5ehfX96C1Ag%2Fstandard-3.jpg?alt=media&amp;token=fd106908-cc62-47d2-8d39-60d5296097b1" alt=""><figcaption></figcaption></figure>

### Previewing the Configuration <a href="#previewing-the-configuration" id="previewing-the-configuration"></a>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FGHgkNNUFReklKgxXoeXi%2Fstandard-4.jpg?alt=media&amp;token=9d9d3f67-45dc-41e4-b254-888ce8e891ec" alt="" width="380"><figcaption></figcaption></figure>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Fgl1N5RHmjmZ5mOzUHBuz%2Fstandard-5.jpg?alt=media&amp;token=4820d725-0c19-49ed-8d00-019108b56a5a" alt="" width="542"><figcaption></figcaption></figure>

### Starting the Quiz <a href="#starting-the-quiz" id="starting-the-quiz"></a>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FfNpypvf42Sk8lI58JPPy%2Fstandard-6.jpg?alt=media&amp;token=f2580a6a-9515-4f8a-88e1-fb9ba4234fc4" alt="" width="529"><figcaption></figcaption></figure>

### Answering the Questions <a href="#answering-the-questions" id="answering-the-questions"></a>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FiP1iSB0BSd2Qo0RQE7Kd%2Fstandard-7.jpg?alt=media&amp;token=31db6afd-d997-44eb-b25a-706f8b16b08f" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Faycd9NXe1dY3Wgt1oFAK%2Fstandard-8.jpg?alt=media&amp;token=52fb8021-470e-45b4-8589-3d9a0738ae4e" alt="" width="514"><figcaption></figcaption></figure>

### Submitting the Quiz <a href="#submitting-the-quiz" id="submitting-the-quiz"></a>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FI2LaaaK3bq9hKYwKWqHa%2Fstandard-9.jpg?alt=media&amp;token=40943f0b-f18d-4a94-a097-3080a0ed8b07" alt="" width="506"><figcaption></figcaption></figure>

### Viewing the Score Report <a href="#viewing-the-score-report" id="viewing-the-score-report"></a>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FS1j127ok212dDuGyaHp2%2Fstandard-10.jpg?alt=media&amp;token=75ddf104-91c5-4bac-b860-3082cda829a8" alt="" width="518"><figcaption></figcaption></figure>

### Tracking Progress and Viewing Session Summary Report <a href="#tracking-progress-and-viewing-session-summary-report" id="tracking-progress-and-viewing-session-summary-report"></a>

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FaN2BmeGSA8jLCZDrHIhe%2Fstandard-11.jpg?alt=media&amp;token=0183794e-5bb9-4d44-809d-09899ad36c01" alt="" width="563"><figcaption></figcaption></figure>


# Example Prompts for Generative AI

You can generate any quiz by providing a short description, such as 'Space Exploration in 1990,' 'American Civics Test 2024,' or 'All About Abraham Lincoln.' The only limit is your imagination

**Here are some more prompts for trivia games:**

* Guess the Country by Its Food
* The Myths People Still Believe
* All About Japanese Flowers
* All About South African Spiders
* 90s Pop Music
* Dragon Ball Z
* Star Wars
* American Cars
* Ocean Exploration
* Famous Scientists and Their Contributions

### &#x20;Personalized Quiz Based on Your Information

Create a fun game by generating a quiz based on a person's information for events like birthdays, baby showers, or work anniversaries. Share some details about them and let the AI do the rest!

**Example Prompt for Birthday Quiz**&#x20;

> John was born on April 1, 1990, on a flight from France to the U.S. His father is French, and his mother is American, though he doesn’t speak French. He has ten siblings—all sisters—and he is the youngest. John has loved playing soccer since he was nine and even won the junior national cup in France. He joined our team two years ago and has made significant contributions to both the team and the company. John invented the 'John Language,' which is now widely used and loved by our customers. Today is John's birthday. Create a quiz about him.

**Example Prompt for Baby Shower Quiz**&#x20;

> Jane has boy-girl twins: the first is named Joey, and the second, Jasmine. They were born on a cruise ship to Australia, which inspired Joey's name. Jane and her husband have many pet spiders, but now they’re considering moving to a new house to make room for the new family members, as spiders and toddlers aren’t meant to share a space. Jane has been with ACME for 10 years, spending the last 5 years with our team. She loves being part of our team, and we love having her. Create a quiz to challenge guests at her baby shower!


# Why Might a Countdown Animation be Inaccurate?

When using the time limit feature on the interactive quiz, a countdown animation shows the remaining time before the quiz progresses to the next question. However, if the quiz window is inactive or not in focus, the GIF animation won't render accurately. When you return to the quiz window, the animation restarts from the beginning, failing to reflect the actual remaining time. This is a known limitation.

### Why not update the countdown animation manually instead of using a GIF image? <a href="#why-not-update-the-countdown-animation-manually-instead-of-using-a-gif-image" id="why-not-update-the-countdown-animation-manually-instead-of-using-a-gif-image"></a>

There are three main reasons:

1\) The Slack API imposes restrictions on request frequency. Pushing changes to Slack every second risks hitting the rate limit, causing the app to be unable to update within a specific timeframe.\
2\) Network delays can lead to unpredictable behavior. While we could schedule updates every second, delays in network transmission could result in jumps of a second or more in the displayed time.\
3\) Preventing race conditions becomes challenging when we lack control over the Slack client's behavior.

Rather than delivering a buggy application, we opted for slight inconvenience.

### Why do other quizzes not encounter this limitation? <a href="#why-do-other-quizzes-not-encounter-this-limitation" id="why-do-other-quizzes-not-encounter-this-limitation"></a>

To put it plainly, they are not integrated natively within Slack. As a result, they have complete control over their own client environments, making this problem relatively easy to address. Please inform us if this limitation truly bothers you. If there is significant demand for it, we can develop a web-based version without this constraint. The reason we haven't implemented it yet is because it contradicts our goal of seamlessly integrating features into your work environment.


# My Quizzes' OAuth Scopes

We request only the scopes that are currently needed by My Quizzes. If additional scopes are required due to the addition of new functionalities, we will need to resubmit the application to Slack. As a result, you will need to reinstall My Intros and provide consent again in order to access the new functionalities.

| Scope            | Reason                                                                                                                                                                                                                                                |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| channels:join    | Enables the bot to automatically join a public channel upon receiving a user request.                                                                                                                                                                 |
| channels:read    | Enables the bot to read the information of a public channel and test its accessibility. This scope **doesn't** provide the bot with the ability to read messages in a channel.                                                                        |
| chat:write       | Enables the bot to send messages as "@My Quizzes" (itself), delete or update its own messages. This is a crucial capability that allows the bot to effectively communicate with users.                                                                |
| commands         | Enables the bot to support slash command features. You can view all available commands in the bot's home tab, specifically in the "About" section.                                                                                                    |
| groups:read      | Enables the bot to access the information of private channels it has been added to (excluding the channel content). This capability is necessary to retrieve the member list of the private channel.                                                  |
| users:read       | Enables the bot to access user information, including user name, time zone, locale, avatar, and status. The bot does not receive user email. User information is not stored in our database, but it may be temporarily cached to enhance performance. |
| users:read:email | Enables the bot to access user email. We will never share your email or personal information. Your email is solely used to communicate with you regarding the plan and updates.                                                                       |

To learn more about app permissions and understand how they work, please visit the following page: [Understand app permissions](https://slack.com/help/articles/115003461503-Understand-app-permissions).


# Feature Comparison


# My Polls vs Simple Poll

<table><thead><tr><th width="414">Feature</th><th>My Polls</th><th>Simple Poll</th></tr></thead><tbody><tr><td>Editable Votes Poll (Flexible Poll)</td><td>✅</td><td>✅</td></tr><tr><td>Standard Poll (Votes cannot be changed once cast)</td><td>✅</td><td>❌</td></tr><tr><td>Poll Draft</td><td>❌</td><td>✅</td></tr><tr><td>Multiple Questions</td><td>❌</td><td>✅</td></tr><tr><td>Poll Templates</td><td>✅</td><td>✅</td></tr><tr><td>Single Option Selection Poll</td><td>✅</td><td>✅</td></tr><tr><td>Multiple Option Selection Poll</td><td>✅</td><td>✅</td></tr><tr><td>User-Contributed Options</td><td>✅</td><td>✅</td></tr><tr><td>Anonymous Responses</td><td>✅</td><td>✅</td></tr><tr><td>Anonymous Poll Author</td><td>✅</td><td>❌</td></tr><tr><td>Real-time Results Display</td><td>✅</td><td>✅</td></tr><tr><td>Automatic Poll Closure</td><td>✅</td><td>✅</td></tr><tr><td>Scheduled Polls</td><td>✅</td><td>✅</td></tr><tr><td>Repeated Scheduled Polls</td><td>✅</td><td>✅</td></tr><tr><td>Tiebreaker Poll</td><td>✅</td><td>❌</td></tr><tr><td>Lucky Draw Poll</td><td>✅</td><td>❌</td></tr><tr><td>Preview Poll</td><td>✅</td><td>✅</td></tr><tr><td>Undo Deletion</td><td>✅</td><td>❌</td></tr><tr><td>Reopen Poll</td><td>✅</td><td>✅</td></tr><tr><td>Recreate Poll</td><td>✅</td><td>✅</td></tr><tr><td>Decision Capture</td><td>❌</td><td>✅</td></tr><tr><td>Surveys</td><td>❌</td><td>✅</td></tr><tr><td>Encryption in Transit and at Rest</td><td>✅</td><td>✅</td></tr><tr><td><strong>Encrypt Data Before Storing in the Database</strong></td><td>✅</td><td>❌</td></tr><tr><td><strong>Cost</strong></td><td>$0.01 / user / month</td><td>The price tiers start at $59 for 1 to 24 users.</td></tr><tr><td><strong>Cost for 25 users</strong></td><td>$2 a month</td><td>$95 a month</td></tr><tr><td><strong>Cost for 100 users</strong></td><td>$2 a month</td><td>$179 a month</td></tr></tbody></table>

#### Summary

> Simple Poll is an excellent product, offering numerous features beyond its name. However, My Polls provides similar functionalities along with unique features. In terms of overall features, Simple Poll excels, particularly with its Surveys feature. Yet, if your primary focus is creating polls, My Polls stands out. Not only is it substantially more affordable—just a fraction of the cost of Simple Poll—but it also prioritizes data security by encrypting information before saving it to the database, enhancing overall customer data protection.


# My Quizzes vs QuickQuiz

<table><thead><tr><th width="403">Feature</th><th>My Quizzes</th><th>QuickQuiz</th></tr></thead><tbody><tr><td>Interactive Quiz<br>A quiz conducted in a game-style format where all participants advance through the questions together.</td><td>✅</td><td>❌</td></tr><tr><td>Standard Quiz<br>Participants can take the quiz at any time.</td><td>✅</td><td>✅</td></tr><tr><td>Question Type: Multiple Choice</td><td>✅</td><td>✅</td></tr><tr><td>Question Type: Checkboxes</td><td>✅</td><td>❌</td></tr><tr><td>Question Type: Short Text</td><td>✅</td><td>❌</td></tr><tr><td>Quiz Revisions</td><td>✅</td><td>❌</td></tr><tr><td>Support for Multiple Sessions</td><td>✅</td><td>❌</td></tr><tr><td>Cloning and Sharing Quizzes</td><td>✅</td><td>❌</td></tr><tr><td>Quiz Templates</td><td>✅</td><td>❌</td></tr><tr><td>Quiz Preview</td><td>✅</td><td>❌</td></tr><tr><td>Standard Quiz: Due Date / Deadline</td><td>✅</td><td>✅</td></tr><tr><td>Standard Quiz: Anonymous Participants</td><td>✅</td><td>❌</td></tr><tr><td>Standard Quiz: Revealing Answers</td><td>Configurable</td><td>Not Configurable</td></tr><tr><td>Standard Quiz: Allow Skipping of Questions</td><td>✅</td><td>❌</td></tr><tr><td>Standard Quiz: Passing Percentage</td><td>✅</td><td>✅</td></tr><tr><td>Standard Quiz: Scheduled Quiz</td><td>✅</td><td>❌</td></tr><tr><td>Interactive Quiz: Leaderboard</td><td>✅</td><td>❌</td></tr><tr><td>Interactive Quiz: Real-Time Response Count</td><td>✅</td><td>❌</td></tr><tr><td>Interactive Quiz: Configurable Participation Settings</td><td>✅</td><td>❌</td></tr><tr><td>Interactive Quiz: Time Limit per Question</td><td>✅</td><td>❌</td></tr><tr><td>Quiz Analysis Report for Each Session</td><td>✅</td><td>❌</td></tr><tr><td>Quiz Analysis Report for Individuals</td><td>✅</td><td>✅</td></tr><tr><td>Participants File Export</td><td>✅</td><td>❌</td></tr><tr><td>Encryption in Transit and at Rest</td><td>✅</td><td>✅</td></tr><tr><td><strong>Encrypt Data Before Storing in the Database</strong></td><td>✅</td><td>❌</td></tr><tr><td><strong>Cost</strong></td><td>$0.02 / user / month</td><td>$5 a month (Last Updated: July 31, 2024)</td></tr><tr><td><strong>Cost for 200 users</strong></td><td>$5 a month</td><td>$5 a month</td></tr><tr><td><strong>Cost for 500 users</strong></td><td>$10 a month</td><td>$5 a month</td></tr></tbody></table>

#### Summary

> QuickQuiz is another product offering native Slack integration, allowing quiz management directly within Slack. While it's a cost-effective option, it lacks many essential features and its quiz management interface can be challenging due to the need to refer to slash command documentation. On the other hand, My Quizzes provides both Standard Quiz, akin to QuickQuiz, and Interactive Quiz, similar to Kahoot!, all accessible within Slack. My Quizzes supports multiple question formats such as multiple choice, checkboxes, and short text, whereas QuickQuiz only supports multiple choice. Additionally, My Quizzes offers almost all features of QuickQuiz and provides more customization options to tailor quizzes to users' needs. Moreover, My Quizzes prioritizes data security by encrypting information before saving it to the database, ensuring enhanced customer data protection.


# My Intros vs Intros by Airspeed

<table><thead><tr><th width="345">Feature</th><th>My Intros</th><th>Intros by Airspeed</th></tr></thead><tbody><tr><td>Provide Predefined Templates for Diverse Purposes</td><td>✅</td><td>✅</td></tr><tr><td>Automated Delivery of Questions to New Users</td><td>✅</td><td>✅</td></tr><tr><td>AI-Generated Introductory Questions for Given Topics</td><td>✅</td><td>✅</td></tr><tr><td>Channel Creation Monitoring</td><td>✅</td><td>✅</td></tr><tr><td>Explore Previous Introductions</td><td>✅</td><td>✅</td></tr><tr><td>Emoji Support in Questions and Answers</td><td>✅</td><td>✅</td></tr><tr><td>Encryption in Transit and at Rest</td><td>✅</td><td>✅</td></tr><tr><td><strong>Encrypt Data Before Storing in the Database</strong></td><td>✅</td><td>❌</td></tr><tr><td><strong>Organization-Wide Automated Self-Introductions</strong></td><td>✅</td><td>❌</td></tr><tr><td><strong>Cost for a Single Software License</strong></td><td>$0.01 / user / month</td><td>$3.00 / user / month<br>(Business Class)<br>$5.00 / user / month<br>(First Class)</td></tr><tr><td>Cost for a Bundle License</td><td>$0.20 / user / month</td><td>$3.00 / user / month<br>(Business Class)<br>$5.00 / user / month<br>(First Class)</td></tr></tbody></table>

#### Summary

> Intros by Airspeed is an outstanding product, seamlessly integrated into the Airspeed suite to enhance your team culture. The suite provides enterprise integration, including compatibility with HCM and Zoom. However, in a detailed feature-by-feature comparison with My Intros, the latter emerges as a more compelling choice, especially considering the price point. Additionally, My Intros prioritizes data security by encrypting information before saving it to the database, making it a safer option for robust data protection.


# Troubleshooting


# How to Fix "The bot cannot access the private channel."?

A bot in Slack operates similarly to a user. If you are not a member of a private channel, you cannot view or post messages there. Therefore, if you receive an error message such as 'the bot cannot access the private channel', it implies that you need to invite the bot to the private channel.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FMmhaipN7wYK81eTsZ5iT%2Ffix-bot-access-1.png?alt=media&amp;token=fae953f3-e3fc-497d-b0d5-2f53b84fa095" alt=""><figcaption></figcaption></figure>

The access error message typically prompts you to invite the Bubble Tea bot to your private channel and provides an example in the code block. Be careful not to directly copy and paste `/invite @Bubble Tea` because Slack may retain the formatting, causing the formatted message to not trigger the `/invite` command. So, the safest option is to type it manually.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Fqny7rv2rzrDjAlgWQXpN%2Ffix-bot-access-2.png?alt=media&amp;token=3487c1e6-0db8-4b3a-813b-dfebef9d6174" alt=""><figcaption></figcaption></figure>

After successfully executing the invite command, you should see a message similar to the one in the screenshot above. Once Bubble Tea is added to your channel, you can make use of its powerful features there.

If it's still not working for you, please send us an email at <support@bubbletea.cloud>, and we will get back to you as soon as possible


# General Tips & Tricks


# How Can I Get an Image URL?

### Obtaining an Image URL from Google Search or Any Source <a href="#obtaining-an-image-url-from-google-search-or-any-source" id="obtaining-an-image-url-from-google-search-or-any-source"></a>

1. Visit Google.com and enter your desired search term in the search box. For instance, you can replace 'funny cat' with any other search term you prefer. To ensure you find images that are likely royalty-free, consider adding 'royalty free' to your keyword. You can use this preformatted URL for convenience: <https://www.google.com/search?q=funny+cat+royalty+free>.
2. Locate the image you wish to obtain a URL for. Hover your mouse cursor over the image and right-click. This will display a popup menu.
3. Select 'Copy image address', and the image URL will be copied to your clipboard.
4. When you paste the URL using Ctrl + V or CMD + V, it will appear as follows: `https://images.pexels.com/photos/137049/pexels-photo-137049.jpeg?cs=srgb&dl=pexels-inge-wallumr%C3%B8d-137049.jpg&fm=jpg` Take note that the file extension, in this case, is `.jpeg`, indicating the image type.
5. You can utilize this URL in any field within Bubble Tea that requests an image URL. Keep in mind that images may vary in size when using this method, and Slack may not automatically expand large images.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Fnv7JgIamKl8L79ByyZ9q%2Fgetting-image-url-google.png?alt=media&amp;token=97df734a-6b1b-43fd-aa17-2d5e50b06532" alt=""><figcaption></figcaption></figure>

This method is not limited to Google search; you can employ it on any website that hosts images.

### Getting an Image URL from Giphy <a href="#getting-an-image-url-from-giphy" id="getting-an-image-url-from-giphy"></a>

If you're searching for entertaining images, including some that may not be suitable for the workplace, Giphy is a great place to explore. However, it's important to exercise discretion. Adding amusing GIFs to your Slack conversations can brighten your team's mood and strengthen bonds within the group.

Obtaining an image URL from Giphy may involve a few more steps compared to other websites, but once you become familiar with the process, it becomes straightforward.

Visit Giphy.com and use your preferred keyword for searching. I'll stick with 'funny cat,' but this time, I'll be an animated one.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FuezifNfgM72rFK4CHOgu%2Fgetting-image-url-giphy-1.png?alt=media&amp;token=1ffd83db-f9f0-487c-8107-b3a5ed1218db" alt=""><figcaption></figcaption></figure>

After you've found the GIF image you want to use, simply click on the image, and your screen will resemble the following (excluding the image, of course):

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2F2Ym1LNx08iB7o0RGXH7x%2Fgetting-image-url-giphy-2.png?alt=media&amp;token=56b1e3ca-d516-44e2-86e7-6b9ff994c91a" alt=""><figcaption></figcaption></figure>

**Follow these two simple steps:**

1. Click on "Share."
2. In the Share GIF dialog that appears, select "Copy GIF Link," and the image URL will be copied to your clipboard.

### Using an Image URL in Bubble Tea <a href="#using-an-image-url-in-bubble-tea" id="using-an-image-url-in-bubble-tea"></a>

After you've copied the image URL to your clipboard, you can then paste it into the field that requests an image URL. In this instance, I'll demonstrate how to use the image URL in Bubble Tea within the Group Greeting Cards dialog.

When you initiate the greeting card command `/card`, you'll encounter the following dialog. One of the fields in this dialog is labeled 'Cover Image URL.' You can paste the image URL from your clipboard using `Ctrl + V` (if you're using Windows) or `CMD + V` (if you're using Mac) into that field. If nothing happens, it's possible that your clipboard has been overwritten, and you'll need to repeat the steps to obtain an image URL again.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2F2OJ8TkWmbHXN2t9DFjmk%2Fusing-image-url-card-1.png?alt=media&amp;token=4b5eb01b-31cb-45bd-b0bd-761135e48c54" alt="" width="375"><figcaption></figcaption></figure>

If the image URL is valid, you can click 'Preview' to view the image you've just pasted.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FQYzSA7P8amtVyaAQ6Y7a%2Fusing-image-url-card-2.png?alt=media&amp;token=6949052a-cb00-4551-b160-c9a3e57885e4" alt="" width="375"><figcaption></figcaption></figure>

Voilà! I hope you have as much fun using Bubble Tea as we have building it.<br>


# How to Pin the App in Slack?

We aim to pin the app in Slack because the app icon tends to disappear after a period of time, necessitating a search to locate and display it in your Slack window once more. While this process is not inherently complex, it can become tedious when repeated frequently.

For frequently accessed apps, pinning them makes access significantly more convenient and prevents the app icon from disappearing. This tutorial will demonstrate a few straightforward steps to pin your favorite apps.

### Step 1 - Add the App to the Window <a href="#step-1-add-the-app-to-the-window" id="step-1-add-the-app-to-the-window"></a>

Select 'Add Apps' from the left pane, and the screen will appear as shown below.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FtCawU9bjfT5H9EVoOm6R%2Fpin-app-1.png?alt=media&amp;token=3ba1b7d0-453c-4039-9661-b7a5cec20222" alt=""><figcaption></figcaption></figure>

Click on the app you want to add. In this case, we want to add the 'Bubble Tea' app because it's a great app, and we like it a lot.

### Step 2 - Go to the App <a href="#step-2-go-to-the-app" id="step-2-go-to-the-app"></a>

Click on the app name that we just added, and it will take you to the app home. On the app home page, you will find the app name at the top (pointed by the hand in the screenshot). Click it, and you will see the modal dialog appear as shown in Step 3.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2F1c4s8Hy1zbpgtvoRDIms%2Fpin-app-2.png?alt=media&amp;token=8992c214-a419-4511-a756-f12b702ef43c" alt=""><figcaption></figcaption></figure>

### Step 3 - Pin (Star) the App <a href="#step-3-pin-star-the-app" id="step-3-pin-star-the-app"></a>

The final step is to click on the star icon. Ensure that it changes color to blue. You will then see your favorite app appear in the left pane under the 'Starred' section.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2F0XwpZ2WPHBRDaCBSavnS%2Fpin-app-3.png?alt=media&amp;token=f6b8c1eb-2e99-4350-b90f-fc5eb7fe3731" alt=""><figcaption></figcaption></figure>


# How to Pay for Your Subscription

We partner with Stripe (for US customers only) and Lemon Squeezy, a merchant of record, to support customers worldwide and ensure compliance with local laws and regulations. We do not store any payment information in our system. You will be redirected to either Stripe or Lemon Squeezy to complete the transaction.

### Bubble Tea Suite

To get started, go to the app’s home tab by clicking on the Bubble Tea app in Slack. Then, click the overflow button (…) as shown in Screenshot 1 below. From the menu, select "Billing and Subscription" to navigate to the second page. Click "New Subscription" to view the pricing based on your team size. The system will then take you to Screenshot 3. Once you're ready, click "Checkout", and the system will open your web browser to initiate your payment session with our payment service.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2Fhdlo89qNQuwvYTokrHms%2Fpayment1.png?alt=media&amp;token=c195c398-c33b-44f7-b78a-665560fabeac" alt=""><figcaption><p>You can manage your subscription directly within the app.</p></figcaption></figure>

Once you click Checkout, you will be redirected to the payment processing service (either Stripe or Lemon Squeezy). You will have the opportunity to select the plan that best suits your organization and choose the subscription length. Please note that the yearly subscription includes 2 months free, which is a 16.67% discount.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FvQLDs0T8sXAulTVqvKT5%2FScreenshot%202025-03-05%20at%209.09.27%E2%80%AFPM.png?alt=media&amp;token=67517142-4723-4984-847a-f1f8e120a698" alt=""><figcaption><p>Checkout page powered by Lemon Squeezy</p></figcaption></figure>

### Other Slack Apps

Other Slack Apps including Franky, Elegant Chat, My Quizzes, My Polls, My Standups, and My Intros , use the same interface for subscriptions.

Please head to the app's home tab, where you will see the “Billing & Subscription” button next to the “Home” button. Click it, and you will see the same subscription dialog as in the Bubble Tea Suite.

**There are 2 different pricing models: seat-based and team size-based.**

Only Elegant Chat uses the seat-based model to ensure you get the most value while allowing us to maintain competitive pricing, as LLMs can be expensive.

<figure><img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FAGTqnAFHl2tWAO2FN4gs%2FSeat%20Based.png?alt=media&amp;token=dd97e046-78a4-4506-97e5-9aca90ef7eeb" alt=""><figcaption></figcaption></figure>


# Data Security and Privacy


# Benefits of Per-Tenant Encryption Keys

Using per-tenant encryption keys—where each tenant (or user, customer, or organizational unit) has its unique encryption key - provides several benefits, particularly in multi-tenant environments where data security and privacy are crucial. Here are some of the key advantages:

1. **Enhanced Data Privacy and Isolation**: Each tenant's data is encrypted with a unique key, ensuring that even if one key is compromised, only the data associated with that specific key is at risk. Other tenants' data remains secure, providing a high level of data isolation.
2. **Data Breach Containment**: In the event of a data breach or key exposure, the damage is limited to the affected tenant’s data only. This containment approach significantly reduces the impact compared to using a single key across multiple tenants.
3. **Flexible Key Management**: Tenanted keys allow you to rotate, revoke, or renew keys for individual tenants without affecting others. This is helpful for compliance and security policies that require periodic key rotation or immediate key revocation in case of suspicious activity.
4. **Granular Access Control and Compliance**: Many data privacy regulations (like GDPR and HIPAA) require strong data isolation and auditability. Tenanted keys simplify compliance by offering an additional layer of control over data access, allowing you to restrict access or revoke data at the tenant level.
5. **Audit and Monitoring Capability**: With tenanted keys, each tenant’s encryption activity (like access logs, usage patterns, and key rotations) can be monitored individually. This is beneficial for identifying unusual patterns and provides a clear audit trail.
6. **Improved Customer Trust**: Tenanted encryption shows a commitment to safeguarding customer data and reinforces trust, especially for businesses handling sensitive information. It also signals that customer data privacy is taken seriously.

In short, tenanted encryption keys provide greater security, flexibility, and control, enhancing data privacy and regulatory compliance. This approach is particularly valuable in SaaS and enterprise environments where data security is a top priority.


# Editor

GitBook has a powerful block-based editor that allows you to seamlessly create, update, and enhance your content.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/editor-hero.png" alt=""><figcaption></figcaption></figure>

### Writing content

GitBook offers a range of block types for you to add to your content inline — from simple text and tables, to code blocks and more. These elements will make your pages more useful to readers, and offer extra information and context.

Either start typing below, or press `/` to see a list of the blocks you can insert into your page.


# Markdown

GitBook supports many different types of content, and is backed by Markdown — meaning you can copy and paste any existing Markdown files directly into the editor!

<figure><img src="https://gitbookio.github.io/onboarding-template-images/markdown-hero.png" alt=""><figcaption></figcaption></figure>

Feel free to test it out and copy the Markdown below by hovering over the code block in the upper right, and pasting into a new line underneath.

```markdown
# Heading

This is some paragraph text, with a [link](https://docs.gitbook.com) to our docs. 

## Heading 2
- Point 1
- Point 2
- Point 3
```

{% hint style="info" %}
If you have multiple files, GitBook makes it easy to import full repositories too — allowing you to keep your GitBook content in sync.
{% endhint %}


# Images & media

GitBook allows you to add images and media easily to your docs. Simply drag a file into the editor, or use the file manager in the upper right corner to upload multiple images at once.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/images-hero.png" alt=""><figcaption><p>Add alt text and captions to your images</p></figcaption></figure>

{% hint style="info" %}
You can also add images simply by copying and pasting them directly into the editor — and GitBook will automatically add it to your file manager.
{% endhint %}


# Interactive blocks

In addition to the default Markdown you can write, GitBook has a number of out-of-the-box interactive blocks you can use. You can find interactive blocks by pressing `/` from within the editor.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/interactive-hero.png" alt=""><figcaption></figcaption></figure>

### Tabs

{% tabs %}
{% tab title="First tab" %}
Each tab is like a mini page — it can contain multiple other blocks, of any type. So you can add code blocks, images, integration blocks and more to individual tabs in the same tab block.
{% endtab %}

{% tab title="Second tab" %}
Add images, embedded content, code blocks, and more.

```javascript
const handleFetchEvent = async (request, context) => {
    return new Response({message: "Hello World"});
};
```

{% endtab %}
{% endtabs %}

### Expandable sections

<details>

<summary>Click me to expand</summary>

Expandable blocks are helpful in condensing what could otherwise be a lengthy paragraph. They are also great in step-by-step guides and FAQs.

</details>

### Drawings

<img src="https://1390349267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyLXQCn82f2wf3DCve8pv%2Fuploads%2FTskvPQyPOSCBjevjnqGX%2Ffile.excalidraw.svg?alt=media&amp;token=f6d83708-f1da-43f2-830c-14d8fe3b4e48" alt="" class="gitbook-drawing">

### Embedded content

{% embed url="<https://www.youtube.com/watch?v=YILlrDYzAm4>" %}

{% hint style="info" %}
GitBook supports thousands of embedded websites out-of-the-box, simply by pasting their links. Feel free to check out which ones[ are supported natively](https://iframely.com).
{% endhint %}


# OpenAPI

You can sync GitBook pages with an OpenAPI or Swagger file or a URL to include auto-generated API methods in your documentation.

### OpenAPI block

GitBook's OpenAPI block is powered by [Scalar](https://scalar.com/), so you can test your APIs directly from your docs.

{% openapi src="<https://petstore3.swagger.io/api/v3/openapi.json>" path="/pet" method="post" %}
<https://petstore3.swagger.io/api/v3/openapi.json>
{% endopenapi %}


# Integrations

GitBook integrations allow you to connect your GitBook spaces to some of your favorite platforms and services. You can install integrations into your GitBook page from the *Integrations* menu in the top left.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/integrations-hero.png" alt=""><figcaption></figcaption></figure>

### Types of integrations

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Analytics</strong></td><td>Track analytics from your docs</td><td><a href="https://www.gitbook.com/integrations#analytics">https://www.gitbook.com/integrations#analytics</a></td><td></td><td></td></tr><tr><td><strong>Support</strong></td><td>Add support widgets to your docs</td><td><a href="https://www.gitbook.com/integrations#support">https://www.gitbook.com/integrations#support</a></td><td></td><td></td></tr><tr><td><strong>Interactive</strong></td><td>Add extra functionality to your docs</td><td><a href="https://www.gitbook.com/integrations#interactive">https://www.gitbook.com/integrations#interactive</a></td><td></td><td></td></tr><tr><td><strong>Visitor Authentication</strong></td><td>Protect your docs and require sign-in</td><td><a href="https://www.gitbook.com/integrations#visitor-authentication">https://www.gitbook.com/integrations#visitor-authentication</a></td><td></td><td></td></tr></tbody></table>