Amazon SQS - New message trigger

The SQS connector supports the following triggers:

• New message
• New messages (Batch)

New message

The New message trigger checks your SQS queue at regular polls to retrieve messages. Use the New message (Batch) trigger for high volume queues.

Input

Input field	Description
Queue	Enter the queue to pull messages from.
Automatically delete message	Select true to automatically delete messages as they are retrieved.
Visibility timeout	Enter the duration (in seconds) of the visibility timeout. This hides messages retrieved by a ReceiveMessage request from subsequent retrieve requests for a specified amount of time. Maximum value is 12 hours. Refer to Visibility timeout for more information.

Output

Output field	Description
Request ID	The unique ID of the request.
MD5 of message attributes	The MD5 hash of the message attribute.
MD5 of message body	The MD5 hash of the message body.
MD5 of message system attributes	The MD5 hash of the message system attribute.
Message ID	The unique ID of the message.
Message body	The message's contents.
Sequence number	The large, non-consecutive number that Amazon SQS assigns to each message. This parameter applies only to FIFO (first-in-first-out) queues.

New message (Batch)

The New message (Batch) trigger regularly polls your specified SQS queue to retrieve messages. Workato recommends the batch trigger for high volume queues.

Input

Input field	Description
Queue	Enter the queue to pull messages from.
Automatically delete message	Select true to automatically delete messages as they are retrieved.
Visibility timeout	Enter the duration (in seconds) of the visibility timeout. This hides messages retrieved by a ReceiveMessage request from subsequent retrieve requests for a specified amount of time. Maximum value is 12 hours. Refer to Visibility timeout for more information.
Batch size (Only for batch trigger)	Enter the maximum number of messages for each trigger event. The minimum is 10, maximum is 2000, default is 2000. The input must be a multiple of 10.

FIFO QUEUE MESSAGE LIMITS

When using the New message batch trigger with a FIFO queue, Amazon SQS limits the number of messages returned per Message group ID, not the total batch size.

Amazon SQS enforces strict ordering by Message group ID, which groups related messages together. SQS processes messages with the same Message group ID one at a time, in the order they were sent.

As a result, even if you configure a higher batch size in your recipe, the trigger retrieves up to 10 messages from each message group at a time. This is an Amazon SQS API limitation that Workato can't override.

To process more messages concurrently, distribute messages across multiple Message group IDs or run several recipes that connect to the same queue.

Refer to the FIFO queue delivery logic in Amazon SQS (opens new window) documentation for more information.

Output

The output to this trigger is a list of messages.

Output field	Description
Request ID	The unique id of the request.
MD5 of message attributes	The MD5 hash of the message attribute.
MD5 of message body	The MD5 hash of the message body.
MD5 of message system attributes	The MD5 hash of the message system attribute.
Message ID	The unique ID of the message.
Message body	The message's contents.
Sequence number	This parameter applies only to FIFO (first-in-first-out) queues. The large, non-consecutive number that Amazon SQS assigns to each message.