IPPanel SMS

Send SMS messages via IPPanel,This node support iranian phone numbers and operators only
Join our community

Actions2

Overview

This node enables sending SMS messages through the IPPanel service, specifically supporting Iranian phone numbers and operators. The "Send Pattern" operation allows users to send templated SMS messages using predefined pattern codes configured in their IPPanel account. This is useful for sending standardized notifications, alerts, or transactional messages where the content follows a fixed template with dynamic parameters.

Typical use cases include:

  • Sending verification codes or OTPs using a predefined message template.
  • Dispatching appointment reminders or alerts with personalized details.
  • Automating customer notifications with consistent formatting.

For example, you can send a pattern message like "Your verification code is {{code}}" by specifying the pattern code and passing the actual code as a parameter.

Properties

Name Meaning
Sender Number The phone number from which the message will be sent (e.g., "+983000505").
Pattern Code The identifier of the message template defined in your IPPanel account. Can be static or dynamic.
Use Pattern From Field Whether to get the pattern code dynamically from an input field instead of entering it directly.
Pattern Code Field The name of the input field containing the pattern code when "Use Pattern From Field" is enabled.
Recipient The recipient's phone number who will receive the pattern message (e.g., "+989123456789").
Pattern Parameters JSON object containing key-value pairs to fill the placeholders in the pattern template.

Output

The node outputs an array of JSON objects, each corresponding to an input item processed. Each output JSON contains:

  • success: Boolean indicating if the message was sent successfully.
  • response: The raw response data returned by the IPPanel API after sending the message.
  • patternCode: The pattern code used for the message (only for the "Send Pattern" operation).

If sending fails and "Continue On Fail" is enabled, the output JSON will contain:

  • success: false
  • error: Error message describing the failure.

The node does not output binary data.

Dependencies

  • Requires an active IPPanel account with valid API credentials (an API key).
  • The node expects the API key credential to be configured in n8n.
  • Internet access to call the IPPanel REST API at https://edge.ippanel.com/v1/api.

Troubleshooting

  • Missing API Key: If the API key credential is not set or invalid, the node throws an error "IPPanel API key is required!" Ensure the API key is correctly configured in n8n credentials.
  • Invalid Pattern Parameters: If the JSON string provided for pattern parameters is malformed, the node throws "Pattern parameters must be a valid JSON object!". Validate the JSON syntax before running.
  • Missing Pattern Code Field: When using dynamic pattern codes from input fields, if the specified field is missing or empty, the node throws "No pattern code found in field ...". Verify the input data contains the correct field.
  • API Errors: Errors returned by the IPPanel API are surfaced with messages like "API Error: [status] - [details]". Check the API key permissions, pattern code validity, sender and recipient numbers format.
  • Phone Number Format: Ensure all phone numbers (sender and recipient) are in the correct international format starting with "+" followed by country code.

Links and References

Discussion