README.md

Discord Phone Worker

A Discord application to call your phone (yes, your actual phone) through Twilio in case of emergencies.

Screenshots

Click to see a GIF of the `/call` command in action

Usage examples

• If you're managing some form of service, like a webserver or Discord bot then your staff can call your cellphone if it's down.
• If a server you're admin in is getting raided and you're not available, they can call your cellphone to let you know.

Generally, it's a way for other Discord members to contact you through your phone. The main purpose is to be even more available, like when you don't have Wi-Fi/celluar data availale.

Setting up with Workers

1. Deploy with Workers
2. Insert the environment variables listed in the wrangler.toml file. You can either use the wrangler command, or do it through the worker dashboard.
3. Edit the Discord application and set the interactions endpoint to https://phone.WORKER_SUBDOMAIN.workers.dev/interaction. This is where the bot will receive interactions.
4. Go to https://phone.WORKER_SUBDOMAIN.workers.dev/update-commands?key=DISCORD_PUBLIC_KEY to update and register the /call slash command.
5. Add the bot by visiting /invite. Make sure to uncheck "Public bot" in the Discord Developer portal so other people can't add it to servers you don't want to have access to call you.
6. It might take some time before the command appears because of Discord's caching, but you should be able to use the /call command within the hour!

How calling works

sequenceDiagram
  autonumber
  participant D as Discord API
  participant W as Cloudflare Worker
  participant T as Twilio API

  activate D
  D->>W: Send an interaction
  activate W

  alt signature header is not valid
    W-->>D: 401 Unauthorized
  end

  W->>T: Send call request
  activate T
  T->>T: Calls the user
  T-->>W: 200 OK
  deactivate T
  W-->>D: 200 OK (with Interaction Response)
  deactivate D
  deactivate W

  loop until call is finished
    T->>W: Call Status Update
    activate T
    activate W
    W->>D: Update Interaction with new status
    activate D
    D-->>W: 200 OK
    deactivate D
    W-->>T: 200 OK
    deactivate T
    deactivate W
  end

Loading

Pricing

It might cost a tiny little bit of money after you've used up your free trial at Twilio. The amount really depends on your location, the Twilio phone number's location etc. - but the free trial will probably get you a long way already.

I think it's obvious enough... but I will not pay for your phone number.