Message Created

Origin: Messages

This trigger fires when a message is created.

If you use this trigger with the Mask Credit Card Number in Message Content automation job, note that CXone only supports masking for standard credit card format. Credit card issuers may change their range or formatting. Our pattern recognition only supports changes made through March 2024.

Contact center administrator Akela Wolfe wants to tag messages and cases based on their content. These tags can be used for tracking and reporting purposes.

To accomplish this automated process, Akela creates a message created trigger with the following conditions:

  • Content contains: Allows her to specify the words, strings or regular expressions that will be tagged.
  • Message direction: Allows her to specify which messages will be tagged based on if they are inbound or outbound.
  • Case direction: Allows her to specify which cases will be tagged based on if they are inbound or outbound.

Then, she creates the Add tag to message and Add tag to case job and adds them to the trigger. With this configuration, every message and any case in the defined direction that contains a string he defined is tagged.

Create This Trigger

  1. Click the app selector and select ACD.

  2. Go to Digital > Automation Triggers.

  3. Click Add trigger.

  4. Enter a Name for the trigger. Since you can assign multiple jobs to the same trigger, use a name based on the event or conditions rather than an associated job.

  5. From the Event drop-down, select Message created.

  6. In the Delayed execution field, enter the number of seconds that Digital Experience should wait after the selected event occurs before firing the trigger. If you want it to happen immediately, enter 0.
  7. If you have folders that organize your triggers, you can select which folder to put this trigger in from the Folder drop-down.
  8. Click Save.
  9. From the detail page, click Activate when your trigger is completely configured.

Add a Condition

If you entered a value in the Delayed execution field when you created a trigger, make sure your condition configurations do not exceed that time. For example, if you set the Delayed execution time to 86400 seconds, or 24 hours, you cannot add a Contact status update time condition with a time period greater than 1 day.

  1. From the detail page, click Add Condition.
  2. Use the drop-down to select the condition you want. Refer to the table below for a list of conditions available for what you just created.
  3. Click Select.
  4. Some conditions require additional configuration. Refer to the table below for instructions.

Available Conditions

Condition Type Details and Instructions
Contact inbox assignee

Execute jobs if the case is assigned to the specified member of your team.

  1. Click Select. This opens a new page.
  2. From the drop-down, select the user the case should be applied to for the trigger to fire.
  3. Click Save. This redirects you to the trigger detail page.
Contact status

Execute jobs if the contact has any of the selected statuses.

  • Select the checkbox for any of the statuses you want the condition to apply to.
Contact status update time

Execute jobs if the time when the case status was updated fits into the defined timeframe.

  1. From the drop-down, select Is older or Is newer.
  2. In the first field, enter a number of days. This value cannot be negative.
  3. In the second field, enter a number of hours from 0-23.
  4. In the third field, enter a number of minutes from 0-59.
  5. Click Save.
Contact time in routing queue

Execute jobs based on how long a contact has been in the queue waiting to be assigned to an agent. Can be used with jobs to assign the contact to a different queue after a specified amount of time.

  1. From the drop-down, select Is older or Is newer.
  2. In the first field, enter a number of days. This value cannot be negative.
  3. In the second field, enter a number of hours from 0-23.
  4. In the third field, enter a number of minutes from 0-59.
  5. Click Save.
Contact waiting time

Execute jobs if the contact has been waiting without an agent response for the defined length of time.

  • Enter the number of minutes a contact should have to wait for this condition.
Chat Is Active

Execute jobs if the chat window displays an online status.

  • From the drop-down, select Yes or No.
Content contains

Execute jobs based on the content of a message. By default, it will look for matches to whatever you enter.

  1. Click Define Content. This opens a new page.
  2. If you want to exclude content of a message, select It does not match.
  3. If you want to use more complex searches, select Use regex.
  4. If you want your search to match the case of what you enter, select Case sensitive. This cannot be used with regex.
  5. Select Search in message content, Search in content of text based plugin (used for botClosed A software application that handles customer interactions in place of a live human agent. messages or rich content), Search in subject, or a combination of the three.
  6. Enter what you want the condition to search for in the field. You can use more than one field to make your search as specific as possible.
  7. Click Save. This redirects you to the trigger detail page.
Count of inbound messages in the contact

Execute jobs if the number of inbound messages in the case matches the set criteria.

  1. From the drop-down, select one of the following operators:
    • Lower than
    • Lower than or equal
    • Equals
    • Greater than or equal
    • Greater than
  2. Enter a number of messages. This value cannot be negative.
Count of outbound messages in the contact

Execute jobs if the number of outbound messages in the case matches the set criteria.

  1. From the drop-down, select one of the following operators:
    • Lower than
    • Lower than or equal
    • Equals
    • Greater than or equal
    • Greater than
  2. Enter a number of messages. This value cannot be negative.
Current contact assignment

Execute jobs based on if the case is assigned to an agent or if it's still waiting in the queue.

  • From the drop-down, select The case is waiting in the queue or The case is assigned in the agent inbox.
Custom condition

Execute jobs based on the response from the specified URL endpoint. The response from the endpoint should return boolean (true or false). This condition works for contact center triggers, proactive triggers, and schedulers.

  • Enter the URL that returns the result of your rule.
Custom script

Execute jobs based on the script you write in Primi language. This condition works for contact center triggers, proactive triggers, and schedulers.
Date and time

