SMS Twilio

From Open-Xchange
Revision as of 16:20, 20 October 2017 by Jesse.hanna (talk | contribs)

Send SMS messages via Twilio

Requirements

  • An active Twilio account (https://www.twilio.com/)
  • A suitable number of pre-provisioned Twilio long-codes and/or short-codes

Available packages

To send SMS messages via Twilio, the package open-xchange-sms-twilio must be installed and configured. Additionally, the open-xchange-sms-sipgate package must *NOT* be installed.

Install on OX {{#if:App Suite|App Suite| AppSuite}}

Debian GNU/Linux 10.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://{{#if:LDBACCOUNT:LDBPASSWD%7CLDBACCOUNT:LDBPASSWD@%7C}}software.open-xchange.com/{{#if:components%7Ccomponents%7Cproducts}}/plugins/stable/1.3.1/DebianBuster/ /{{#if:LDBACCOUNT:LDBPASSWD||

# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/{{#if:components|components|products}}/plugins/stable/1.3.1/updates/DebianBuster/ /

}}

and run

$ apt-get update
$ apt-get install open-xchange-sms-twilio

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://{{#if:LDBACCOUNT:LDBPASSWD%7CLDBACCOUNT:LDBPASSWD@%7C}}software.open-xchange.com/{{#if:components%7Ccomponents%7Cproducts}}/plugins/stable/1.3.1/DebianBullseye/ /{{#if:LDBACCOUNT:LDBPASSWD||

# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/{{#if:components|components|products}}/plugins/stable/1.3.1/updates/DebianBullseye/ /

}}

and run

$ apt-get update
$ apt-get install open-xchange-sms-twilio


Configuration

Apply the following config-cascade enabled properties:

com.openexchange.plugins.sms.twilio.authkey=ACCOUNT_SID - (Twilio auth key) com.openexchange.plugins.sms.twilio.authtoken=AUTH_TOKEN - (Twilio auth token) com.openexchange.plugins.sms.twilio.messageservicesid=SERVICE_SID - (Twilio Message Service SID) com.openexchange.plugins.sms.twilio.maxlength=1600 - (1600 characters is Twilio's maximum)

Twilio Documentation

https://www.twilio.com/docs/