SMS Twilio

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 App Suite

Debian GNU/Linux 8.0

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

deb https://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/components/plugins/stable/1.3.1/DebianJessie/ /

and run

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

Debian GNU/Linux 9.0

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

deb https://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/components/plugins/stable/1.3.1/DebianStretch/ /

and run

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

SUSE Linux Enterprise Server 12

Add the package repository using zypper if not already present:

$ zypper ar https://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/components/plugins/stable/1.3.1/SLE_12 plugins


and run

$ zypper ref
$ zypper in open-xchange-sms-twilio

RedHat Enterprise Linux 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/plugins.repo

[plugins]
name=Open-Xchange
baseurl=https://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/components/plugins/stable/1.3.1/RHEL6/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-sms-twilio

RedHat Enterprise Linux 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/plugins.repo

[plugins]
name=Open-Xchange
baseurl=https://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/components/plugins/stable/1.3.1/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-sms-twilio

CentOS 6

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/plugins.repo

[plugins]
name=Open-Xchange
baseurl=https://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/components/plugins/stable/1.3.1/RHEL6/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum install open-xchange-sms-twilio

CentOS 7

Start a console and create a software repository file if not already present:

$ vim /etc/yum.repos.d/plugins.repo

[plugins]
name=Open-Xchange
baseurl=https://LDBACCOUNT:LDBPASSWD@software.open-xchange.com/components/plugins/stable/1.3.1/RHEL7/
gpgkey=https://software.open-xchange.com/oxbuildkey.pub
enabled=1
gpgcheck=1
metadata_expire=0m

and run

$ yum update
$ yum 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/