WorqHat
Utility

Send SMS Using Plivo

Category
Communication
Node Type
Utility

Overview

The Send SMS using Plivo node allows you to send SMS messages directly through your workflow using Plivo. It is ideal for sending notifications, verification codes, or real-time alerts to users via text message.

Description

Send text messages via Plivo.

This node integrates with Plivo’s SMS delivery service to send outbound messages.

OTP & Verification

Send secure login codes or 2FA tokens.

Alerts & Updates

Notify users about order status or appointments.

Prerequisites:

  • Active Plivo account.
  • Connected Plivo integration in WorqHat.
  • Registered Sender IDs (DLT registration may be required).

Input Parameters

Configure the SMS details.

senderIdstringRequired
Registered Sender ID (max 6 chars).
Example
"WORQHT"
phoneNumberstringRequired
Recipient number in international format.
Example
"+919876543210"
messagestringRequired
SMS content (max 160 chars recommended).
Example
"Your OTP is 123456."

Output Parameters

The node returns delivery details.

deliveryIdstringOptional
Provider ID for the message.
deliveryStatusstringOptional
'sent', 'queued', or 'failed'.
deliveryTimestringOptional
ISO timestamp of sending.

Output Type

Output Type: Text / JSON

Returns a text-based response containing metadata and status.

Example Usage

Example 1: Send OTP

Send a verification code.

{  "senderId": "WORQHT",  "phoneNumber": "+919876543210",  "message": "Your code is 524916."}
{  "deliveryId": "msg-1fbc20b7d9134d",  "deliveryStatus": "sent",  "deliveryTime": "2025-10-29T18:35:45Z"}

How to Use in a No-Code Workflow

1

Add the Node

Add the Send SMS using Plivo node to your workflow.

2

Set Sender ID

Enter your verified Sender ID.

3

Set Recipient

Enter the Phone Number (with country code).

4

Compose Message

Type the Message text or map it from a previous node.

Best Practices

  • Ensure your Plivo integration is active.
  • Keep messages concise (under 160 chars) to avoid segmentation charges.

Do / Don’t

Do
  • ✔️ Use international format for phone numbers (+1...).
  • ✔️ Log deliveryId to track message status.
Don’t
  • ❌ Don’t use unregistered Sender IDs (messages may fail).
  • ❌ Don’t send marketing messages without user consent.

Common Errors

Missing sender IDErrorOptional
Sender ID field is empty.
Invalid phone numberErrorOptional
Number missing country code.
Integration not enabledErrorOptional
Enable Plivo in Integrations page.

Example Workflow Integration

Use Case: OTP Verification

Send a one-time password for login.

  1. User Login: User requests login code.
  2. Generate OTP: Create a random 6-digit code.
  3. Send SMS (Plivo): Send the code to user's phone.

Workflow Data Flow:

{{user.phone}} → {{plivo.phoneNumber}}
{{otp.code}} → {{plivo.message}}