Overview
This node integrates with the NetGSM service to send SMS messages or voice messages (via text-to-speech) to one or multiple recipients. It is useful for automating communication workflows such as marketing campaigns, notifications, alerts, or customer engagement where sending bulk or individual SMS/voice messages is required.
For the Send SMS operation, users can specify the message content, sender name, recipient phone numbers, and character encoding. The node sends the SMS via NetGSM’s API and returns detailed results per recipient.
Practical examples:
- Sending appointment reminders to a list of clients.
- Broadcasting promotional SMS messages to customers.
- Sending alerts or verification codes via SMS.
- Delivering automated voice messages using TTS (in the other operation).
Properties
| Name | Meaning |
|---|---|
| Message | The content of the SMS message to be sent. |
| Encoding | Character encoding of the message. Options: "Turkish (TR)" or "English (EN)". |
| Message Sender (Originator) | The sender name or header that appears as the message originator on recipients' devices. |
| Phone Numbers | Recipient phone numbers without country code prefix (e.g., without "90"). Multiple numbers can be entered separated by new lines or commas. |
| Options → Continue On Failure | If enabled, the node will not throw an error when sending fails but instead return failure details per recipient. |
Output
The node outputs an array of JSON objects, each representing the result of sending a message to a single phone number. Each object contains:
success: Boolean indicating if the message was sent successfully.jobId(if successful): A string identifier returned by NetGSM for the batch/message job.message: Status message describing the outcome.phoneNumber: The recipient's phone number.sentMessage: The original SMS message content sent.method: The method used, here always"sms".index: The position of this recipient in the batch (1-based).totalCount: Total number of recipients in the batch.batchRequest: Always true, indicating this is part of a batch operation.error(if failed): Error message describing why sending failed.response(optional): Raw response from the API if available.
If binary data were involved (not in this operation), it would be summarized accordingly, but this node only handles JSON output for SMS sending.
Dependencies
- Requires an API key credential for authenticating with the NetGSM service.
- Makes HTTP POST requests to NetGSM’s XML-based REST API endpoints.
- Needs network access to
https://api.netgsm.com.tr/sms/send/xml. - No additional environment variables are required beyond the API credentials.
Troubleshooting
- No valid phone numbers provided: The node throws an error if no valid recipient numbers are detected after parsing input. Ensure phone numbers are entered correctly without country code prefixes and separated properly.
- API errors with codes other than 00, 01, 02: These indicate failures returned by NetGSM. The error code and full response are included in the output or error message. Check the API documentation or your account status.
- Authentication failures: If credentials are incorrect or missing, the API call will fail. Verify the API key and password are correct.
- Continue On Failure option: If disabled, any failure during sending causes the node to throw an error and stop execution. Enable this option to receive partial success/failure results without stopping the workflow.
- Network issues: Timeouts or connectivity problems will cause errors. Ensure stable internet connection and that the NetGSM endpoint is reachable.
Links and References
- NetGSM Official Website
- NetGSM SMS API Documentation
- n8n Documentation on Creating Custom Nodes