Develop Twitter (X) Integration for Automatic Issue Broadcasting #260
Description
VishwaGuru requires a Twitter (X) integration system that automatically posts public-facing grievance issues to Twitter at the time of issue creation. This is intended to increase public visibility, accountability, and faster escalation of grievances.
Requirements:
When a new issue/grievance is created and marked as public, the system should automatically publish a tweet containing:
Issue title
Short description or summary (within character limits)
Unique issue ID or reference number
Hashtags related to governance, public welfare, and VishwaGuru
Optional link redirecting to the issue detail page
Technical Scope:
Integrate Twitter (X) API v2 using OAuth 2.0
Secure handling of API keys and tokens using environment variables
Backend-triggered event on issue creation
Tweet content formatter with character limit handling and sanitization
Fail-safe mechanism to prevent duplicate tweets
Logging for tweet success/failure
Config flag to enable or disable Twitter posting per issue
Optional Enhancements (Good to Have):
Admin-controlled toggle for auto-posting
Retry queue for failed tweet attempts
Support for media attachments in future iterations
Expected Outcome:
Every eligible grievance issue created on VishwaGuru should be reflected on Twitter in near real-time, ensuring transparency and public reach without manual intervention.
Acceptance Criteria:
Tweet is posted immediately after issue creation
No tweet is posted for private or draft issues
API failures do not block core issue creation flow
Credentials are not exposed in the repository