Integration

Twitter/X

Publish posts and react to Twitter/X events in your workflows.

Overview

The Twitter/X integration adds dedicated triggers and actions so you can build workflows around events, device state, or external updates.

Event Triggers

React to inbound events and status updates.

Action Effects

Send commands and automate responses.

Automation Hooks

Combine triggers with other plugins and scripts.

Setup

1

Enable the Plugin

Open FaustBot settings and enable the Twitter/X integration.

2

Connect Your Account or Device

Provide any required credentials or connection details.

3

Verify the Connection

Trigger a test action to confirm the integration is responding.

Connection Tips

Keep the service running and verify network permissions if the connection fails.

Triggers

  • Connection status changes (connected, disconnected, error).
  • Incoming events or webhook notifications.
  • State changes reported by the service or device.

Effects

  • Send commands or updates to Twitter/X.
  • Change device settings or activate presets.
  • Sync data into variables for other actions.

Scripting API

Use the CPH API to control Twitter/X directly from scripts:

Posting Tweets

Posting tweets 
# Post a simple tweet
CPH.TwitterPost("Going live now! Come join the stream!")

# Post with an image
CPH.TwitterPostWithMedia("Check out this highlight!", "/path/to/image.png")

# Post a reply to a tweet
CPH.TwitterReply(tweetId, "Thanks for the follow!")

User Actions

User actions 
# Like a tweet
CPH.TwitterLike(tweetId)

# Retweet
CPH.TwitterRetweet(tweetId)

# Follow a user
CPH.TwitterFollow("username")

Getting Data

Getting data 
# Get user info
user = CPH.TwitterGetUser("username")

# Get recent mentions
mentions = CPH.TwitterGetMentions()

# Check connection status
connected = CPH.TwitterIsConnected()

See the full API reference for all available Twitter/X methods.