Disciple Tools - Channels - Twilio WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Send SMS and WhatsApp messages or Disciple.Tools notifications using Twilio.

Pre-requisites

A Twilio Account setup with a phone number and messaging service set up.

To use WhatsApp you'll need a Whatsapp Sender linked to one of your twilio phone numbers.

See setup instructions in the wiki.

Will Do

• Let other plugins (link magic link scheduler) send messages using Twilio.
• Optionally: Setup D.T notifications to be sent over SMS or WhatsApp.
• Provides an API to send messages directly.

API Usage

The Disciple Tools - Channels - Twilio plugin can be decoupled, so as to work independently of the Disciple Tools - Magic Links plugin; in order to send messages directly.

//check if twilio is setup and configured
dt_twilio_configured()

Send as sms to a number. Returns a boolean value indicating if the message was sent successfully.

Disciple_Tools_Twilio_API::send_sms( $phone_number, $message );

Send as WhatsApp message to a number. Note: This will only work if the contact has WhatsApp messaged you in the last 24 hours. Returns a boolean value indicating if the message was sent successfully.

Disciple_Tools_Twilio_API::send_whatsapp( $phone_number, $message );

Send a message to a D.T User

$bool_result = dt_twilio_direct_send( 12, 'wp_user', $msg, [ 'service' => 'sms' ] );

Send a message to a D.T Contact

$bool_result = dt_twilio_direct_send( 343, 'post', $msg, [ 'service' => 'sms' ] );

• id: Assigned WP user id or post id, depending on type value.
• type: System type; which must be one of the following:
  • wp_user
  • post
• msg: Actual message to be sent; which must adhere to the pre-defined Twilio message template shape. For example:

  Hi, Please update records -> {{link}} -> Link will expire on {{time}}

  • {{...}} placeholders to be substituted with actual values.
• args: Ability to specify option overrides during sending. Currently, the following overrides are supported:
  • service: Specify which of the following twilio service types are to be adopted:
    • sms
    • whatsapp

Webhooks

Set twilio to call this webhook

POST https://your-site.com/wp-json/dt-public/twilio/v1/webhook

A dt_twilio_message_received action will be triggered when a message is received by Twilio.

/**
 * $type: 'sms' or 'whatsapp'
 * $params: array of the message
 * $params['Body']: the message
 * $params['From']: the phone number
 * See all params here: https://www.twilio.com/docs/messaging/guides/webhook-request
 */
add_action( 'dt_twilio_message_received', function ( $type, $params ){
    //do stuff here
}, 10, 2 );

Contribution

Contributions welcome. You can report issues and bugs in the Issues section of the repo. You can present ideas in the Discussions section of the repo. And code contributions are welcome using the Pull Request system for git. For a more details on contribution see the contribution guidelines.