SMS Twilio

From Open-Xchange
Revision as of 16:23, 20 October 2017 by Jesse.hanna (talk | contribs) (→‎Configuration)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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

Open the following file in editor:

$ /opt/open-xchange/etc/twilio.properties


Apply the following config-cascade enabled properties:

# Twilio auth key)
com.openexchange.plugins.sms.twilio.authkey=ACCOUNT_SID 

#Twilio auth token
com.openexchange.plugins.sms.twilio.authtoken=AUTH_TOKEN

#Twilio Message Service SID
com.openexchange.plugins.sms.twilio.messageservicesid=SERVICE_SID

#1600 characters is Twilio's maximum
com.openexchange.plugins.sms.twilio.maxlength=1600

Twilio Documentation

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