Parseur Trigger icon

Parseur Trigger

Trigger workflow on events sent from Parseur

Overview

This node acts as a trigger that activates workflows based on events sent from the Parseur service, which is used for parsing emails and documents. It listens for specific document or table processing events such as when a document is processed, export fails, or tables are processed. This is useful for automating downstream tasks like data extraction, notifications, or further processing once Parseur completes its parsing jobs.

Typical use cases include:

  • Triggering a workflow when a document has been successfully processed to extract parsed data.
  • Reacting to failures in document export or processing to alert users or retry operations.
  • Handling structured table data extracted by Parseur for integration with databases or spreadsheets.

Properties

Name Meaning
Event The type of Parseur event to listen for. Options: Document Export Failed, Document Processed, Document Processed (Flattened), Document Processing Failed, Table Processed, Table Processed (Flattened). For table events, re-selecting the mailbox refreshes the available tables.
Mailbox Name or ID Select or specify the mailbox (parser) from which to receive events. The list depends on the selected event type.
Table Name or ID (Shown only for table-related events) Select or specify the table field within the mailbox to listen for events.
Debug Mode Enable debug logging for development purposes to get detailed logs about webhook handling and API requests.

Output

The node outputs JSON data representing the payload received from Parseur's webhook. This JSON contains all details about the triggered event, including parsed document or table data depending on the event type.

If the event relates to table processing, the output includes structured table data; otherwise, it contains document-level information. No binary data output is indicated.

Example output JSON structure (simplified):

{
  "documentId": "string",
  "status": "processed",
  "data": {
    // Parsed fields or table data depending on event
  },
  "eventType": "document.processed"
}

Dependencies

  • Requires an API key credential for authenticating with the Parseur API.
  • Needs proper configuration of webhooks in Parseur via this node to receive events.
  • Uses internal methods to fetch available mailboxes and table fields dynamically from Parseur.

Troubleshooting

  • Webhook Token Mismatch: If the webhook token sent by Parseur does not match the stored token, the node throws an unauthorized error. Ensure the correct API credentials are configured and the webhook URL is properly registered in Parseur.
  • Webhook Event Mismatch: If the incoming event type does not match the configured event, the node rejects the webhook. Verify that the event property matches the expected Parseur event.
  • Missing Mailbox Selection: When selecting table events, if no mailbox is chosen, the node will throw an error prompting to select one.
  • No Table Fields Configured: For table events, if the selected mailbox has no table fields configured, an error is thrown advising to select another mailbox or change the event type.
  • Debug Mode: Enabling debug mode helps trace issues by logging detailed information about API calls and webhook handling.

Links and References

Discussion