Creator Help

Send SMS using Deluge functions

Overview

Zoho Creator provides Deluge functions that can be used to send SMS dynamically as part of an automation script.  These functions can be invoked when new form data is submitted or when existing form data is modified or deleted or by invoking custom action from reports. SMS can be sent using the default connection provided by Zoho Creator or through any of the supported SMS Providers with whom you have an account. The supported SMS Providers are listed below. Once you choose to send SMS using these service providers, they get listed in the Account Setup - Connections page.

  • Twilio
  • Clickatell
  • Screen Magic
  • ClockWorkSMS
  • Hoiio 

To configure and send SMS Notifications from the GUI, refer the help topic Send SMS from Creator application, in User Guide.

Syntax

a. To send SMS using default connection
<SMS Response> = zoho.sms.send("<to>","<message>");

where,
<SMS Response> is the map variable returned by the send function, as response. If the SMS is sent successfully it gets logged with the message {"status":"success"}. Otherwise it gets logged as {"message":"<Reason for failure>","status":"failure"}

<to> the mobile number to whom the SMS must be sent. The mobile number has to start with country code without the + sign. For example, 91xxxxxxxxxx,  where "91" is the country code of India.

<message> the sms text message.

b. To send SMS using Twilio
<SMS Response> = twilio.sms.send("<sms notification name>","<to>","<message>");

where,
<SMS Response> is the map variable returned by the send function, as response. If the SMS is sent successfully it gets logged with the message {"status":"success"}. Otherwise it gets logged as {"message":"<Reason for failure>","status":"failure"}

<sms notification name> is the deluge name of the sms notifications as listed in the Account setup -> Connections page.

<to> the mobile number to whom the SMS must be sent, in the format supported by Twilio.

<message> the sms text message.

c. To send SMS using Clickatell
<SMS Response> = clickatell.sms.send("<sms notification name>","<to>","<message>");

where,
<SMS Response> is the map variable returned by the send function, as response. If the SMS is sent successfully it gets logged with the message {"status":"success"}. Otherwise it gets logged as {"message":"<Reason for failure>","status":"failure"}

<sms notification name> is the deluge name of the sms notifications as listed in the Account setup -> Connections page.

<to> the mobile number to whom the SMS must be sent, in the format supported by Clickatell.

<message> the sms text message.

d. To send SMS using Screen Magic
<SMS Response> = screenmagic.sms.send("<sms notification name>","<to>","<message>");

where,
<SMS Response> is the map variable returned by the send function, as response. If the SMS is sent successfully it gets logged with the message {"status":"success"}. Otherwise it gets logged as {"message":"<Reason for failure>","status":"failure"}

<sms notification name> is the deluge name of the sms notifications as listed in the Account setup -> Connections page.

<to> the mobile number to whom the SMS must be sent, in the format supported by Screen Magic

<message> the sms text message.

e. To send SMS using ClockWorkSMS
<SMS Response> = clockworksms.sms.send("<sms notification name>","<to>","<message>");

where,
<SMS Response> is the map variable returned by the send function, as response. If the SMS is sent successfully it gets logged with the message {"status":"success"}. Otherwise it gets logged as {"message":"<Reason for failure>","status":"failure"}.

<sms notification name> is the deluge name of the sms notifications as listed in the Account setup -> Connections page.

<to> the mobile number to whom the SMS must be sent, in the format supported by ClockWorkSMS.

<message> the sms text message.

f. To send SMS using Hoiio
<SMS Response> = hoiio.sms.send("<sms notification name>","<to>","<message>");

where,
<SMS Response> is the map variable returned by the send function, as response. If the SMS is sent successfully it gets logged with the message {"status":"success"}. Otherwise it gets logged as {"message":"<Reason for failure>","status":"failure"}

<sms notification name> is the deluge name of the sms notifications as listed in the Account setup -> Connections page.

<to> the mobile number to whom the SMS must be sent, in the format supported by Hoiio

<message> the sms text message.

Top