Woztell Sender

Send messages through Woztell API

Overview

This node, "Woztell Sender," allows users to send messages through the Woztell API. It supports sending different types of responses including text messages and various media types (audio, file, image, video). The node is useful in scenarios where automated messaging or notifications need to be sent to specific channels and members within a communication platform integrated with Woztell.

Practical examples include:

  • Sending a text notification to a user when a certain event occurs.
  • Delivering an image or video as part of a marketing campaign.
  • Sharing audio files or documents automatically based on workflow triggers.

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 response 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, or Video).
Caption Optional text caption for media files (shown if Response Type is not Text).
API Endpoint The Woztell API endpoint URL used to send the message. Defaults to https://bot.api.woztell.com/sendResponses.

Output

The node outputs JSON data containing the following fields for each item processed:

  • success: Boolean indicating whether the message was sent successfully.
  • channelId: The channel ID to which the message was sent.
  • memberId: The member ID who received the message.
  • responseType: The type of response sent (e.g., TEXT, IMAGE).
  • apiResponse: The raw response returned by the Woztell API.
  • sentData: The exact data payload sent to the API.

If sending fails and the node is configured to continue on failure, the output includes:

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

The node does not output binary data.

Dependencies

  • Requires an API authentication token credential to access the Woztell API.
  • The Woztell API endpoint URL must be correctly configured (default provided).
  • Network connectivity to the Woztell API service.

Troubleshooting

  • Common issues:

    • Invalid or missing API authentication token will cause authorization failures.
    • Incorrect channel or member IDs may result in errors or messages not being delivered.
    • Providing an invalid media URL or unsupported media format can cause the API to reject the request.
    • Network issues or incorrect API endpoint URLs will prevent successful message delivery.

  • Error messages:

    • "Failed to send message: <error message>" indicates the node encountered an error during the HTTP request. Check credentials, input parameters, and network connectivity.
    • If the node is set to continue on fail, errors are reported per item in the output JSON under the error field.

Links and References

Discussion