# Twitter Integration Guide

You can now integrate Twitter directly with Hype Engine. This integration offers two powerful ways to engage your community: the **Main Feed** and the **Community Feed**.

{% embed url="<https://youtu.be/jKZNeOzq7jQ>" %}

#### Feature Overview

**1. Main Feed**\
Your members will be automatically alerted and pinged whenever you post an official tweet. Members earn points by retweeting or replying to these posts. We check for new tweets and update your feed every 10 minutes.

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2F6k5TngXGpLOEvVqNqW2V%2Fimage.png?alt=media&#x26;token=1ac480fb-b5e9-49b0-98fe-3a447a9bff3e" alt=""><figcaption></figcaption></figure>

**2. Community Feed**\
We surface tweets that your members have written about you, filter out low-quality content, and broadcast the best posts to your Discord. Fellow members can earn points by engaging with these community tweets. We scan for and update community content every 4 hours.

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FZK6FYgLgjF8A6WfHinlq%2Fimage.png?alt=media&#x26;token=6a075a6f-0ef2-4f72-9343-e067f447f31f" alt=""><figcaption></figcaption></figure>

#### Analytics

{% embed url="<https://youtu.be/8qytImRRH5o>" %}

You can find Twitter-related analytics on your dashboard: insights.communityone.io/dashboard/\[server\_id]/&#x20;

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FuPipJEp6PWJNDf9YGdgu%2Fimage.png?alt=media&#x26;token=2b8d1eb4-f0ad-4ed9-a313-723c43c36a61" alt=""><figcaption></figcaption></figure>

Here's a list of aggregate analytics that you can track on a daily basis

* The number of tweets that we've broadcast
* The number of Discord members who engage with your tweet
* The total number of twitter actions (likes, retweets, replies) from your Discord
* The number of followers from your Discord

In addition, you can see the specific list of users and their actions

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FOiRgolOgHEXfCyFPHUHz%2Fimage.png?alt=media&#x26;token=93611ca1-f410-4c89-96f2-587bf1a19225" alt=""><figcaption></figcaption></figure>

You can use our analytics to set up your own community-driven creator-lite program. Enable the community feed, and we will provide a list of users who mentioned you in their original posts. You can click on specific users, review their content, and decide what to do for your program.

Here's a list of analytics that we provide about your community members writing original content

* Twitter name, followers, day tweeted
* Rejected tweets: Posts that have mentioned you but are automatically filtered out because of FUD or low quality

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FVSVKgoPWAfbA6fU6tDQQ%2Fimage.png?alt=media&#x26;token=1e0ec57e-9717-4df8-923b-8e33b8c92d1c" alt=""><figcaption></figcaption></figure>

#### Setup Instructions

To get started, navigate to your **Dashboard** ⇒ **Hype Engine** ⇒ **Socials tab**. ![](https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FECgnKcMTv4zwFy3B903N%2Fimage.png?alt=media\&token=7d46030b-d04a-4b01-8092-38f6a2f02f4a)

**Step 1: Connect Your Twitter Account**

This step establishes which account’s messages will be broadcast to the Main Feed and which handle we should "listen" to for community mentions.

* **Free Accounts:** Connect up to 1 Twitter account.
* **Hype Engine Premium:** Connect unlimited accounts.

**Tip:** Consider connecting the personal Twitter accounts of your core team members. We often find that community members engage more with human accounts than they do with official brand accounts.<br>

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2Fs5I4StgKxfweSRTxf0Na%2Fimage.png?alt=media&#x26;token=77e3f47e-18ed-47b2-b645-f6a42e89e8b9" alt=""><figcaption></figcaption></figure>

**Step 2: Set Up Your Main Feed**&#x20;

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FoNLQmnRZ1y8FZTYj31GX%2Fimage.png?alt=media&#x26;token=aff5d318-53fa-4562-a042-5854adb743e5" alt=""><figcaption></figcaption></figure>

Configure how your official tweets appear in Discord:

* **Feed Channel:** Select the Discord channel where you want your tweets announced. Most communities name this channel something like `#socials` or `#twitter`.&#x20;

{% hint style="info" %}
Alerts *for Youtube and Twitch are coming soon!*
{% endhint %}

* **Reward Actions:** Currently, we support **Follow**, **Reply,** **Retweet**, **Retweet w Comments** as rewardable actions. (If you would like to see other actions supported, please reach out to us on our Discord). Once a user completes the action and clicks the "Check Reward" button, we will automatically grant them points.&#x20;

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2FeV1aWqOy43wMmvSUPhK2%2Fimage.png?alt=media&#x26;token=40a4d6e7-7340-4081-baff-c736b7d0cce0" alt=""><figcaption></figcaption></figure>

* **Notify:** Choose which roles to ping when a new tweet goes live. We recommend tagging `@everyone` for the Main Feed.
  * *Premium Feature:* You can create specific alert roles, such as `@twitter-ping`, to target specific users.
* **Expire After:** Set the lifespan of a tweet reward (how long users have to claim points).

**Step 3: Set Up Community Feed**&#x20;

<figure><img src="https://3533212473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmfBBh2ORXj35Ey5JhNd%2Fuploads%2F07Xup9digtXXHv6gjXRk%2Fimage.png?alt=media&#x26;token=16a1fc38-d5cf-49bd-a9db-1bcb94fa3766" alt=""><figcaption></figcaption></figure>

The setup process is similar to the Main Feed, though this step is optional.

* **Channel Strategy:** We see many communities use a separate channel called `#community-content` to broadcast these member tweets.
* **Notification Strategy:** We recommend using `@here` for the Community Feed rather than `@everyone`.
* **Lifespan:** Generally, the lifespan of a community tweet reward should be shorter than that of official tweets.

{% hint style="info" %}
For **Premium Users:** We **STRONGLY RECOMMEND** using the `/award-points` command to give users extra bonus points if you really like their tweets. \
\
This provides specific feedback on what constitutes "good" content based on your standards. We have noticed that members are significantly more motivated to improve the quality of their content when they know a human is watching and rewarding their efforts.
{% endhint %}

\ <br>

<br>