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 the URL of an attached file via a GraphQL API, and outputs structured message data.

Common scenarios where this node is useful include:

  • Automating workflows triggered by incoming messages on Woztell.
  • Extracting media URLs from received messages to process or store them elsewhere.
  • Integrating Woztell messaging events into broader automation pipelines without manual intervention.

For example, when a user sends an image through Woztell, this node can capture the webhook, retrieve the image URL using the GraphQL endpoint, and pass that information downstream for further processing like saving the image or triggering notifications.

Properties

Name Meaning
Path The URL path segment where the webhook listens for incoming POST requests (e.g., "webhook").
GraphQL Endpoint The URL of the Woztell GraphQL API endpoint used to query additional data like file URLs.

Output

The node outputs JSON data with the following structure:

{
  "message_type": "string",        // Type of the incoming message (e.g., IMAGE, VIDEO, TEXT)
  "text_message": "string|null",   // Text content if available, otherwise null
  "file_url": "string|null",       // URL of the attached file if applicable, otherwise null
  "body": {                        // The full original webhook payload
    /* original webhook data */
  }
}
  • If the message contains media (image, video, sticker, audio, or file) and includes a file ID, the node queries the GraphQL endpoint to retrieve the direct URL of the file and includes it in file_url.
  • For other message types or missing file IDs, file_url will be null.
  • The entire original webhook payload is preserved under the body field for reference.
  • The node does not output binary data directly but provides URLs to media files.

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).
  • The node expects to be configured with a valid webhook path and the correct GraphQL endpoint URL.

Troubleshooting

  • Invalid webhook data: missing type field
    This error occurs if the incoming webhook payload lacks the required type property. Ensure that Woztell is correctly configured to send webhook events with the expected structure.

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

  • File URL retrieval fails silently
    If the node cannot fetch the file URL from the GraphQL API (e.g., due to invalid file ID or API errors), it sets file_url to null without throwing an error. Check the validity of file IDs and API permissions.

Links and References

Discussion