SMS Twilio: Difference between revisions

From Open-Xchange
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Send SMS messages via Twilio'''
= Send SMS messages via Twilio =


'''Requirements'''
== Requirements ==


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


== Available packages ==
To send SMS messages via Twilio, the package open-xchange-sms-twilio must be installed and configured.
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.  
Additionally, the  open-xchange-sms-sipgate package must *NOT* be installed.  


{{InstallPlugin|pluginname=open-xchange-sms-twilio|toplevel=components|sopath=plugins/stable/1.3.1|version=App Suite|ldbaccount=LDBACCOUNT:LDBPASSWD|reponame=plugins}}
== Configuration ==


*''Debian GNU/Linux'' - Run: $ apt-get install open-xchange-sms-twilio
Open the following file in editor:
<pre>
$ /opt/open-xchange/etc/twilio.properties
</pre>


*''Red Hat Enterprise Linux'' - Run: $ yum install open-xchange-sms-twilio


*''SUSE Linux Enterprise Server'' - Run: $ zypper in open-xchange-sms-twilio
Apply the following config-cascade enabled properties:
<pre>
# Twilio auth key)
com.openexchange.plugins.sms.twilio.authkey=ACCOUNT_SID


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


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


Apply the following config-cascade enabled properties:
#1600 characters is Twilio's maximum
com.openexchange.plugins.sms.twilio.maxlength=1600
</pre>


*com.openexchange.plugins.sms.twilio.authkey=ACCOUNT_SID - (Twilio auth key)
== Twilio Documentation ==
*com.openexchange.plugins.sms.twilio.authtoken=AUTH_TOKEN - (Twilio auth token)
https://www.twilio.com/docs/
*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)

Latest revision as of 16:23, 20 October 2017

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/