Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/biaw/phone
A Discord application to call your cellphone through Twilio in case of emergencies. Built with Cloudflare Workers
https://github.com/biaw/phone
bot cf-worker cf-workers cloudflare cloudflare-worker cloudflare-workers discord discord-bot discord-interactions discord-rest twilio twilio-caller
Last synced: 16 days ago
JSON representation
A Discord application to call your cellphone through Twilio in case of emergencies. Built with Cloudflare Workers
- Host: GitHub
- URL: https://github.com/biaw/phone
- Owner: biaw
- License: mit
- Created: 2021-01-23T17:43:14.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-18T23:31:43.000Z (2 months ago)
- Last Synced: 2024-10-19T14:48:30.537Z (2 months ago)
- Topics: bot, cf-worker, cf-workers, cloudflare, cloudflare-worker, cloudflare-workers, discord, discord-bot, discord-interactions, discord-rest, twilio, twilio-caller
- Language: TypeScript
- Size: 1.33 MB
- Stars: 34
- Watchers: 2
- Forks: 10
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://github.com/biaw/phone/actions/workflows/build-and-publish.yml)
[](https://github.com/biaw/phone/actions/workflows/linting.yml)
[](https://deepscan.io/dashboard#view=project&tid=16173&pid=19527&bid=625870)
[](https://github.com/biaw/phone/issues)
[](https://github.com/biaw/phone/pulls)
# Discord Phone Worker [](https://deploy.workers.cloudflare.com/?url=https://github.com/biaw/phone)
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](https://deploy.workers.cloudflare.com/?url=https://github.com/biaw/phone)
2. Insert the environment variables listed in the [`wrangler.toml`](https://github.com/biaw/phone/blob/main/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
```mermaid
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
```
## 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.