IVRAPI SMS Bot icon

IVRAPI SMS Bot

Initiate an SMS conversation via IVRAPI using a Bot’s virtual phone number.
Join our community

Overview

This node enables sending SMS messages via the IVRAPI service using a Bot's virtual phone number. It is designed for initiating SMS conversations where the sender is represented by a predefined Bot, identified by its name or virtual number (DDI). The node is particularly useful for automating SMS notifications, alerts, or customer communications within Poland, as the service supports only Polish phone numbers.

Practical examples:

  • Sending appointment reminders to clients using a specific Bot's virtual number.
  • Automating marketing SMS campaigns with different Bots representing various departments.
  • Notifying users about system status or alerts through SMS sent from a Bot.

Properties

Name Meaning
Bot name and Virtual Number Select a Bot from the list (displayed as "Name — Virtual Number") or specify it via an expression. You can provide either the Bot's name or its virtual phone number (DDI). The node verifies and resolves this automatically.
Message The text content of the SMS message to send. This is a required multiline string input.
Recipient phone number The recipient's phone number in Poland, consisting of exactly 9 digits. Numbers cannot start with 30, 40, 70, or 80. This restriction ensures valid Polish mobile numbers are used.

Output

The node outputs an array of JSON objects, each corresponding to one SMS sent. Each output item contains the full response from the IVRAPI SMS sending endpoint, which includes details about the sent message such as status, message ID, timestamps, or error information if applicable.

The node does not output binary data.

Dependencies

  • Requires an API key credential for the IVRAPI service to authenticate requests.
  • Makes HTTP requests to the IVRAPI endpoints:
    • To fetch available Bots (GET https://api.ivrapi.com/api/bots)
    • To send SMS messages (POST https://api.ivrapi.com/api/smses)
  • The node depends on n8n's HTTP request helper and credential management.

Troubleshooting

  • Invalid phone number errors:
    If the recipient or Bot phone number does not match the required 9-digit format or starts with disallowed prefixes (30, 40, 70, 80), the node will throw an error specifying the invalid value. Ensure phone numbers conform to these rules.

  • Bot not found or invalid Bot phone number:
    When specifying the Bot by name or number, if the Bot does not exist or the number is not assigned to any Bot on the account, an error will be thrown. Verify that the Bot exists in your IVRAPI account and that you have selected or entered it correctly.

  • Empty message error:
    The node requires a non-empty message string. If the message is empty or whitespace, an error will occur.

  • API key missing or invalid:
    If the API key credential is missing or incorrect, the node will fail when attempting to load Bots or send SMS messages. Make sure the API key is set up properly in n8n credentials.

  • HTTP request failures:
    Network issues or API downtime may cause HTTP request errors. The node surfaces these errors with messages indicating failure to load Bots or send SMS. Check network connectivity and IVRAPI service status.

Links and References

Discussion