Platform

Twitter/X Integration

Full Twitter/X integration including live streaming, tweets, interactions, and Spaces support.

Overview

FaustBot's Twitter/X integration provides access to live streaming and social features:

Live Streaming

Stream directly to X with chat and engagement tracking.

Tweet Automation

Post tweets, threads, and media automatically from your streams.

Spaces Integration

Connect to X Spaces for audio streaming events.

Engagement Tracking

Track likes, retweets, replies, and new followers in real-time.

Connecting Your Account

1

Open Twitter/X Settings

Click Twitter/X in the sidebar to open the integration page.

2

Connect Your Account

Click Connect Account and authorize FaustBot to access your Twitter/X account. This grants permissions for posting and reading your timeline.

Screenshot: Twitter/X OAuth authorization
3

Configure Permissions

Select which permissions to enable: tweeting, reading DMs, or accessing Spaces. You can modify these later in settings.

API Access

Some features require Twitter/X API access. If you have a developer account, you can enter your API keys for enhanced functionality.

Available Triggers

FaustBot can respond to Twitter/X events in real-time:

Live Stream Events

Live Comment Comment on your live stream
Stream Started Live stream went online
Stream Ended Live stream ended
Viewer Joined New viewer joined the stream

Tweet Events

Mention Someone mentioned you in a tweet
Reply Reply to one of your tweets
Quote Tweet Someone quoted your tweet

Engagement Events

Like Someone liked your tweet
Retweet Someone retweeted your post
Follow New follower
Unfollow Someone unfollowed you

Spaces Events

Space Started Your Space went live
Space Ended Your Space ended
Speaker Request User requested to speak
Listener Joined New listener joined the Space

Effects

Actions can use these Twitter/X-specific effects:

Send Tweet

Post a tweet with text and optional media.

Reply to Tweet

Reply to a specific tweet.

Quote Tweet

Quote a tweet with your commentary.

Retweet

Retweet a post.

Like Tweet

Like a specific tweet.

Send DM

Send a direct message to a user.

Follow User

Follow a Twitter/X user.

Block User

Block a user from your account.

Create Thread

Post a multi-tweet thread.

Delete Tweet

Delete one of your tweets.

Variables

The following variables are available in Twitter/X triggers:

VariableDescription
%user%Twitter handle (without @)
%displayName%Display name
%userId%Twitter/X user ID
%message%Tweet or comment text
%tweetId%Unique tweet ID
%tweetUrl%URL to the tweet
%isVerified%Whether user is verified
%followerCount%User's follower count
%likeCount%Number of likes on tweet
%retweetCount%Number of retweets
%viewers%Live stream viewer count
%spaceTitle%Title of the Space

Scripting API

Access Twitter/X features from your scripts via the CPH API:

Tweets

Tweets 
# Send a tweet
CPH.TwitterSendTweet("Going live now! Come hang out!")

# Send a tweet with image
CPH.TwitterSendTweet("Check this out!", imagePath="/path/to/image.png")

# Reply to a tweet
CPH.TwitterReply(args["tweetId"], "Thanks for the mention!")

# Quote tweet
CPH.TwitterQuoteTweet(args["tweetId"], "This is amazing!")

Engagement

Engagement 
# Like a tweet
CPH.TwitterLike(args["tweetId"])

# Retweet
CPH.TwitterRetweet(args["tweetId"])

# Follow a user
CPH.TwitterFollow(args["userId"])

# Unfollow a user
CPH.TwitterUnfollow(args["userId"])

Moderation

Moderation 
# Block a user
CPH.TwitterBlockUser(args["userId"])

# Unblock a user
CPH.TwitterUnblockUser(args["userId"])

# Mute a user
CPH.TwitterMuteUser(args["userId"])

User Info

User Info 
# Get user info
user = CPH.TwitterGetUserInfo("username")
print(f"Display Name: {user.DisplayName}")
print(f"Followers: {user.FollowerCount}")
print(f"Verified: {user.IsVerified}")

See the full API reference for all available methods.