X
Interact with X
X (formerly Twitter) is a popular social media platform that enables real-time communication, content sharing, and engagement with audiences worldwide.
The X integration in Sim Studio leverages OAuth authentication to securely connect with the X API, allowing your agents to interact with the platform programmatically. This OAuth implementation ensures secure access to X's features while maintaining user privacy and security.
With the X integration, your agents can:
- Post content: Create new tweets, reply to existing conversations, or share media directly from your workflows
- Monitor conversations: Track mentions, keywords, or specific accounts to stay informed about relevant discussions
- Engage with audiences: Automatically respond to mentions, direct messages, or specific triggers
- Analyze trends: Gather insights from trending topics, hashtags, or user engagement patterns
- Research information: Search for specific content, user profiles, or conversations to inform agent decisions
In Sim Studio, the X integration enables sophisticated social media automation scenarios. Your agents can monitor brand mentions and respond appropriately, schedule and publish content based on specific triggers, conduct social listening for market research, or create interactive experiences that span both conversational AI and social media engagement. By connecting Sim Studio with X through OAuth, you can build intelligent agents that maintain a consistent and responsive social media presence while adhering to platform policies and best practices for API usage.
Usage Instructions
Connect with X to post tweets, read content, search for information, and access user profiles. Integrate social media capabilities into your workflow with comprehensive X platform access.
Tools
x_write
Post new tweets, reply to tweets, or create polls on X (Twitter)
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
accessToken | string | Yes | X OAuth access token |
text | string | Yes | The text content of your tweet |
replyTo | string | No | ID of the tweet to reply to |
mediaIds | array | No | Array of media IDs to attach to the tweet |
poll | object | No | Poll configuration for the tweet |
Output
| Parameter | Type |
|---|---|
tweet | string |
text | string |
createdAt | string |
authorId | string |
conversationId | string |
inReplyToUserId | string |
attachments | string |
pollId | string |
x_read
Read tweet details, including replies and conversation context
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
accessToken | string | Yes | X OAuth access token |
tweetId | string | Yes | ID of the tweet to read |
includeReplies | boolean | No | Whether to include replies to the tweet |
Output
| Parameter | Type |
|---|---|
tweet | string |
x_search
Search for tweets using keywords, hashtags, or advanced queries
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
accessToken | string | Yes | X OAuth access token |
query | string | Yes | Search query (supports X search operators) |
maxResults | number | No | Maximum number of results to return (default: 10, max: 100) |
startTime | string | No | Start time for search (ISO 8601 format) |
endTime | string | No | End time for search (ISO 8601 format) |
sortOrder | string | No | Sort order for results (recency or relevancy) |
Output
| Parameter | Type |
|---|---|
tweets | string |
includes | string |
media | string |
polls | string |
x_user
Get user profile information
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
accessToken | string | Yes | X OAuth access token |
username | string | Yes | Username to look up (without @ symbol) |
Output
| Parameter | Type |
|---|---|
user | string |
Block Configuration
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
operation | string | Yes | Operation |
Outputs
| Output | Type | Description |
|---|---|---|
response | object | Output from response |
↳ tweet | json | tweet of the response |
↳ replies | any | replies of the response |
↳ context | any | context of the response |
↳ tweets | json | tweets of the response |
↳ includes | any | includes of the response |
↳ meta | json | meta of the response |
↳ user | json | user of the response |
↳ recentTweets | any | recentTweets of the response |
Notes
- Category:
tools - Type:
x