---
title: Twilio – SMS and WhatsApp
description: "Welcome to the Twilio Integration documentation. Developer can find the D.T Twilio API Documentation [here](https://github.com/DiscipleTools/disciple-tools-channels-twilio). Questions or issues? Let us know on the [Discord Channel](https://discord.gg/kp5pYmrhSd). ## Getting Started with SMS ### 1. Create a Twilio account Visit [https://www.twilio.com/](https://www.twilio.com/) to create…"
url: "https://disciple.tools/docs/twilio/"
updated: "2026-10-09"
category: Initial Setup / Admin Setup / Extensions (D.T)
---

# Twilio – SMS and WhatsApp

Welcome to the Twilio Integration documentation.

Developer can find the D.T Twilio API Documentation [here](https://github.com/DiscipleTools/disciple-tools-channels-twilio).

Questions or issues? Let us know on the [Discord Channel](https://discord.gg/kp5pYmrhSd).

## Getting Started with SMS

### 1. Create a Twilio account

Visit [https://www.twilio.com/](https://www.twilio.com/) to create your account

### 2. Purchase a number for your region

**Step 1**

Navigate to your Twilio Dashboard and click "Develop"

![](https://disciple.tools/wp-content/uploads/image-31-1024x872.jpeg)

**Step 2**

Click "Phone Numbers"

![](https://disciple.tools/wp-content/uploads/image-28-1024x975.jpeg)

**Step 3**

Click "Manage"

![](https://disciple.tools/wp-content/uploads/image-32-1024x978.jpeg)

**Step 4**

Click "Active numbers"

![](https://disciple.tools/wp-content/uploads/image-33-1024x744.jpeg)

**Step 5**

Click "Buy a number"

![](https://disciple.tools/wp-content/uploads/image-29-1024x571.jpeg)

**Step 6**

Choose a number for your region and click "Buy"

![](https://disciple.tools/wp-content/uploads/image-30-1024x749.jpeg)

**Step 7**

Confirm by clicking "Buy"

![](https://disciple.tools/wp-content/uploads/image-34-1024x598.jpeg)

**Step 8**

You now own an awesome number!

### 3. Setup a messaging service

**Step 1**

Navigate to your Twilio Console and click this Messaging

![](https://disciple.tools/wp-content/uploads/image-35-964x1024.jpeg)

**Step 2**

Click "Services"

![](https://disciple.tools/wp-content/uploads/image-36-1024x745.jpeg)

---

**Step 3**

Click "Create Messaging Service"

![](https://disciple.tools/wp-content/uploads/image-38-1024x904.jpeg)

---

**Step 4**

Name your Messaging Service. "Disciple.Tools" is fine.

![](https://disciple.tools/wp-content/uploads/image-49-1024x853.jpeg)

---

**Step 5**

What do you want to use this Messaging Service for?\ Leave this section as "Notify my users"

![](https://disciple.tools/wp-content/uploads/image-50-1024x898.jpeg)

---

**Step 6**

Click "Create Messaging Service"

![](https://disciple.tools/wp-content/uploads/image-40-1024x585.jpeg)

---

**Step 7**

In Step 2, Click "Add Senders"

![](https://disciple.tools/wp-content/uploads/image-42-1024x754.jpeg)

---

**Step 8**

Leave Sender Type as Phone Number and Click "Continue"

![](https://disciple.tools/wp-content/uploads/image-41-1024x784.jpeg)

---

**Step 9**

Select your phone number

![](https://disciple.tools/wp-content/uploads/image-43-782x1024.jpeg)

---

**Step 10**

Click "Add Phone Numbers"

![](https://disciple.tools/wp-content/uploads/image-44-1024x542.jpeg)

---

**Step 11**

Click "Step 3: Set up integration"

![](https://disciple.tools/wp-content/uploads/image-45-1024x585.jpeg)

---

**Step 12**

Click here.

![](https://disciple.tools/wp-content/uploads/image-48-1024x794.jpeg)

---

**Step 13**

Go to your activated Twilio plugin in the WP Admin and copy the webhook url

![](https://disciple.tools/wp-content/uploads/image-47-1024x539.jpeg)

---

**Step 14**

Paste it in this text field.

![](https://disciple.tools/wp-content/uploads/image-51-1024x676.jpeg)

---

**Step 15**

Click "Step 4: Add compliance info"

![](https://disciple.tools/wp-content/uploads/image-39-1024x442.jpeg)

---

**Step 16**

Click "Complete Messaging Service Setup"

![](https://disciple.tools/wp-content/uploads/image-37-1024x544.jpeg)

---

**Step 17**

Well Done! Proceed to configuring Disciple.Tools

![](https://disciple.tools/wp-content/uploads/image-46-1024x585.jpeg)

---

### 4. Configure Disciple.Tools with your Twilio account information

**Step 1**

Navigate to

![](https://disciple.tools/wp-content/uploads/image-53-1024x784.jpeg)

---

**Step 2**

Copy Account SID

![](https://disciple.tools/wp-content/uploads/image-54-1024x776.jpeg)

---

**Step 3**

Copy your Auth Token

![](https://disciple.tools/wp-content/uploads/image-57-1024x586.jpeg)

---

**Step 4**

Open the Twilio Plugin WP Admin Setting page under D.T Extensions > Channels - Twilio

![](https://disciple.tools/wp-content/uploads/image-52.jpeg)

---

**Step 5**

Enable the Plugin

![](https://disciple.tools/wp-content/uploads/image-62-1024x545.jpeg)

---

**Step 6**

Paste in the Account SID you copied earlier

![](https://disciple.tools/wp-content/uploads/image-61-1024x545.jpeg)

---

**Step 7**

Paste in the Auth Token you copied earlier

![](https://disciple.tools/wp-content/uploads/image-60-1024x685.jpeg)

---

**Step 8**

Click "Update"

![](https://disciple.tools/wp-content/uploads/image-59-1024x497.jpeg)

---

**Step 9**

Click this dropdown.

![](https://disciple.tools/wp-content/uploads/image-58-1024x372.jpeg)

---

**Step 10**

Select the "Disciple.Tools" Messaging Service we created earlier

![](https://disciple.tools/wp-content/uploads/image-56-1024x486.jpeg)

---

**Step 11**

Click "Update"

![](https://disciple.tools/wp-content/uploads/image-55-1024x410.jpeg)

---

### 5. Setup Disciple.Tools to send notifications via SMS

**Step 1**

Open the Twilio Plugin WP Admin Setting page under D.T Extensions > Channels - Twilio

![](https://disciple.tools/wp-content/uploads/image-63.jpeg)

---

**Step 2**

Go to the "Assigned Telephone Numbers" section

![](https://disciple.tools/wp-content/uploads/image-65-1024x704.jpeg)

---

**Step 3**

Enable the Notifications

![](https://disciple.tools/wp-content/uploads/image-66-1024x478.jpeg)

---

**Step 4**

Select which Phone Number you want to send notifications from.

![](https://disciple.tools/wp-content/uploads/image-67-1024x374.jpeg)

---

**Step 5**

Click "Update"

![](https://disciple.tools/wp-content/uploads/image-64-1024x246.jpeg)

---

## Getting Started with WhatsApp

After you complete steps 1-3 from Getting Started with SMS you can also set up WhatsApp

### 1. Setup up a WhatsApp Sender

**Step 1**

Navigate to

![](https://disciple.tools/wp-content/uploads/image-68-1024x816.jpeg)

---

**Step 2**

Click "Messaging"

![](https://disciple.tools/wp-content/uploads/image-71-1024x965.jpeg)

---

**Step 3**

Click "Senders"

![](https://disciple.tools/wp-content/uploads/image-72-861x1024.jpeg)

---

**Step 4**

Click "WhatsApp senders"

![](https://disciple.tools/wp-content/uploads/image-69-768x1024.jpeg)

---

**Step 5**

Click "Get Started"

![](https://disciple.tools/wp-content/uploads/image-80-1024x552.jpeg)

---

**Step 6**

Click the "Select Twilio number" field.

![](https://disciple.tools/wp-content/uploads/image-79-1024x823.jpeg)

---

**Step 7**

Select your phone number

![](https://disciple.tools/wp-content/uploads/image-73-1024x384.jpeg)

---

**Step 8**

Click "Continue"

![](https://disciple.tools/wp-content/uploads/image-77-1024x823.jpeg)

---

**Step 9**

Click "Continue with Facebook"

![](https://disciple.tools/wp-content/uploads/image-78-1024x883.jpeg)

---

**Step 10**

The next steps are not show here.\ The modals will guide you through linking Twilio with you Facebook Account, and creating an WhatsApp profile using Facebook Business.

---

**Step 11**

After the setup up the Facebook WhatsApp profle, click "WhatsApp senders"

![](https://disciple.tools/wp-content/uploads/image-74-1024x771.jpeg)

---

**Step 12**

Click you phone number.

![](https://disciple.tools/wp-content/uploads/image-75-1024x922.jpeg)

---

**Step 13**

In Endpoint Configuration select "Use a Messaging Service" and select the one we create earlier.

![](https://disciple.tools/wp-content/uploads/image-76-1024x473.jpeg)

---

**Step 14**

Click "Update WhatsApp Sender"

![](https://disciple.tools/wp-content/uploads/image-70-1024x547.jpeg)

---

**Done**

Nice work! You are now ready to configure Disciple.Tools to send WhatsApp messages and notifications.

---

### 2. Setup Disciple.Tools to send notifications via WhatApp

**Step 1**

Open the Twilio Plugin WP Admin Setting page under D.T Extensions > Channels - Twilio

![](https://disciple.tools/wp-content/uploads/image-81.jpeg)

---

**Step 2**

Go to the "Assigned Telephone Numbers" section

![](https://disciple.tools/wp-content/uploads/image-84-1024x545.jpeg)

---

**Step 3**

Click "WhatsApp"

![](https://disciple.tools/wp-content/uploads/image-83-1024x545.jpeg)

---

**Step 4**

Enable WhatsApp Notifications

![](https://disciple.tools/wp-content/uploads/image-85-1024x545.jpeg)

---

**Step 5**

Select which Phone Number you want to send notifications from.

![](https://disciple.tools/wp-content/uploads/image-86-1024x545.jpeg)

---

**Step 6**

Click "Update"

![](https://disciple.tools/wp-content/uploads/image-82-1024x280.jpeg)

---

**Done**

Nice Work!

---

## How to Opt In to receiving notifications via SMS or WhatsApp

**Step 1**

In Disciple.Tools, open your profile settings by clicking your name

![](https://disciple.tools/wp-content/uploads/image-90-1024x538.jpeg)

---

**Step 2**

Scroll down to "Notifications"

![](https://disciple.tools/wp-content/uploads/image-91-1024x801.jpeg)

---

**Step 3**

Click the edit icon to add the number you want to use for SMS notifications

![](https://disciple.tools/wp-content/uploads/image-88-1024x484.jpeg)

---

**Step 4**

For SMS fill out the "Work Phone" field.

![](https://disciple.tools/wp-content/uploads/image-87-1024x536.jpeg)

---

**Step 5**

For WhatsApp notification fill out the "Work WhatsApp" field.

![](https://disciple.tools/wp-content/uploads/image-87-1024x536.jpeg)

---

**Step 6**

Click "Save"

![](https://disciple.tools/wp-content/uploads/image-90-1024x538.jpeg)

---

**Step 7**

Check the numbers are correct.

![](https://disciple.tools/wp-content/uploads/image-89-1024x509.jpeg)

---

**Step 8**

Select which notification types you would like to receive

![](https://disciple.tools/wp-content/uploads/image-92-1024x507.jpeg)

---

**Done**

Nice work! Your notifications are set up.

---