Executes jobs during or outside of specified time frames.

  1. Click Select. This opens a new page.
  2. Select a radio button to Include selected days and times or Exclude selected days and times.
  3. From the drop-down, select Day of the week or Date range.
  4. For Day of the week, select the checkbox for any day that should be a part of the condition.
  5. For Date range, type or use the pop-up calendar to select a start and end date.
  6. Use the Choose time slot options to specify times of day for this condition.
  7. Click Save. This redirects you to the trigger detail page.

Jobs can process up to 500 contacts at a time. If you need to process more, have the job run more than once per day at different times.

Exclude based on Post IDs

Executes jobs excluding all cases that originate from a specific post ID. This is useful to filter out comments on a post that you want to route to a different queue.

  1. Enter a post ID. If including multiple IDs, separate them with commas.
  2. Click Save.
Excluded message subjects rule

Executes a job based on subject. In this case, any subject that does not include what you specify triggers the job.

  1. Enter any value in the field. Separate multiple values using commas.
  2. Click Save.
Excluded message tags condition

Executes a job based on tags attached to the message. In this case, any message that does not have the tags you specify triggers the job.

  1. Click Choose Tag. This opens a new page.
  2. Select the checkbox for any tags a message should not have for the trigger to fire.
  3. Click Save. This redirects you to the trigger detail page.
Excluded tags condition

Executes jobs based on tags on cases. Any case that does not have the tags you specify triggers the job.

  1. Click Choose Tag. This opens a new page.
  2. Select the checkbox for any tags a case should not have for the trigger to fire.
  3. Click Save. This redirects you to the trigger detail page.
Include based on Post IDs

Executes jobs based on a specified post ID. In this case, any case that includes at least one specified post ID is included.

  1. Enter a post ID. If including multiple IDs, separate them with commas.
  2. Click Save.
Included channels condition

Checks whether the chat window that is on the website belongs to specific channel. This trigger works for both contact center triggers and proactive triggers.

  1. Click Choose Channel. This opens a new page.
  2. Select the checkbox for any channels you want to include for the trigger to fire.
  3. Click Save. This redirects you to the trigger detail page.
Included message sentiments rule

Executes a job based on sentiment. In this case, any message that is marked with the sentiments you specify triggers the job.

  • Select the checkbox for Negative, Neutral, or Positive sentiment, or any combination of the three.
Included message subjects rule

Executes a job based on subject. In this case, any subject that includes the specified values triggers the job.

  1. Enter any value in the field. Separate multiple values using commas.
  2. Click Save.
Included message tags condition

Executes a job based on tags attached to the message. In this case, any message that has the tags you specify triggers the job.

  1. Click Choose Tag. This opens a new page.
  2. Select the checkbox for any tags a message should have for the trigger to fire.
  3. Click Save. This redirects you to the trigger detail page.
Included tags condition

Executes jobs based on tags on cases. Any case that has the tags you specify triggers the job.

  1. Click Choose Tag. This opens a new page.
  2. Select the checkbox for any tags a case should have for the trigger to fire.
  3. Click Save. This redirects you to the trigger detail page.
Last message sent

Executes jobs based on the direction of the last message and how long ago it was sent. You can set this up to look at only the last message from the contact (inbound), only the last message from the agent (outbound), or both.

  1. Use the drop-down to select where the last message came from:
    • Inbound
    • Outbound
    • Both
  2. Enter the time since the last message was sent:
    1. In the first field, enter a number of days. This value cannot be negative.
    2. In the second field, enter a number of hours from 0-23.
    3. In the third field, enter a number of minutes from 0-59.
  3. Click Save.
Message created time

Executes jobs based on when the message was created.

  1. From the drop-down, select Is older or Is newer.
  2. In the first field, enter a number of days. This value cannot be negative.
  3. In the second field, enter a number of hours from 0-23.
  4. In the third field, enter a number of minutes from 0-59.
  5. Click Save.
Message direction

Execute jobs according to whether the message is inbound or outbound.

  • From the drop-down, select Message is inbound or Message is outbound.
Message reply

Executes jobs based on whether an inbound message has been replied to.

  • From the drop-down, select The message has a reply or The message doesn't have a reply.
Probability of Execution

Executes jobs based on a probability percentage. This condition works for contact center triggers, proactive triggers, and schedulers.

  1. Use the slider to select a percentage. 100% means the job executes every time. 0% means the job never executes.
  2. Click Save.
Routing queue limit

Executes jobs based on the size of the routing queue.

  • Enter the maximum number of cases a routing queue can have for this condition to apply.
Routing queues

Executes jobs based on the routing queue.

  1. Click Choose Queue. This opens a new page.
  2. Select the checkbox for any routing queues that should fire the trigger.
  3. Click Save. This redirects you to the trigger detail page.
Satisfaction Survey Grace Period

Executes jobs based on the last time a satisfaction survey was sent. Any jobs in this workflow that would be run during this time frame are skipped.

  • Enter the number of days for the grace period.

Add a Job

  1. From the detail page, click either Add new job or Add existing job, depending on if the job you want already exists.

  2. If you clicked Add new job, follow the steps to create the job you want. These steps can be found on the individual help page for that job, located in the menu on the left of this page.
  3. If you clicked Add existing job:
    1. Use the drop-down to select the job you want.
    2. Click Add.