> For the complete documentation index, see [llms.txt](https://docs.nexus.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexus.bot/guides/alert-module-setup.md).

# Alert Module Setup

Set up Twilio for manual and automatic keyword SMS alerts. Use an active paid account with credit. Screenshots show an older layout; the steps below use current labels.

1. Create a Twilio account at <https://www.twilio.com/try-twilio>, upgrade to a paid account and add funds. Follow the amount shown by Twilio; SMS, number rental and registration costs vary.

![Twilio account upgrade — older console layout.](https://1501270559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLdEj1zzd3YvwG1ITZm%2F-MRdcf9aMlGzaLZ8Uxwn%2F-MRdg4EBSjxqkexM8I0f%2FScreenshot%202021-01-22%20at%2011.42.35.png?alt=media\&token=c8637b5b-cc39-498b-aca9-796118ae6b19)

Step 2 — Copy Account SID (AC...) and Auth Token from the Twilio Console into Nexus → Alert (SMS). Use the same account as your Messaging Service.

![Account SID and Auth Token — older console layout.](https://1501270559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLdEj1zzd3YvwG1ITZm%2F-MRdgNmpKpUM-C0xHoTh%2F-MRdgs89or02Og-QVxc1%2FScreenshot%202021-01-22%20at%2011.44.24.png?alt=media\&token=2f4b1148-3799-4ab8-b012-ab07ae924620)

Step 3 — Open Twilio → Messaging → Services → Create Messaging Service. Follow the prompts, then paste its Messaging Service SID (MG...) into Nexus.

![Messaging Service SID — older console layout.](https://1501270559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLdEj1zzd3YvwG1ITZm%2F-MRdi8jSUvKh2ydREA7g%2F-MRdiwdBoyUFc2iGEEYO%2FScreenshot%202021-01-22%20at%2011.54.10.png?alt=media\&token=afd8c176-2f22-4f95-9548-5e531c8770da)

Step 4 — Open your service → Sender Pool → Add Senders and add an SMS-capable Twilio number. An empty sender pool cannot send texts.

Need a number? Open Phone Numbers → Manage → Buy a number, select SMS capability, and choose a sender suitable for your recipients’ countries. Check the rental price and registration requirements before buying.

![SMS-capable number search — choose for your destination countries.](https://1501270559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLdEj1zzd3YvwG1ITZm%2F-MRdk0Mr7q4qGkAA0CWR%2F-MRdk282fyDhcLg5Eq-t%2FScreenshot%202021-01-22%20at%2011.59.08.png?alt=media\&token=490e2c61-a3f4-4d48-89fc-8621355ab599)

{% hint style="info" %}
US local numbers sending to US recipients need A2P 10DLC registration. US/Canada toll-free SMS needs Toll-Free Verification. Other destinations have their own sender rules; a US number does not work everywhere. Complete the relevant approval before sending.
{% endhint %}

Step 5 — In Twilio’s Messaging Geo Permissions, enable only the countries you need. Country-specific sender rules still apply.

![Nexus Alert (SMS) settings.](https://1501270559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLdEj1zzd3YvwG1ITZm%2F-MRdlMAPIa0QBY8G5Md2%2F-MRdlvRcfwUEJcDmTAvN%2FScreenshot%202021-01-22%20at%2012.05.05.png?alt=media\&token=5a4d516e-0def-4bb7-8a98-1ab80f9cbb09)

Step 6 — Choose a private staff Log Channel and optional Number Verification in Nexus → Alert (SMS), click Save, then enable the module. Configure Staff roles and Member roles in Bot Settings.

{% hint style="info" %}
Number Verification (OTP) texts members a code during signup to confirm their number. This uses your Twilio SMS balance. Members must be able to receive Discord DMs.
{% endhint %}

{% hint style="danger" %}
Keep your Auth Token private: enter it only in your server’s Nexus settings. Never post it in Discord or screenshots. Your Account SID identifies the account; it is not a substitute for the secret Auth Token.
{% endhint %}

### Register and test

Members use `!sms add` or `/sms action:add`, then follow the bot’s DMs and enter their number with its country code. They need a configured Member or Staff role. Use `!sms remove` or `/sms action:remove` to opt out.

After registering your own number, staff can run `/sendfilter content:Test SMS user:@you` for a one-person test. Use `/send` or `!send <message>` for a broadcast with a cost estimate and confirmation. Twilio charges apply; long messages may use multiple paid segments.

### Automatic keyword SMS

Open **Keyword Pinger → Add Keyword** (or edit an existing keyword), choose the source Channel and recipient Role, then tick **Straight to SMS** and save. Keep both Keyword Pinger and Alert (SMS) enabled.

Matching messages trigger SMS for members who have registered a number, match the rule’s role, hold a configured Member/Staff role and can view the source channel. The pinger cooldown applies; normal Discord notifications continue.

### If texts do not arrive

Check the Twilio balance/account status, Messaging Service sender pool, destination Geo Permissions and required sender approvals. Confirm the member has signed up, can receive Discord DMs and has the correct roles. Check your Nexus Log Channel and Twilio Messaging logs for errors; “accepted” does not guarantee delivery.

Twilio guides: [Messaging Services](https://www.twilio.com/docs/messaging/tutorials/send-messages-with-messaging-services) · [Geo Permissions](https://www.twilio.com/docs/messaging/guides/sms-geo-permissions) · [A2P 10DLC](https://www.twilio.com/docs/messaging/compliance/a2p-10dlc) · [Toll-Free Verification](https://www.twilio.com/docs/messaging/compliance/toll-free/console-onboarding).