Skip to content

Home

Jump to bottom Edit New page
Daniel Hazelbaker edited this page Mar 8, 2015 · 1 revision

About this project

Samples

This project aims to provide integration between Arena and Twilio SMS.

Installation

Download the latest release from the Files section and extract the contents of the zipfile. There will be a bin folder inside with the following 4 DLL files, which will need to be placed in the Arena\bin folder as well as the Arena Automation Agents folder:

  • Arena.Custom.HDC.Twilio.dll
  • Twilio.Api.dll
  • Newtonsoft.Json.dll
  • RestSharp.dll

(For 2012.2+ users, the DLL files are available separately at this URL: http://redmine.refreshcache.com/projects/hdctwilio/files)

Next is a folder in the zipfile called UserControls which contains the following files and will need to be placed in *~ folder:

Create a new module entry for the SmsCommunicationInjection.ascx module.

There is also a SQL script that needs to be run, version_x_y.sql which will create the required tables, stored procedures and create an (inactive) record for the new SMS provider. After running the script there are a few other things that will need to be setup before you are ready to run.

There are two organization settings that need to be set (and possibly created if they do not exist already):

  • SMSProvider_UserName - The account SID of your Twilio account, probably starts with AC.
  • SMSProvider_Password - This is the Auth Token of your Twilio account.

There is also a new lookup type called “Twilio Numbers” which will need entries added for each twilio number you want to be available for use in Arena. Each phone number should be entered with these bits of information:

  • Value - User friendly name to identify the twilio number.
  • Phone Number - The twilio phone number, e.g. 1-760-555-5555
  • Forward E-mail - Optional: The e-mail address that will have incoming SMS messages forwarded to it.
  • Autoresponse - Optional: If this is filled in then incoming SMS messages will automatically get a response with this text.

Edit your Arena\web.config file and make sure the ApplicationURLPath setting is correct (i.e. it needs to point to your Arena’s publicly accessible URL, e.g. http://www.yourchurch.org/Arena/). Also edit your Arena Automation Agents/AgentService.exe.config and do the same change there.

Finally edit the SMS Provider lookup and activate the Twilio provider as well as de-activate any other SMS providers.

Add the SmsCommunicationInjection module to the staff SMS page and select the Twilio Phone numbers you want to be available to be used by staff.

Refresh Cache and go!

Twilio Setup

On Twilio, for each phone number you have configured you need to setup the SMS Request URL to point to your server. This allows incoming texts to be processed correctly. Each number should point to the SmsStatus.aspx page on your server, for example: http://www.yourchurch.org/Arena/UserControls/Custom/HDC/Twilio/SmsStatus.aspx

I also recommend making the Voice URL blank, as that will prevent you from being charged ($0.01 per minute) for incoming calls, for example if people try to call the number back.

Add a custom footer
Add a custom sidebar
Clone this wiki locally