Admin: Queue Listener Setup

Queue listeners facilitate the monitoring of ‘listener queue’ for the arrival of data.  Data arrives in the form of JSON packages – placed on the queue either by an external system, or at submission of a web form.  Downstream queue activities can then use this data to execute offers.  Queue listeners might typically be used for the sending of emails e.g. after a customer makes a purchase, or when a web form is submitted in a landing page.

More details on queue listeners can be found in the RPI User Guide.

Please follow these steps to configure RPI to use queue listeners:

1. Configure the listener queue provider in the Server Workbench Queue Providers interface.

2. Ensure the following cluster configuration settings are set:

   • ListenerQueueIsEnabled: set to True

   • ListenerQueuePath: set to path of queue to be used as listener queue.

3. At the RPI Realtime appsettings.json file, set the ListenerQueuePath setting value to the same value as per the previous step.

4. In the Server Workbench Queue Providers interface, copy the listener queue’s JSON configuration to the clipboard.

5. Paste the same into the RPI Realtime appsettings.json file’s ListenerQueueSettings section.