Overview
This node allows users to send SMS messages via the RingCentral platform. It is designed for scenarios where automated or bulk SMS sending is needed, such as customer notifications, alerts, marketing campaigns, or two-factor authentication messages. The node authenticates using a JWT token and sends SMS from one of the user's authorized phone numbers to a specified recipient number.
Practical examples:
- Sending appointment reminders to clients.
- Notifying customers about order status updates.
- Broadcasting promotional messages to a list of subscribers.
Properties
| Name | Meaning |
|---|---|
| From Number | The phone number to send the SMS from. Must be one of the account's authorized phone numbers. |
| To Number | The recipient's phone number including country code (e.g., +14155552671). |
| Message | The text content of the SMS message (up to 1000 characters). |
| Country Code | Two-letter ISO 3166-1 alpha-2 country code representing the sender's country (default: "US"). |
Output
The node outputs an array of items corresponding to each input item processed. Each output item's json field contains the response from the RingCentral API after sending the SMS. This includes details such as message status, message ID, and other metadata returned by the API.
No binary data is output by this node.
Dependencies
- Requires an active RingCentral account with SMS capabilities.
- Needs an API key credential containing client ID, client secret, server URL, and a valid JWT token for authentication.
- The node uses the official RingCentral SDK to interact with the RingCentral REST API.
Troubleshooting
- Authentication failures: If the node fails to authenticate, ensure the JWT token and API credentials are valid and have not expired.
- Invalid 'From Number': The "From Number" must be one of the phone numbers available in the RingCentral account. If the number is not listed, the node will throw an error listing available numbers.
- Missing required parameters: The node requires "From Number", "To Number", and "Message" fields to be non-empty. Omitting any will cause an error.
- Phone number formatting: Both "From Number" and "To Number" should include the country code prefixed with "+". The node attempts to add "+" if missing but ensure correct formatting to avoid issues.
- API errors: Any errors returned by the RingCentral API during SMS sending will be logged and can cause the node to fail unless "Continue On Fail" is enabled.