Send SMS using Clickatell
Table of Contents
Note:
- This task is applicable only to Zoho Creator.
- This task can be used only by users who created their Clickatell account before November, 2016. We recommend the users who signed up after November, 2016 to make use of the invokeUrl task to call the respective Clickatell API.
- Each time the clickatell.sms.sendtext integration task is executed, it triggers an API request in the back-end. This call is deducted from the external calls limit available for the service from which the task is executed, based on your pricing plan.
- Only actual executions that receive a response (whether success or failure) are counted, not the number of times the task appears in the script. For example, if clickatell.sms.sendtext integration task is placed inside a for each task that iterates five times, the number of external calls consumed will be five, even though the task appears only once in the script.
Overview
The clickatell.sms.sendtext task is used to send messages through your Clickatell account using Deluge. For example, imagine you have a Zoho Creator application to track your inventory. You can use this task to send SMS notification to the specified phone number through your Clickatell account, whenever your inventory runs low on stock.
Syntax
<variable> = clickatell.sms.send(<clickatell_connection>, <to_number>, <message>);
where:
| Params | Data type | Description |
| <variable> | KEY-VALUE | is the variable which will hold the response returned by Clickatell. |
| <clickatell_connection> | TEXT | is the name of the Clickatell connection. |
| <to_number> | TEXT | is the phone number to which the message must be sent. The phone number must be in the format: +<country_code><phone_number> |
| <message> | TEXT | Contents of the message |
Send an SMS using Clickatell
The following snippet sends the specified message to the specified number.
response = clickatell.sms.send("Clickatell", "+91XXXXXXXXXX", "Thank
you for subscribing");
where:
| Parameter | Description |
| "Clickatell" | is the name of the Clickatell Connection |
| "+91XXXXXXXXXX" | is the phone number to which the message will be sent |
| "Thank you for subscribing" | is the message which will be sent |
| response | is response returned as KEY-VALUE by Clickatell |
Response Format
Following is a sample success response returned by Clickatell:
{"status":"Success"}