Trigger Messages property

Official Content
This documentation is valid for:
Specifies the trigger messages for this flow. You can type multiple messages using the ‘;’ delimiter.


Trigger Messages of the Flow help train the AI engine to recognize the intents in the user's query.

Trigger messages can include a reference to an entity (this is supported only in Watson, in DialogFlow is a deprecated feature), which is represented as @EntityName.
It can also include a reference to a system entity, such as 

  • @datetime
  • @date
  • @Numeric 

This has two purposes:

  • Better recognize the intent,
  • Automatically infer from the user's query some User input values, and avoid prompting for them.

See the examples below.


I. The "Greetings" Flow of a conversational instance can be defined as follows.

The Trigger messages are the following:


When the intent is detected, the Flow is executed as it has been modeled.
In this example, a Conversational Object is executed: "GreetingsProcedure." It returns a &Greeting depending on the time of day:

&datetime = now()
if &datetime.Hour() >= 12
    &Greeting =!"Good afternoon!"
    &Greeting = !"Good morning"

In order to display the greeting to the end user, the Messages property uses the &Greeting contextual parameter.


II. Using entity references in the Trigger Messages (this is supported only in Watson, in DialogFlow is a deprecated feature)

Suppose that you have the following Flow, where the intent is to ask for free tickets for an activity or to visit a place in the city.


One Trigger Message is the following: "I need @numeric tickets for a guided visit to @ActivityName"

@numeric refers to the "PromotionalTicketsQty" User Input which is of numeric data type:


@ActivityName refers to the "ActivityName" User Input, which has match With Entity property = TRUE, and entity property = ActivityName.


So when the user says: "I want 3 tickets for a guided visit to Solis Theater," the "PromotionalTicketsQty" value is automatically inferred as well as the "ActivityName," without the need to prompt him for this information

Note that this way of expressing the Trigger Messages is also very helpful to give semantics to the training phrase, for example: "When does @airline flight @numeric arrive?".


Objects: Conversational Flows

See Also