Nvoip icon

Nvoip

Node for sending SMS via Nvoip

Actions6

Overview

This node enables sending SMS messages via the Nvoip service, specifically supporting sending SMS using predefined templates. It is useful for automating communication workflows where standardized message formats are required, such as transactional alerts, marketing campaigns, or customer notifications.

In the "Send SMS (Template)" operation, users can select a predefined SMS template and provide variables to fill in placeholders within that template. This ensures consistent messaging while allowing dynamic content insertion.

Practical example:
A business wants to send appointment reminders using a standard SMS template like "Hello {{1}}, your appointment is on {{2}}." The node allows selecting this template and providing the recipient's phone number along with the variable values (e.g., customer name and appointment date) to personalize each message automatically.

Properties

Name Meaning
Destination Number Phone number of the SMS recipient including country code (e.g., 5511999999999).
Template Name or ID Select a predefined SMS template from a list or specify its ID using an expression.
Template Variables List of values to replace placeholders in the selected SMS template, provided in correct order.

Output

The node outputs JSON data representing the response from the Nvoip API after attempting to send the SMS template message. This typically includes status information about the sent message, such as success confirmation or error details.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "status": "success",
  "messageId": "abc123",
  "details": { ... }
}

Dependencies

  • Requires an API authentication token configured in n8n credentials to access the Nvoip API.
  • The node makes HTTP requests to Nvoip endpoints:
    • To fetch available SMS templates: GET https://api.nvoip.com.br/v3/sms/lisTemplates
    • To send SMS using a template: POST https://api.nvoip.com.br/v3/sms/sendTemplate

Ensure the API key has permissions to list templates and send SMS messages.

Troubleshooting

  • Error: "Attempt to send an SMS with template ID X, but no variable was provided"
    This occurs if you select a template requiring variables but do not supply any. Fix by adding the necessary template variables in the correct order.

  • Error: Unsupported operation
    Indicates the node was configured with a resource-operation combination not implemented. Verify you have selected "SMS" as resource and "Send SMS (Template)" as operation.

  • API request failures
    Could be due to invalid API credentials, network issues, or incorrect phone numbers. Check credentials, ensure phone numbers include country codes, and verify network connectivity.

Links and References

Discussion