> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/marketing/auto-assign-2.0/auto-assign-2.0-set-up.md).

# Auto Assign 2.0: Set-Up

{% hint style="info" %}
**Triggering&#x20;**<mark style="color:$danger;">**Auto Reply**</mark>**&#x20;+&#x20;**<mark style="color:$warning;">**Auto Assign**</mark>**&#x20;Conditions:**

1. Auto Assign Team Member is **"Customer Service Member"**: Both <mark style="color:$danger;">**Auto Reply**</mark>**&#x20;+&#x20;**<mark style="color:$warning;">**Auto Assign**</mark>
2. Auto Assign Team Member is **"Sales Member"**: <mark style="color:$warning;">**Auto Assign**</mark> Only
3. For conversations initiated via "Webchat", Auto Reply and Auto Assignment cannot be triggered simultaneously. Omnichat will process them in sequence:\
   (1) The Auto Reply message will be triggered first.\
   (2) The Auto Assignment will only be triggered after the customer sends a second message.
   {% endhint %}

## **Accessing Auto Assign 2.0:**

To begin, navigate to the Auto Assign 2.0 page from your main menu. This feature empowers you to automate the assignment of incoming customer messages to specific teammates or groups based on keywords they use.

**Understanding the Interface:**

The image showcases the core components of Auto Assign 2.0:

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fl6EYWKLCtjDihnrDAQRE%2Fimage.png?alt=media&amp;token=c7c4751f-7ee3-45db-a312-7d2b8f111a46" alt=""><figcaption></figcaption></figure>

1. **Group:** Use this section to categorize your keywords. For example, you can group them by access roles to the platform, specific campaigns, or particular purposes.
2. **Target Channel:** This displays the communication channel (in this case, Omnichat CSM Demo) where the auto-assign rules will be applied.
3. **Auto-assign Rules:** This section lists the defined rules for automatic message assignment. Each rule consists of:
   * Customers' Messages
   * Role/Person the message will be assigned to
   * Status - whether enabled or disabled
   * More Actions - for further editing, generating QR code, enabling/disabling the rule, or deleting the rule altogether.

{% hint style="info" %}
**Please note:**

* If a team member changes their status to **Offline**, conversations will not be automatically assigned to that member.
* If the assignment target is a **Sales role** and all sales members are **offline**, the system will randomly assign the conversation to one of the sales members.
* Auto assign does not support being triggered by **stickers** or **image messages**.
  {% endhint %}

## Auto-Assign Set-Up Process

1. First, from the main menu, navigate to "Advanced Automation"
2. Select "Auto Assign 2.0".<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/2a70c9ed-8115-423d-908f-0dbf46fa5ff9/ascreenshot.jpeg?tl_px=0,730\&br_px=1547,1596\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=104,388)
3. Now, just like in Auto Reply, you will need to add a new group to nestle your keyword rules underneath.<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/3ae89fdc-be52-4c0a-bf96-0ef5603d9663/user_cropped_screenshot.jpeg?tl_px=602,0\&br_px=2150,865\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=926,39)
4. Create the group name for your Auto Assign rule. Ensure the rule is "Enabled".<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/95e7cd6b-24cf-4429-a7cc-febf1460af34/ascreenshot.jpeg?tl_px=278,349\&br_px=1825,1214\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=523,277)
5. Select the target channel.<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/b422f3d9-4e0e-4f34-b8bd-276ab1a502ed/user_cropped_screenshot.jpeg?tl_px=179,730\&br_px=1726,1596\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=524,350)
6. Click "Save"<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/69a228d9-b74b-4697-9e7b-02e6965ea237/user_cropped_screenshot.jpeg?tl_px=0,353\&br_px=1446,1219\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=781,489)
7. Once the Group is enabled, click on "Add New Rule".<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/73873568-25ea-4be0-8ef2-62fffb7bbeac/user_cropped_screenshot.jpeg?tl_px=602,74\&br_px=2150,939\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=885,277)
8. Select your corresponding keyword condition, then insert your preferred keyword.\
   \**Please note that **image messages** are currently not supported as triggers for auto assign.*<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/84b1fd33-0e01-418d-9847-04889014983d/user_cropped_screenshot.jpeg?tl_px=0,96\&br_px=1547,961\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=144,277)
9. Now, select the teammate responsible for handling the keyword. If there are no specific teammate, the option will assign your contact to all the teammates in your account. You can also select specific roles to handle the keyword if necessary.\
   \
   If you are on the OMO plan, you can assign specific keywords to specific store locations. In this example, "Finance (Customer Service Manager)" is selected.<br>

   ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/92680c3e-01bb-4cec-9a9d-c84c5b245ee7/ascreenshot.jpeg?tl_px=143,730\&br_px=1690,1596\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=524,355)
10. Select the order which the assignment will be done.\
    "Random" - the assignment will be randomised.\
    "Sequential" - contacts are assigned to agents in the order they join the platform.<br>

    ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/764ed860-2edc-4d03-9c77-359d61da8be8/ascreenshot.jpeg?tl_px=0,730\&br_px=1547,1596\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=489,378)
11. After you have completed your settings, click "Save".<br>

    ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/47bd7bc7-1794-4560-a866-9c390e3d6a63/ascreenshot.jpeg?tl_px=602,0\&br_px=2150,865\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=992,45)
