Woztell Handler

Receive and process Woztell webhook data for different message types

Overview

This node acts as a webhook handler for Woztell, a messaging platform. It receives incoming webhook data related to various message types such as images, videos, stickers, audio, and files. Upon receiving a webhook event, it processes the payload, extracts relevant information including media URLs if applicable, and outputs structured data for further workflow automation.

Common scenarios where this node is beneficial include:

  • Automating responses or actions based on incoming messages from Woztell.
  • Logging or processing multimedia messages by retrieving their accessible URLs.
  • Integrating Woztell messaging events into broader business workflows without manual intervention.

For example, when a user sends an image via Woztell, this node captures the webhook, fetches the image URL using the file ID, and outputs the message details along with the direct URL to the image for downstream processing.

Properties

Name Meaning
Path The URL path segment where the webhook listens for incoming POST requests. This defines the endpoint that Woztell will call to deliver webhook data.

Output

The node outputs JSON data containing the processed webhook information with the following structure:

  • message_type: The type of the incoming message (e.g., IMAGE, VIDEO, STICKER, AUDIO, FILE).
  • text_message: The text content of the message if available; otherwise null.
  • file_url: A direct URL to the media file if the message includes a supported media type and the file URL was successfully retrieved; otherwise null.
  • body: The full original webhook payload received from Woztell.

The output is provided as an array of workflow items under the workflowData key, suitable for use in subsequent nodes.

Dependencies

  • Requires an API authentication token credential to access Woztell's API.
  • Makes HTTP POST requests to Woztell's GraphQL API endpoint (https://open.api.woztell.com/v3) to retrieve media file URLs based on file IDs.
  • Must be configured with a valid webhook path that matches the one registered in Woztell.

Troubleshooting

  • Invalid webhook data: missing type field
    This error occurs if the incoming webhook payload does not contain a type property. Ensure that Woztell is correctly configured to send valid webhook events.

  • Webhook processing failed: [error message]
    General failure during webhook handling, possibly due to network issues, invalid credentials, or unexpected payload structure. Verify API credentials and network connectivity.

  • Media URL retrieval failures
    If the node cannot fetch the media URL for supported message types, the file_url will be null. This might happen if the file ID is invalid or expired. Confirm that the file ID exists and the API token has sufficient permissions.

Links and References

Discussion