Live Events Setup Instructions

To receive live events in this dashboard, you need to register a webhook with X that points to this application.

1. Expose Your Local Server

Since this app is running locally (e.g., on http://localhost:3000), you'll need a tool to expose it to the internet. We recommend ngrok.

Install ngrok, then run the following command in your terminal:

ngrok http http://localhost:3000

Ngrok will give you a public forwarding URL (e.g., https://xxxx-xx-xxx-xx-xx.ngrok-free.app). Copy this HTTPS URL.

2. Construct Your Webhook URL

Your full webhook URL for X will be the ngrok HTTPS URL followed by /webhooks/twitter.

Example: https://your-ngrok-url.ngrok-free.app/webhooks/twitter

3. Add the Webhook in this Dashboard

Go to the "Webhooks" tab in this dashboard and add the full webhook URL you constructed above.

4. Subscribe to Events

Once the webhook is added and validated (X will perform a CRC check against /webhooks/twitter), go to the "Subscriptions" tab to subscribe the desired user to this webhook.

5. View Live Events

Return to this "Live Events" tab. Any subscribed events for the user should appear here in real-time.