{"versionId":"4c7d6bf6-908e-42b2-95ea-08dc842a2812","articleId":"8e5cb511-8981-4264-2334-08db4cf3dadb","title":"Pattern matched engagements","tags":["engagements","All articles"],"content":"

Engagements give your FAQ Bot maximum flexibility to trigger forms, actions or sequences of messages based on what is typed in chat, plus other context. Learn more about engagements.

\n

One way to trigger an engagement is when a user types something into the chat with a defined pattern.

\n

For example:

\n\n

There are three steps to setting up a pattern matched engagement.

\n

Step one: set up a context key

\n

We use a context key to store the matched value.

\n

To set a new context key, go to Configuration > Bot context. (Can't see Bot context on your menu? Contact us to enable).

\n

\n

 

\n

The name of your context key should match any other uses of that context within the bot/portal. For example, if you are matching a reference number, the context key could be named Reference, corresponding to a form field also named Reference.

\n

Scope

\n

There are three options for the scope of the context key:

\n\n

Sensitivity

\n

The sensitivity setting allows you to mask sensitive data collected

\n

Owned by

\n

Data contained in the context key can be viewed and modified by the owner. This can be set to the user or the system.

\n

 

\n

Step two: define the pattern

\n

The pattern is expressed as a regular expression (or regex). 

\n

If you're not familiar with regular expressions, you could try using ChatGPT to help you formulate it. Here is an example:

\n

\n

Prefer to build from scratch? Here's a reference guide that might be useful.

\n

You can also try this site as you build and test - select .NET (C#) flavor of regex.

\n

It's important to test your regular expression, to make sure that it captures different examples of the pattern you're looking for (and doesn't capture, for example, longer strings that contain the match but also extra info).

\n

Once you have formulated your regex, you can also test it on some different examples here.

\n

Feel free to get in touch if you need help formulating your regular expression.

\n

 

\n

Step three: set up your engagement

\n\n

\n

Set up the engagement action as you normally would for any engagement.

\n

A pattern matched engagement does have an additional option of collecting context from the pattern match.

\n

In this case there wouldn't be any visible action for the user, but the context recognised in the pattern (eg email address, reference number) is collected and stored (if allowed for in step 1).

\n

\n

Test it out

\n

Once you have saved your engagement, you can test in your bot by typing some words/phrases including your pattern, and make sure everything works as you expect.

\n

 

\n

 

","description":"","isMarkdown":false,"publishedOnUtc":"2024-06-11T02:22:50.8204769","modifiedOnUtc":"2023-05-15T05:16:23.4587277"}