Twitter (X) Integration

This guide explains how to connect Twitter (X) to Supervity, what data is available after connection, how operators can use Twitter data and actions within workflows, and how to remove the integration when needed.

---

Overview

The Supervity Twitter (X) integration allows your workspace to securely connect Twitter as a governed platform capability.

Once connected, operators and workflows can use Twitter data and actions to automate social media management, monitor brand mentions, engage with users, and coordinate communication across platforms.

With the Twitter integration, Supervity can:

• Post and delete tweets on behalf of your account
• Retrieve tweet details and performance metrics
• Search for recent tweets matching specific queries or hashtags
• Manage retweets and likes for community engagement
• Access user profile information and network data
• Manage Twitter lists and their members
• Send and read direct message events
• Monitor social media activity as context for operators
• Trigger workflows based on Twitter engagement

All Twitter access is governed through Supervity's security, permissions, and audit controls.

---

Prerequisites

Before connecting Twitter (X), ensure you have:

• An active Supervity workspace
• A Twitter (X) account
• Permission to authorize third-party applications on your Twitter account
• Access to the account containing the data you want to use for automation

Note: Some features such as high-volume searching or specific direct message capabilities may be subject to your Twitter (X) account's tier and platform rate limits.

---

Adding the Twitter (X) Integration

Follow these steps to connect Twitter (X) to Supervity. If you encounter any issues during setup, refer to the Troubleshooting section of this guide.

Step 1: Open Integrations

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.

This opens the Integrations page, where all available integrations are listed. Connected integrations and available integrations can both be managed from this page.

Step 2: Select Twitter (X)

1. Locate Twitter (X) in the available integrations list.
2. Click Connect.

Step 3: Authorize Access

You will be redirected to Twitter's authorization page.

Review the requested permissions and click Authorize app to grant Supervity access to your Twitter (X) account.

• Supervity uses Twitter's standard OAuth 2.0 authorization flow.
• Your Twitter password is never shared with or stored by Supervity.

Step 4: Complete Connection

After authorization, you will be redirected back to Supervity.

The Twitter (X) integration will appear as Connected on the Integrations page. Your workspace can now securely access Twitter capabilities according to the permissions granted.

Having trouble? See the Troubleshooting section for step-by-step help with common setup issues.

---

How Twitter (X) Works in Supervity

After connection, Twitter becomes available as a governed platform tool.

Operators can use Twitter capabilities when planning and executing tasks, while workflows can automate actions using Twitter data.

Common use cases include:

• Automating brand updates and scheduled announcements
• Monitoring brand mentions for sentiment analysis
• Reading and responding to direct message inquiries
• Managing curated lists for industry monitoring
• Synchronizing social media activity with CRM or support systems
• Analyzing engagement metrics for reporting
• Triggering internal workflows based on specific social media events

---

Using Twitter (X) in Operators

Connected Twitter capabilities become available to operators automatically. Operators determine when Twitter data or actions are required to complete a task and execute accordingly, while remaining governed by workspace permissions, security controls, and approval policies.

What Operators Can Do with Twitter (X)

Operators can perform the following actions using Twitter (X):

• Create, retrieve, and delete tweets
• Search recent tweets to monitor trends or brand mentions
• Retweet and like posts to drive engagement
• Follow or unfollow users to manage your social network
• Create and manage Twitter lists and member associations
• Send direct messages and retrieve conversation events
• Retrieve user profiles and account metadata
• Correlate Twitter activity with marketing, sales, or business systems
• Generate summaries, insights, and performance reports from Twitter data
• Combine Twitter data with other connected applications for end-to-end automation

Typical Operator Use Cases

---

Features & Prerequisites

For each Twitter capability available in Supervity, the following describes the use case and the prerequisites required before use.

Tweet Management

Use Case: Post new tweets, retrieve specific tweet details, or delete posts. Useful for automated announcements and maintaining a clean social presence.

Prerequisites:

• Twitter (X) account connected to Supervity
• Appropriate permissions to post and delete content

---

Social Search & Monitoring

Use Case: Search for recent tweets matching specific queries or filters. Useful for brand monitoring, tracking hashtags, and gathering market intelligence.

Prerequisites:

