Twilio Message Tool Plugin

Introduction

The Twilio Message Tool plugin seamlessly integrates with the powerful Twilio platform, empowering users to send WhatsApp messages and SMS effortlessly. Plugin configuration allows users to choose the service (Whatsapp, SMS), add media to messages, and send messages to a single recipient or multiple recipients.

Get started

Where to get the plugin

• You can download the Twilio Message Tool plugin from the JogetOSS Github Repository.

How to install

1. Click Download on this plugin screen (It will be a .jar file).
2. Go to your Joget localhost or server. In the Joget Console, go to Admin Bar > Systems Settings > Manage Plugins and click the Upload Plugins button.
3. Under Upload Plugin, select the plugin .jar file you downloaded and click Upload.
4. Depending on the plugin type, you can now view your new plugin in your form, List, or UI Builder.
5. Remember to uninstall the old plugin before uploading a new version.
6. The Joget Knowledge Base has more information on managing and developing plugins.

How to use it

Twilio setup process

Retrieving account SID, auth token and Twilio sender number (SMS)

1. Create a Twilio account or log in to Twilio Console.
2. Click on "Get a Twilio phone number" to get a Twilio sender number.
   
3. Save your Account SID, Auth Token, and Twilio phone aside; you will use them to configure the plugin later.
   

Setup Twilio SMS

1. Send a message using the app configured with the plugin.
   
2. Twilio will send you the message and configure the media URLs in SMS.
   

Setup Twilio WhatsApp

1. Under Messaging > Try it out > Send a WhatsApp message, you can retrieve the sandbox WhatsApp number to be used in the plugin later.
   
2. Send the code to the WhatsApp number provided to connect to the WhatsApp Sandbox.
   
3. Send a message using the app configured with the plugin.
   
4. Twilio will send you the message and configure the media URLs on WhatsApp.
   
5. To setup a WhatsApp Business Account, see Using WhatsApp Business Accounts with Twilio

Limitations

• Trial account only allows one verified number. (See How to Add and Remove a Verified Phone Number or Caller ID with Twilio)
  
• Trial account only allows Sandbox WhatsApp.
• You can only pass the Body parameter to the image (.jpg). See Message Resource.
  

Configure Twilio message tool properties

Fields to configure:

• Account SID: The Account SID is provided in your Twilio dashboard.
• Auth Token: The Auth Token is provided in your Twilio dashboard.
• Send As: Choose the messaging medium: SMS or WhatsApp.
• From Number: The Twilio sender number from your Twilio dashboard. Remember that SMS and WhatsApp use different sender numbers.
• To Number: The recipient's number. To send messages to multiple recipients, separate the numbers with a semicolon (;), e.g., +601234567;+6011111111.
• Message: The message to be sent from Twilio to the recipient.

Media URLs

Field to configure:

•  URLs: Public URLs for media (such as images). Private URLs are not supported.