Twitter Webhook

Deploy a webhook that will resolve and download image and video files for the given post URL.

Accessing the webhook

Make a POST request to the endpoint using Postman / IFTTT / Zapier etc. Content type should be application/json. The JSON body object should contain a url property, with the target post as the value. Example:

{
  "url": "URL_OF_THE_TWEET"
}

Usage

Build and run with NodeJS

Place a .env file in the repository directory that contains your configured variables in key=value format.

port=8080 # The port that the webhook server should use (optional, defaults to 8080)
api_key=YOUR-TWITTER-API-KEY
api_secret=YOUR-TWITTER-API-SECRET
token=YOUR-TWITTER-TOKEN
token_secret=YOUR-TWITTER-TOKEN-SECRET

Install dependencies and deploy:

# Install dependencies
$ npm install

# Run the development server
$ npm run start

# Run the webhook server
$ npm run deploy

Docker

Building the Docker image

$ docker build . -t webhooks-twitter

Running the Docker image

Environment variable configuration is provided via -e flags in docker create command.

docker create \
 --name=webhooks-twitter \
 -e port=8080 `# The port that the internal webserver should use (optional, defaults to 8080)` \
 -e consumer_key=YOUR-TWITTER-API-KEY \
 -e consumer_secret=YOUR-TWITTER-API-SECRET \
 -e token=YOUR-TWITTER-TOKEN \
 -e token_secret=YOUR-TWITTER-TOKEN-SECRET \
 -v ./downloads:/usr/src/app/downloads `# Location of downloaded media files` \
 -p 8080:8080/tcp `# Http` \
 --restart unless-stopped \
 webhooks-twitter

Docker Compose

Environment variable configuration provided yaml environment list.

---
version: '2'
services:
  webhooks-twitter:
    image: webhooks-twitter
    container_name: webhooks-twitter
    restart: unless-stopped
    environment:
      - port # The port that the internal webserver should use (optional, defaults to 8080)
      - consumer_key=YOUR-TWITTER-API-KEY
      - consumer_secret=YOUR-TWITTER-API-SECRET
      - token=YOUR-TWITTER-TOKEN
      - token_secret=YOUR-TWITTER-TOKEN-SECRET
    volumes:
      - ./downloads:/usr/src/app/downloads # Location of downloaded media files
    ports:
      - 8080:8080/tcp # Webhook endpoint

telekineticyeti/twitter-webhook