> For the complete documentation index, see [llms.txt](https://captivatehelp.newbluelive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://captivatehelp.newbluelive.com/play-and-update-graphics/chapter-index-3/social-chat-controller.md).

# Social Chat Controller

The Social Chat Controller pulls live chat messages from multiple platforms and routes them to your graphics. Supported platforms include Twitch, YouTube, Facebook, and X (Twitter) via NewBlue’s proxy. Additional platforms are coming. You can filter and search incoming messages to customize your broadcast.

* [Establishing connection with Chats](#establishing-connection-with-chats)
* [Set up Facebook comment settings](#set-up-facebook-comment-settings)
* [Configure your sources](#configure-your-sources)
* [Create a curated list of your messages](#creating-a-curated-list)
* [Set up Autoplay for your messages](#set-up-autoplay-for-your-messages)

## Establishing connection with Chats

1. Add your Chat graphic from the Library into your Project List.
2. Under the Data Controller column of your chat graphic, select **Add Source** > **Productivity** > **Chat** > **Chat** or **Social** > **Chat** > **Chat**. This opens the Chat controller in the Properties Panel.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-7f3e17557bad9c466c1be73a42ad73e94a2ff3a2%2Fimage_2837.jpg?alt=media" alt="Choose Chat"><figcaption></figcaption></figure></div>
3. The first time you connect, you will be prompted to authenticate. Go to **Settings > Internet Accounts** to open the Service Accounts panel, select the service, and follow the instructions to sign in.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-e2f01068accecb79a2b5fa96b1859524dd481d4d%2Fimage_6527.jpg?alt=media" alt="Internet Accounts sign-in"><figcaption></figcaption></figure></div>

Continue with [Set up Facebook comment settings](#set-up-facebook-comment-settings) or [Configure your sources](#configure-your-sources).

## Set up Facebook comment settings

If you are connecting to Facebook, you have the option to include comments from any of the pages managed by your account.

{% hint style="info" %}
Facebook has placed some limitations on content that is available based on the specific permission privileges of an administrator. Captivate can:
{% endhint %}

* receive the photos, videos, and text content of posts and comments posted to **a page you administer**.
* access the content of **your own posts on your own timeline**. You cannot see anything posted by someone else on your timeline, including comments on your own posts at this time.
  1. Select the various pages and user/posts you would like to include in the chat controller.

     <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-de3fd57c842c1bb0c9eff20b8b9125992846d7a5%2Fimage_7732.jpg?alt=media" alt="Select Facebook sources"><figcaption></figcaption></figure></div>

## Configure your sources

Once you have established a connection to all accounts you’d like to include in your Chat controller, configure each source within the Chat panel.

1. In the Chat Panel, choose any of the Service options to pull from.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-1b71ae22d28a43376da4efa8653e172e703b9ae0%2Fimage_7449.jpg?alt=media" alt="Service options"><figcaption></figcaption></figure></div>
2. Select the source for that service.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-509f0c0dcdf4782c3a7a22338961401add92322d%2Fimage_1311.jpg?alt=media" alt="Source selection"><figcaption></figcaption></figure></div>

   Select all pages and timelines you would like to pull comments from.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-92f19e64ef74d6cf3c6ed073b2f52fe6f3f5127d%2Fimage_8529.jpg?alt=media" alt="Pages and timelines"><figcaption></figcaption></figure></div>
3. Select each post you would like to include comments from and click **Return to Messages**.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-dd958b8dad66e3f481160e7e25bf861784af7aab%2Fimage_1502.jpg?alt=media" alt="Return to Messages"><figcaption></figcaption></figure></div>
4. Messages will automatically populate in the Chat panel. You have the option to search in X by `from:` for specific comments.

   **📌 NOTE**\
   X/Twitter API only supports 'incomplete' data — from our testing, about 30% of posts are not recognized as high enough priority in search per the X algorithm.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-6a1864cc94d05b93a5b7ffb4ed3efddc2db040a7%2Fimage_887.jpg?alt=media" alt="Message list"><figcaption></figcaption></figure></div>
5. Press the **Play** button to send the message text to your graphic. The message will then show as slightly greyed out, indicating it has been played.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-8c0e52cb86f4ef586b36b84b493c76bbe44f6ae6%2Fimage_1468.jpg?alt=media" alt="Played message"><figcaption></figcaption></figure></div>

   You have the option to **Hide** the message or **Delete** from the message list to optimize screen space.

   **📌 NOTE**\
   If you delete messages that you want to play again, you will need to re-add the source for them to re-populate.

## Creating a curated list

1. This is an option if there are two operators or the controller is open from the browser.
2. Press the two-column option to open the second column as your chat queue.
3. Select the checkbox for any message in the first column to add it to your message queue.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-6c98a53679638818aef74fcf3989eed0d002cc17%2Fimage_3397.jpg?alt=media" alt="Curated playlist"><figcaption></figcaption></figure></div>
4. Play the comments from your curated list.

## Set up Autoplay for your messages

1. Press the gear icon in the upper right corner of the Chat panel.
2. Toggle **Autoplay** on and enter the number of seconds to play per item. Any message added to your chat queue will play automatically for the set duration.
3. Toggle on the **Loop** option to autoplay the entire queue again after the last message has been played.

   <div align="left"><figure><img src="https://352477438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFCWMxradHcVjURnrXSYX%2Fuploads%2Fgit-blob-f23138da153a60b50f3e07d4415927c0dedc4049%2Fimage_937.jpg?alt=media" alt="Autoplay settings"><figcaption></figcaption></figure></div>
4. Press **Start** and the chats will play for the set time and loop continuously.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://captivatehelp.newbluelive.com/play-and-update-graphics/chapter-index-3/social-chat-controller.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
