Methods
Objects
Mobile Originated (MO)
Receive replies or inbound messages on reserved keywords and/or shortcodes.
Summary
require 'vendor/autoload.php'; // Composer $api = new \CALLR\API\Client; $api->setAuth(new \CALLR\API\Authentication\LoginPasswordAuth('login', 'password'));
var callr = require('callr'); var api = new callr.api(callr.loginPasswordAuth('login', 'password'));
require 'callr' api = CALLR::Api.new('login', 'password')
import callr api = callr.Api("login", "password")
$type = 'sms.mo'; $endpoint = 'http://yourdomain.com/webhook_path'; $options = null; $result = $api->call('webhooks.subscribe', [ $type, $endpoint, $options ]);
var type = 'sms.mo'; var endpoint = 'http://yourdomain.com/webhook_path'; var options = null; api.call('webhooks.subscribe', type, endpoint, options).success(function(response) { // success callback });
type = 'sms.mo' endpoint = 'http://yourdomain.com/webhook_path' options = nil result = api.call('webhooks.subscribe', type, endpoint, options)
type = 'sms.mo' endpoint = 'http://yourdomain.com/webhook_path' options = None result = api.call('webhooks.subscribe', type, endpoint, options)
Returns a Webhook object.
You're all set! MO and replies will be sent to this Webhook.
An example of the data pushed is available on the Webhooks page.
To receive replies, you can use Webhooks. You can subscribe globally to the webhook sms.mo (see above). You can also use a "dynamic" webhook like below. MO will be sent to both the global Webhook and the dynamic Webhook. DLR of this MT will also be sent to this specific Webhook.
When using a dynamic Webhook, you only need to set endpoint and optionally options.
Do not set a sender if you want to receive replies - we will automatically use an SMS number.
$options = new stdClass; $options->webhook = new stdClass; $options->webhook->endpoint = 'http://yourdomain.com/webhook_path'; $result = $api->call('sms.send', ['', '+33612345678', 'Hello, SMS world!', $options]);
var optionSMS = { webhook: { endpoint: 'http://yourdomain.com/webhook_path' } }; api.call('sms.send', '', '+33612345678', 'Hello world!', optionSMS).success(function(response) { // success callback });
optionSMS = { :webhook => { :endpoint => 'http://yourdomain.com/webhook_path', } } result = api.call('sms.send', '', '+33612345678', 'Hello world!', optionSMS)
optionSMS = { 'webhook': { 'endpoint': 'http://yourdomain.com/webhook_path', } } result = api.call('sms.send', '', '+447890123456', 'Hello world!', optionSMS)