bdacode/fuel-twilio

Twilio is a package to allow interaction with the Twilio service.

Twilio

Twilio is a package to allow interaction with the Twilio service.

Installation

1. Clone (git clone git://github.com/maca134/fuelphp-twilio) / download
2. Copy to fuel/packages/
3. Copy fuel/packages/twilio/config/twilio.php to fuel/app/config/
4. Add your Twilio credentials and defaults for each twiml element.

Introduction

Rest API

This package will allow you to send requests to Twilio:

• Accounts
• MakeCall
• Recordings
• SmsMessage
• Transcriptions

TwiML: Twilio Markup Language

It also includes an object based implementation of Twilio's TwiML.

Here are the TwiML elements:

• Say
• Play
• Gather
  • Say
  • Play
  • Pause
• Record
• Sms
• Dial
  • Number
  • Client
  • Conference
• Hangup
• Redirect
• Reject
• Pause

Configuration

Copy config/twilio.php to app/config/twilio.php and change whatever setting in need of changing.

Rest API Examples

Make a call

$call = Twilio\Twilio::request('MakeCall');
$response = $call->create(array(
	'To' => '[phone]',
	'From' => '[phone]',
	'Url' => Uri::create('welcome/call')
));

Send an SMS message

$sms = Twilio\Twilio::request('SmsMessage');
$response = $sms->create(array(
	'To' => '[phone]',
	'From' => '[phone]',
	'Body' => 'SMS content'
));

TwiML Examples

Simple Example

$twiml = Twilio\Twilio::twiml();
$twiml->say('Hello World!')->pause('', array('length' => '5'));
$twiml->render();

Will render:

<?xml version="1.0" encoding="UTF-8" ?>
	<Response>
		<Say voice="man" language="en" loop="1">Hello World!</Say>
		<Pause length="5" />
	</Gather>
</Response>

Grabbing key presses during a call

$question = Twilio\Twilio::twiml();
$question->say('Please press 1 or 2')->pause()->play('http://some.place.com/music.mp3');

$twiml = Twilio\Twilio::twiml();
$twiml->pause()->gather($question, array(
	'action' => Uri::create('twilio/next_action'),
	'numDigits' => '1'
		)
);
$response = $twiml->render();

Sending an SMS message

$twiml = Twilio\Twilio::twiml();
$twiml->sms($message, array('from' => '[phone]'));

Notes

Only the TwiML elements Gather and Dial have nested objects.

Gather can have the following nested variables:

• Say
• Play
• Pause

Dial can have:

• A string, telephone number
• Number
• Client
• Conference

Get In Touch

You can get in touch either through GitHub or you can email me at [email protected].

Checkout my site at http://maca134.co.uk

Thanks

• Twilio
• TinyHttp