# Communications Queues

{% hint style="info" %}
**IMPORTANT** Communications Queues is an advanced feature intended only for system administrators. If you don't see this option it's likely your Keyfax Administrator Tools user account does not have sufficient permission to view these options. &#x20;
{% endhint %}

This feature is available from Keyfax version 4.4.7 onwards.

Use the Communications Queue screen to monitor the progress of outgoing Emails/SMS, requeue communications that failed to send or dequeue communications that should no longer be sent.

<figure><img src="/files/MFFqnMBamgFz5QOAQa0F" alt=""><figcaption><p>The Communications Queue screen</p></figcaption></figure>

Communications may be searched for by:

1. **Filter** - communications main text or subject content&#x20;
2. **Date Range** - start and end dates (defaults to the last week of communications)
3. **Type** - the type of communications being sent (e.g. Email, SMS, RMM)
4. **Queue Configuration** - the configuration that was responsible for sending the outgoing message&#x20;

Each message can be selected in the left hand pane to be viewed in detail in the right hand pane.  From here the actions available are:

1. **Tasks -> Requeue communication** - allows an Email/SMS that has already failed to send to be requeued for sending (e.g. when a network infrastructure problem caused many communications to not be sent, those communications can be requeued for sending at a later time once the network issue has been resolved)
2. **Tasks -> Dequeue communication** - allows an Email/SMS to be taken out of the queue (if it had been requeued in error or for any other reason)
3. **View 'Error Details'** - where a communication has failed to send (or has been requeued or dequeued by the administrator previously via this screen) details of the event can be viewed by picking 'Error Details' at the top of the right hand pane

{% hint style="info" %}
**NOTE:** None of the Message Queue Item Properties (To, CC, content fields etc) within the Communication Queue can be edited to protect the security and integrity of messages.
{% endhint %}

Messages are sent automatically and polled every couple of minutes, therefore please allow time for it to be processed.

The following colours are used to depict the message status:

**Grey** - in the process of being sent

**Green** - the message was successfully sent

**Red** - the message has failed to send

<figure><img src="/files/2bB4aXYg2Re9D473hSEe" alt=""><figcaption><p>Communication Queue Status</p></figcaption></figure>

## Multi-selection of Email/SMS

It is possible to select multiple Emails/SMS on the left hand pane in order to:

1. See all the errors related to them using the 'Error Details' button
2. Requeue or dequeue large groups of items simultaneously


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keyfax.biz/product-suite/admin/advanced/communications-queues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