• Twitter (X) account connected to Supervity
• Search results are subject to Twitter's recent search limitations

---

Engagement Actions

Use Case: Like, unlike, and retweet posts to engage with the audience. Useful for building community presence and driving visibility.

Prerequisites:

• Twitter (X) account connected to Supervity
• The target tweet must be public and accessible

---

User & Network Retrieval

Use Case: Retrieve user profiles, follower lists, and following data. Useful for audience analysis and network management.

Prerequisites:

• Twitter (X) account connected to Supervity
• Private profiles may restrict certain data retrieval

---

List Management

Use Case: Create and manage curated lists of users. Useful for segmenting feeds and monitoring specific groups of influencers or customers.

Prerequisites:

• Twitter (X) account connected to Supervity
• List limits are governed by Twitter's account policies

---

Direct Messaging

Use Case: Send and retrieve direct messages. Useful for private customer support and personalized outreach.

Prerequisites:

• Twitter (X) account connected to Supervity
• The recipient's DM settings must allow for incoming messages

---

Permissions Requested

Supervity only requests the permissions required for enabled Twitter (X) capabilities.

Depending on the features used in your workspace, permissions may include:

Supervity follows least-privilege principles and only accesses data necessary to provide requested functionality.

---

Authentication & Security

The Twitter (X) integration uses OAuth 2.0 with PKCE.

Security controls include:

• Encrypted credential storage (AES-256)
• Least-privilege access scopes
• Token refresh and rotation support
• Immediate revocation capabilities
• Workspace-level governance controls
• Complete audit logging
• TLS 1.3 for all API and UI connections

All Twitter access remains subject to Supervity security policies and role-based permissions.

---

Managing the Integration

View Connection Status

From the left navigation bar, click the Integrations icon.

For Twitter (X) you can view:

• Connection status
• Granted permissions
• Last usage information
• Associated workflows and operators

Reconnect Twitter (X)

If Twitter authorization expires:

1. Open the Integrations page from the left navigation bar.
2. Select Twitter (X).
3. Click Reconnect.
4. Complete authorization again.

Existing workflows and operators do not need to be recreated.

Removing the Twitter (X) Integration

You can remove the Twitter connection from your Supervity workspace at any time directly from within the Supervity platform.

Steps to Remove

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.
3. Locate and select Twitter (X) from the integrations list.
4. Click Disconnect.
5. Confirm the action when prompted.

Implications of Removal

Once removed:

• Supervity immediately loses all access to your Twitter account and associated data
• No new tweets or messages will be processed after removal
• All active Twitter connections within your Supervity workspace are terminated
• Scheduled or active workflows that depend on Twitter will stop executing
• Twitter-dependent workflow steps will fail safely with clear error messages
• Existing workflow definitions within Supervity are not deleted — only the Twitter connection is terminated
• Historical execution logs remain available for auditing purposes

Disconnecting Twitter does not delete workflow definitions, operators, or previously generated outputs.

How Your Data Is Handled After Removal

Data Handling on Removal:

• Supervity immediately loses access to your Twitter account upon removal
• No new Twitter data will be collected or processed after disconnection
• Temporary files processed during workflow execution are deleted after execution completes
• Twitter access tokens and all account-related data are permanently deleted from Supervity's platform within 15 minutes of disconnection — no background access continues after removal

Deauthorization Handling

When you disconnect Twitter from Supervity, Supervity:

• Revokes and permanently deletes all stored access tokens and account-related data for your Twitter account within 15 minutes
• Terminates all active Twitter connections associated with your workspace
• Stops all scheduled or active workflows that depend on Twitter access
• Logs the disconnection event for audit and compliance purposes

---

Auditing & Observability

All Twitter activity performed through Supervity is logged.

Audit records include:

• Which operator requested access
• Which workflow executed the action
• Timestamp of execution
• Success or failure status
• Relevant inputs and outputs (redacted when sensitive)

This supports compliance, troubleshooting, governance, and operational visibility.

---

Troubleshooting

If you encounter issues at any stage, refer to the steps below. For issues not covered here, contact the Supervity support team.

Authorization Failed During Setup

