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, optionally fetches file URLs via a GraphQL API if the message contains media, and outputs structured message data.

Common scenarios where this node is useful include:

  • Integrating Woztell messaging events into an n8n workflow.
  • Automatically processing incoming multimedia messages by retrieving their accessible URLs.
  • Triggering downstream automation based on different message types received from Woztell.

For example, when a user sends an image through Woztell, this node can capture the webhook, query the GraphQL endpoint to get the image URL, and pass that information along for further processing or storage.

Properties

Name Meaning
Path The path segment of the webhook URL where this node listens for incoming POST requests.
GraphQL Endpoint The URL of the Woztell GraphQL API endpoint used to fetch additional data like file URLs.

Output

The node outputs JSON data 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: The publicly accessible URL of the media file if applicable; otherwise, null.
  • body: The full original webhook payload received.

If the message includes media (image, video, sticker, audio, or file) and contains a file ID, the node queries the GraphQL API to retrieve the file's URL and includes it in the output.

The node does not output binary data.

Dependencies

  • Requires an API authentication token credential to access the Woztell GraphQL API.
  • Needs network access to the specified GraphQL endpoint (default: https://open.api.woztell.com/v3).
  • Configured webhook path must be exposed and reachable by Woztell to deliver webhook events.

Troubleshooting

  • Invalid webhook data: missing type field: This error occurs if the incoming webhook payload lacks a type property. Ensure Woztell is configured correctly to send valid webhook data.
  • Webhook processing failed: [error message]: General failure during webhook handling, possibly due to network issues or invalid credentials. Verify the API token and endpoint URL.
  • If media URLs are not retrieved, check that the file ID exists in the webhook payload and that the GraphQL endpoint is reachable with correct authorization.
  • Make sure the webhook path matches the one configured in Woztell and is publicly accessible.

Links and References

Discussion