Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.nlpearl.ai/llms.txt

Use this file to discover all available pages before exploring further.

Send Email action interface on light mode
Send Email action interface on dark mode
NLPearl.AI enables your AI agent to send SMS messages during a live conversation. This feature allows for real-time communication, ensuring that your customers receive important information instantly.

​
Configuring the “Send SMS” Action

To activate and configure the “Send SMS” action within a Pearl, follow these steps:
1

Navigate to the Call Action Section

While creating or editing a Pearl, go to the “Call Action” section.
2

Click on SMS

Select the “SMS” option to activate this functionality for your Pearl.

​
Fields to Configure

1

SMS Content

Compose Your Message: Write the SMS content that you want to be sent out. You can include links, important details, or any relevant information. Additionally, you can use variables within the SMS to personalize the message for each recipient. For example, “Hi firstName, your reservation at restaurantName is confirmed.”
2

When to Trigger

Trigger Condition: Describe when you want the SMS to be sent. This could be immediately after a specific event occurs during the conversation. For example, "Send the SMS immediately after the table reservation is confirmed and processed."

​
Example Use Cases

Here are some scenarios where the “Send SMS” action can be effectively used:
​
Reservation Confirmations
After confirming a reservation, Pearl can automatically send an SMS to the customer with the details.
​
Appointment Reminders
Pearl can send a reminder SMS to the customer about an upcoming appointment or event.

​
Regulatory Compliance

To ensure compliance with regulations, Pearl will always ask the third-party customer for their consent before sending an SMS. This step is crucial in respecting the customer’s preferences and adhering to communication laws.

​
SMS Credit Cost

Sending an SMS consumes credits from your account balance. The cost depends on two factors:
  • Recipient country : Each destination country has its own rate per segment. International messages cost more than domestic ones.
  • Number of segments : A single SMS is limited in character length. Longer messages are automatically split into multiple segments, each billed individually.
A standard SMS segment contains up to 160 characters (GSM-7 encoding). If your message uses special characters or emojis, the encoding switches to UCS-2, reducing the limit to 70 characters per segment. Messages exceeding one segment are concatenated, with each segment charged separately.
EncodingSingle SMS limitConcatenated segment limit
GSM-7 (standard)160 characters153 characters per segment
UCS-2 (unicode/emojis)70 characters67 characters per segment
When a message exceeds the single SMS limit, a few characters per segment are reserved for concatenation headers, reducing the usable space per segment.
If your SMS contains variables (e.g. firstName, appointmentDate), the actual total cost may vary. The final number of characters, and therefore segments, depends on the length of each variable’s value at the time the message is sent. A short variable like “Tom” uses fewer characters than “Christopher”, which could push your message into an additional segment.

​
SMS Credit Calculator

Use this calculator to estimate how many segments your message will use and the total credit cost based on the destination country.

Variables

Learn how to use variables to personalize your SMS content.