XMPP Trigger icon

XMPP Trigger

Listen for XMPP (messages and files) and Rabbit (send commands).
Join our community

Overview

This node acts as an XMPP (Extensible Messaging and Presence Protocol) trigger that listens for incoming XMPP messages and files, and also integrates with RabbitMQ to send commands. It is useful for workflows that require real-time communication via XMPP, such as chat applications, file transfers, or command control through RabbitMQ. For example, it can be used to automate responses to chat messages or to handle file transfers over XMPP within an automated workflow.

Use Case Examples

  1. Automate chat message processing by triggering workflows on incoming XMPP messages.
  2. Receive and process files sent over XMPP using in-band bytestreams (IBB).
  3. Send commands to XMPP users via RabbitMQ queues integrated with this trigger.

Properties

Name Meaning
Priority Sets the priority level for the XMPP connection, influencing message routing priority.
IBB Timeout (s) Timeout in seconds for in-band bytestream (IBB) file transfers before considering them failed or aborted.
Emit Raw Stanza If enabled, emits raw XML stanzas received from the XMPP server as output for further processing or debugging.

Output

JSON

  • status - Indicates success status of the received message or file.
  • data
    • type - Type of the received data, e.g., 'conversation' for messages or 'file' for file transfers.
    • body - Content of the message or a description of the file received.
    • from - Sender's identifier.
    • file
      * fileName - Name of the received file (if applicable).
      * mime - MIME type of the received file (empty string if not specified).
      * base64 - Base64 encoded content of the received file.
  • type - Type of emitted data, e.g., 'raw-stanza' when raw XML stanza emission is enabled.
  • xml - Raw XML stanza content when 'Emit Raw Stanza' is enabled.
  • time - Timestamp when the raw stanza was received.

Dependencies

  • Requires credentials for XMPP connection (username, password, domain, service) and RabbitMQ connection (URL and authentication).

Troubleshooting

  • Ensure XMPP and RabbitMQ credentials are correctly configured; missing credentials will cause errors.
  • Timeout errors may occur if IBB file transfers exceed the configured timeout period; increase 'IBB Timeout (s)' if needed.
  • If raw stanza emission is enabled, large volumes of XML data may impact performance; disable if not needed.
  • Errors in JSON parsing of RabbitMQ messages will cause message rejection; ensure message format correctness.

Discussion