Woztell Sender

Send messages through Woztell API

Overview

The Woztell Sender node allows you to send different types of messages through the Woztell API. It supports sending text messages as well as media files such as images, videos, audio, and generic files to specific members within a channel.

This node is useful in scenarios where you want to automate communication with users on messaging platforms supported by Woztell, for example:

  • Sending notifications or alerts to specific users.
  • Delivering multimedia content like promotional images or videos.
  • Automating customer support responses with text or media attachments.

Practical example: You could use this node to send a welcome message (text) to a new member joining a channel, or send an image file with a caption as part of a marketing campaign.

Properties

Name Meaning
Channel ID The unique identifier of the channel where the message will be sent.
Member ID The unique identifier of the member who will receive the message.
Response Type The type of message to send. Options: Audio, File, Image, Text, Video
Text Message The text content of the message (required if Response Type is Text).
Media URL The URL of the media file to send (required if Response Type is Audio, File, Image, Video).
Caption Optional text caption for media files (shown only when sending media).
API Endpoint The Woztell API endpoint URL used to send the message (default: https://bot.api.woztell.com/sendResponses).

Output

The node outputs an array of JSON objects, each representing the result of sending a message for each input item. Each output object contains:

  • success: Boolean indicating if the message was sent successfully.
  • channelId: The channel ID used for sending.
  • memberId: The member ID the message was sent to.
  • responseType: The type of response sent (Text, Image, etc.).
  • apiResponse: The raw response returned from the Woztell API.
  • sentData: The data payload that was sent to the API.

If an error occurs and the node is configured to continue on failure, the output will include:

  • success: false
  • error: The error message describing what went wrong.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Woztell API (referred generically as "an API key credential").
  • Needs network access to the specified Woztell API endpoint.
  • The default API endpoint is https://bot.api.woztell.com/sendResponses, but it can be customized.

Troubleshooting

  • Common issues:

    • Invalid or missing Channel ID or Member ID will cause the API call to fail.
    • Incorrect or expired API authentication token will result in authorization errors.
    • Providing an invalid media URL or unsupported media format may cause the API to reject the request.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Failed to send message: <error message>" indicates the node encountered an error during the HTTP request.
    • If continuing on failure is disabled, the node execution will stop on the first error.
    • To resolve errors, verify all required fields are correctly set, ensure valid credentials, and confirm the media URLs are accessible.

Links and References

Discussion