IVRAPI SMS Bot (BETA) icon

IVRAPI SMS Bot (BETA)

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 platform using a Bot’s virtual phone number. It is designed for initiating SMS conversations where the sender is represented by a bot configured in the IVRAPI system. This node is particularly useful for automating SMS notifications, alerts, or customer engagement messages within Poland.

Typical use cases include:

  • Sending transactional SMS messages from a predefined bot number.
  • Automating marketing or informational SMS campaigns.
  • Integrating SMS communication into workflows that require bot-based messaging.

Properties

Name Meaning
Bot name and Virtual Number Select a bot from the list (displayed as "Name — Virtual Number") or specify a value via an expression. The input can be either the bot's name or its virtual phone number (DDI). The node verifies and resolves it automatically.
Message The text content of the SMS message to send.
Recipient phone number The recipient’s Polish 9-digit phone number. Must not start with 30, 40, 70, or 80. This restriction ensures compliance with service limitations.

Output

The node outputs an array of JSON objects, each representing the response from the IVRAPI SMS sending endpoint for each message sent. Each output item contains the full JSON response returned by the API after attempting to send the SMS.

If the node sends multiple messages (one per input item), the output will contain one corresponding JSON object per message.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the IVRAPI service.
  • The node 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 user must configure the node with valid credentials containing the API key.
  • The service is limited to sending SMS messages within Poland only.

Troubleshooting

  • Invalid Recipient Number: If the recipient phone number does not match the required 9-digit format or starts with disallowed prefixes (30, 40, 70, 80), the node throws an error specifying the invalid number and the format requirements.
  • Empty Message: Attempting to send an empty or whitespace-only message results in an error indicating that the message cannot be empty.
  • Bot Not Found or Invalid Bot Number: If the specified bot name or virtual number is not found among the account’s bots, the node throws an error listing example bot names to help correct the input.
  • Missing API Key: If the API key credential is missing or invalid, the node will fail with an error indicating the absence of the required API key.
  • HTTP Request Failures: Network issues or API errors during fetching bots or sending SMS will result in errors with descriptive messages including the underlying HTTP error.

To resolve these issues:

  • Ensure all phone numbers conform to the specified format.
  • Verify the bot exists and is correctly selected or referenced.
  • Confirm the API key credential is properly set up and valid.
  • Check network connectivity and API availability.

Links and References

Discussion