12. Confirm your settings once you have saved them.<br>

    ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/ebc0c646-d461-485b-8b83-f94f857d56b5/ascreenshot.jpeg?tl_px=602,468\&br_px=2150,1333\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=528,277)
13. To test your keyword rule out, click the three dots (...) in the Action column once the rule is generated.<br>

    ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/46c10e8d-723d-4f32-ae65-3c7a036161f7/user_cropped_screenshot.jpeg?tl_px=602,310\&br_px=2150,1175\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=940,277)
14. Click "Get QR Code" .<br>

    ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/a3f715ad-b322-480d-bc97-3da1c6ac5d95/user_cropped_screenshot.jpeg?tl_px=602,457\&br_px=2150,1322\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=976,277)
15. Click "Generate".<br>

    ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/4776785d-1565-483e-be76-43cc0b60745d/user_cropped_screenshot.jpeg?tl_px=602,475\&br_px=2150,1340\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=547,277)
16. Click on the corresponding URL or scan the QR code with your mobile phone. You will see the predefined text in your message input section on the app in your device. Proceed to send the keyword to the channel. Then, go to Conversation 2.0.

{% hint style="info" %}
Reminder: Only **single sentences, phrases** or **words** can generate a QR code. Use the link provided or download the QR code for your campaigns if necessary.
{% endhint %}

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-08-21/c3a7ae7c-45d5-4c47-bc1c-2075b7287f89/ascreenshot.jpeg?tl_px=473,730\&br_px=2020,1596\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=523,384)

17. If you have assigned the keyword to yourself, go to "My Cases > Progress", then see if your test contact appears on your inbox. Otherwise, go to Teammates Cases > Progress, and see if the contact is successfully assigned to your teammate.<br>

    ![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2024-06-18/e940230b-46c4-4a98-b39b-43f08cbd4847/user_cropped_screenshot.jpeg?tl_px=113,0\&br_px=1660,865\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=524,130)
18. If the contact appears, congratulations, your test is successful. You can now proceed to use Keyword Auto Assign for your contacts!

### **Other Frequently Asked Questions**

#### 1. How can we set up auto-assign trigger conditions for conversations coming from FB/IG ads?

**Applicable channel:** **WhatsApp (currently, automatic assignment is only supported for this channel).**

Generally, when a conversation enters Omnichat via a FB/IG ad, it will appear in two separate messages:

* **First message:** The ad post content (ending with: `source: post URL` / `Ad ID: a string of numbers`).
* **Second message:** The pre-filled message (this text is configured by the brand when setting up the ad. When a customer clicks on the ad and enters the chat, this message will already be pre-filled in the input box).

<div><figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FfQIHbAx5fjfkMb6537Nr%2F%E9%A1%A7%E5%AE%A2%E8%A6%96%E8%A7%92.jpg?alt=media&amp;token=74ec1c5b-c605-4c76-931e-59ef68b933a4" alt="" width="233"><figcaption><p>Customer-side view</p></figcaption></figure> <figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FyMV5yukmtaOkgkSHUOpA%2F%E5%BB%A3%E5%91%8A%E9%A0%90%E5%A1%AB%E6%96%87%E5%AD%97eng.jpg?alt=media&amp;token=4fc4812c-efc6-4d78-a6c7-6e9d7de1b8da" alt="" width="375"><figcaption><p>Omnichat conversation backend</p></figcaption></figure></div>

{% hint style="info" %}
How to Set Up Auto-Assign Trigger Conditions (Using the Example Above):

1. **Is exactly the same as: "Pre-filled message + one space + Ad ID numbers"** e.g:\
   `Where can I buy in stores? 120239156226090600`
2. **Contains any: Ad ID numbers only**(Please do NOT include the words “Ad ID”) e.g: `120239156226090600`
3. **Contains any: Pre-filled message** e.g `Where can I buy in stores`
   {% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FVrl935HsPSJdzr4jcs08%2Fimage.png?alt=media&amp;token=7cd4d997-10d3-402c-bd49-1838f056b505" alt=""><figcaption><p>Correct auto-assign trigger condition setup method</p></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FJZSc8h2B4viyy67gVWmW%2Fimage.png?alt=media&amp;token=2b188b33-f7a9-4b38-8da2-4f7b7bb2d41a" alt=""><figcaption><p>Correct auto-assign trigger condition setup method</p></figcaption></figure>

{% hint style="danger" %}
Please note that the following configurations **will NOT** trigger the auto-reply:

* `Ad ID: 120239156226090600`
* `Where can I buy in stores? Ad ID: 120239156226090600`
  {% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FBYY45yo6TVCjuvL25q23%2Fimage.png?alt=media&amp;token=177c4fdf-628a-435d-bd65-6a08fb233afc" alt=""><figcaption><p>Incorrect auto-assign trigger condition setup method</p></figcaption></figure>

**Additional Note:**

For posts where the source is displayed as a **Post ID**, the setup method follows the same logic as described above.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FQdRqd6drsqKeyJMBdrnv%2Fpost%20id%20oc%20%E7%AB%AF.jpg?alt=media&amp;token=6be5c2c8-5b69-4b6b-986d-bb535d49a4e5" alt="" width="375"><figcaption></figcaption></figure>
