Overview

Amazon Simple Queue Service (Amazon SQS) is a distributed message queuing service that supports sending messages via web service applications. Our Amazon Message Queues integration allows you to add actions to your learning platform that send messages to the queue when they are triggered.

In order to enable the integration, you will need an AWS account where message queues are configured.

Configuring message queues

Before you start configuring the integration, go to Admin/App center and install the "Message queues" application.

Once the app is installed, go to Admin/Message queues and click Add in the top right.

Use the details from your AWS account to add the name of the message queue, the access key ID, the secret access key, and the queue URL, then click Save.

When you click Save, the message queue will send a test message to test the credentials. If the test was successful, the status would change to "Valid".

Here you can also edit or delete the message queue by clicking the appropriate button.

Adding message queue actions

After creating the message queue, you can start defining rules for courses, modules, assessments, and accounts that trigger "Message queue" actions. For example, you can add a "Message queue" completion action to the course that will send a message to the queue when learners finish the course.

To do this, go to the course, visit its Admin/Completion tab and click Add under "Completion actions".

A pop-up will open where you can go to the Other tab and select "Message queue".

Select the message queue from the dropdown, then enter the content of the message. Here you also use the available message queue variables. When you configured the message, click Save.

The action will be added under "Completion action".

When the action is triggered, it will send a message to the queue. To see the message queue statistics, go to the Admin/Message queues area and select the message queue. Here you will see the number of calls, the time of the last call, and the number of errors.

Messages in the AWS account

To see the messages go to your AWS account. After you log in, make sure that the right location is selected in the top right.

Search for SQS, then select "Simple Queue Services".

Select the message queue from the list.

Click the "Send and receive messages" button.

Under "Messages available", you will see the number of messages. To list them, click the "Poll for messages" button.

To see the content of a message, click on its name.

The message will be displayed in a pop-up.