Netgsm icon

Netgsm

NetGSM ile SMS ve sesli mesaj gönderme (tekli ve çoklu)

Actions2

Overview

This node integrates with the NetGSM service to send SMS and voice messages. Specifically, for the "Send Voice Message (Text)" operation, it converts provided text into a voice message using Text-to-Speech (TTS) technology and sends it to one or multiple phone numbers.

Common scenarios where this node is useful include:

  • Automated voice notifications or alerts sent to customers or users.
  • Reminders or announcements delivered via voice calls.
  • Situations where voice communication is preferred over SMS or email.

For example, a business could use this node to send appointment reminders as voice messages to clients, ensuring higher engagement than text messages.

Properties

Name Meaning
Message Sender (Originator) The sender name or message header that appears as the originator of the voice message.
Phone Numbers Recipient phone numbers without country code prefix (e.g., without '90'). Multiple numbers can be entered separated by new lines or commas.
Voice Message Text The text content that will be converted into a voice message using TTS and sent to recipients.
Options Collection of additional options:
- Continue On Failure: If enabled, the node returns results even if sending fails instead of throwing an error.

Output

The node outputs an array of JSON objects, each representing the result of sending the voice message to a single phone number. Each object contains:

  • success: Boolean indicating if the message was sent successfully.
  • jobId: A string identifier returned by the API for the batch request (present on success).
  • message: Success message describing the outcome.
  • phoneNumber: The recipient's phone number.
  • voiceText: The original text sent as a voice message.
  • method: Fixed string "voice_text_tts" indicating the method used.
  • index: The position of the current phone number in the batch (1-based).
  • totalCount: Total number of phone numbers in the batch.
  • batchRequest: Always true, indicating this was part of a batch operation.
  • error: Present only if sending failed, containing the error message.

No binary data output is produced by this operation.

Dependencies

  • Requires an active NetGSM account with valid API credentials (username and password).
  • The node uses HTTP POST requests with XML payloads to NetGSM's voice SMS API endpoint (https://api.netgsm.com.tr/voicesms/send).
  • Proper configuration of the API credentials within n8n is necessary for authentication.

Troubleshooting

  • No valid phone numbers: The node throws an error if no valid phone numbers are provided. Ensure numbers are entered without country code prefixes and separated correctly.
  • API errors: If the NetGSM API returns an error code (anything other than "00", "01", or "02"), the node either throws an error or returns failure results depending on the "Continue On Failure" option.
  • Network or credential issues: Failures in HTTP requests due to network problems or invalid credentials will cause errors. Verify API credentials and network connectivity.
  • Empty voice text: The "Voice Message Text" property is required; leaving it empty will cause an error.

To resolve errors:

  • Double-check phone number formatting.
  • Confirm API credentials are correct and active.
  • Enable "Continue On Failure" to receive partial results instead of stopping execution on errors.

Links and References

Discussion