Likely Cause: Incorrect Twitter account used, or the app was not granted the necessary permissions during the OAuth flow.

Resolution:

1. Ensure you are signed in to the correct Twitter (X) account.
2. Confirm you have permission to authorize third-party apps on your account.
3. Return to Supervity → Integrations → Twitter (X) and click Connect to retry.

---

Twitter (X) Shows Connected but Data Is Missing

Likely Cause: Required permissions were not granted during authorization, or the content (tweet/user) is private or has been deleted.

Resolution:

1. Verify that all required permissions were accepted during the OAuth authorization step.
2. Confirm that the content you are requesting exists and is public.
3. Reconnect the integration via Integrations → Twitter (X) → Reconnect to refresh permissions.

---

Connection Expired or Token Invalid

Likely Cause: OAuth tokens may expire or be revoked by the user within Twitter account settings.

Resolution:

1. Go to Integrations → Twitter (X) → Reconnect.
2. Complete the Twitter authorization flow again.
3. Existing workflows do not need to be reconfigured after reconnection.

---

Workflow Cannot Access Twitter (X)

Likely Cause: Twitter may have been disconnected, or your account has reached its platform rate limits.

Resolution:

1. Confirm Twitter is still connected under the Integrations page.
2. Check your Twitter account's standing and API usage limits.
3. Verify the workflow has permission to use Twitter within your workspace governance settings.

---

Direct Messages Not Sending or Receiving

Likely Cause: Recipient settings may block DMs, or the authenticated account has reached messaging limits.

Resolution:

1. Verify the recipient's account allows direct messages from you.
2. Check for any account restrictions on Twitter.
3. Review workflow inputs for any invalid content or formatting.

---

Posting Tweets Fails

Likely Cause: Duplicate content (Twitter restricts identical posts in a short window) or account suspension.

Resolution:

1. Ensure your workflow is not attempting to post the exact same content repeatedly.
2. Verify your Twitter account is active and in good standing.
3. Check for character limit violations (280 characters for standard accounts).

---

Frequently Asked Questions

Q: Is my Twitter password shared with or stored by Supervity?

No. Supervity uses Twitter's standard OAuth 2.0 authorization flow. Your Twitter password is never shared with or stored by Supervity. Only scoped access tokens are stored, and these are encrypted at rest using AES-256.

---

Q: Does Supervity support both Twitter and X branding?

Yes. The integration supports the platform regardless of the branding used, utilizing the latest API standards.

---

Q: Will I need to reconfigure my workflows after reconnecting Twitter?

No. If you reconnect Twitter due to token expiry or permission changes, existing workflow definitions and operators do not need to be recreated or reconfigured.

---

Q: What happens to my workflows if I disconnect or remove Twitter?

Workflow definitions are not deleted when Twitter is disconnected or removed. However, any workflow steps that depend on Twitter will fail safely with clear error messages until Twitter is reconnected.

---

Q: How do I authorize the Supervity Twitter (X) integration?

Log in to Supervity at Supervity, navigate to the Integrations page from the left navigation bar, locate Twitter (X), and click Connect. You will be redirected to Twitter's authorization page where you can review and approve the requested permissions. After authorization, you will be redirected back to Supervity automatically. See the Adding the Twitter (X) Integration section above for full step-by-step instructions.

---

Q: Can I limit which Twitter data Supervity can access?

Supervity requests only the permissions required for enabled capabilities, following least-privilege principles. You can review all requested scopes during the OAuth authorization step before approving.

---

Q: Who do I contact if I have an issue with the integration?

Contact the Supervity support team. See the Support section below for full contact details, support hours, and SLA information.

---

Support

If you need assistance with the Twitter (X) integration, visit the Support page.

Support Hours

• Monday to Friday, 9:00 AM – 6:00 PM IST
• Requests submitted outside business hours will be addressed on the next business day

First Response SLA

• All support requests receive an initial response within 24 business hours

Contact Information

When Contacting Support, Please Provide

• Workspace name
• Twitter username used for authorization
• Relevant workflow or operator information
• Error messages or screenshots when available

This helps the support team investigate and resolve issues more quickly.

---

Related Documentation

• Integrations Overview
• OAuth2
• Security & Privacy
• Supervity Website