Why use AlcmeonChat triggers?

AlcmeonChat triggers allow you to automatically adapt AlcmeonChat's behavior based on your visitors' journey and context .

Each trigger consists of:

• a triggering event (when the rule executes),
• one or more conditions (in which situations),
• one or more actions (what actually happens).

Typical use cases

• Open the chat after X seconds on the homepage.
• Display an invitation message when the user has scrolled Y% of the page.
• Hide the chat button outside of business hours or when no advisor is available.
• Trigger a JavaScript event to track interaction in Google Analytics or Adobe Analytics .

Why use it?

• Increase engagement : Contextual and well-targeted invitations get more responses than static chats.
• Better qualify opportunities : open the Chat at the right time (strong intention).
• Streamlining the experience : we adapt the display according to the device, the page, the conversation history, etc.
• Measuring the impact : via dedicated events sent and tracked on Google or Adobe Analytics

Access AlcmeonChat triggers

Configuring triggers is reserved for users with “Administrator” permission.

1. Go to Settings > Accounts
2. Select your AlcmeonChat account
3. Click on the Triggers tab

The list of AlcmeonChat triggers

This list displays all the rules configured on the selected AlcmeonChat account. It allows you to quickly view the status of each rule, and to search for and manage AlcmeonChat triggers.

Columns displayed

• Trigger name
  Clickable name that opens the edit form.
• Activation
  Displays the current status (Active in green / Inactive in red).
  To change the state, open the automation and then toggle the Active switch.
• Triggering event
  Recall the event that triggers the rule (e.g. Time elapsed: 30 sec).
• Terms
  Summary of applied conditions (longer ones are truncated in the list view).
• Actions
  Recap of actions performed (e.g. Open the window…, Launch a JavaScript event…).
• Date of last edition
  Date and time of last modification.
• Latest editor
  User who last modified the rule (email address displayed).
• Line actions
  Trash icon to delete the rule (with confirmation).
  The deletion is final and cannot be reversed.

Long values (conditions/actions) are abbreviated in the list to optimize readability; hovering over them will display the full label in a bubble.

Create a new AlcmeonChat trigger

From the AlcmeonChat triggers list, click on New trigger to open the form.

General

• Trigger name (required)
• Description (optional)
• Active (yes/no)

1. Choose a triggering event

Choose the moment (a single triggering event) when the rule is triggered:

• When the page loads
• Time spent on the page (value in seconds)
• Page scrolling (% or pixels – if %, the value ≤ 100)

2- Define conditions

Refine your execution logic using conditions (optional but can be combined with “AND”).
Actions are only executed if all conditions are true.

Note: You can define up to 5 conditions

Displaying the Cat

• The chat button is displayed / is not displayed
• The chat window is open / is not open

Conversation status

• The customer has already / has not yet sent a message in the current conversation
• The client has /has not had a conversation in the past

Schedules

• During AlcmeonChat account opening hours
• Outside of AlcmeonChat's opening hours

Trick

Business hours are set in Settings > Business Hours

For each AlcmeonChat account, you can define the opening hours during which the Bots are triggered.

 

 

 

 

Advisor availability

• Connected advisors in Alcmeon (Boolean availability)
• Advisors available in Zendesk / MeetDeal (Boolean availability)

Zendesk/MeetDeal advisor availability is a specific option that requires Zendesk API configuration; without this configuration, this condition will always return False and will therefore never be validated.

Navigation context

• Current page : Entering a list of complete or partial URLs to include / exclude
• Device type : Desktop, Tablet, Mobile (Multiple selection)

3- Launch actions

Define the actions to be executed when the triggering event and conditions are met. At least one action is required, but you can combine several that will execute in the order you define.

Note: You can define up to 3 actions

Open the chat window and launch a scenario branch

Open AlcmeonChat and directly execute a script branch .
Enter the branch ID in the designated field. By default, if no ID is entered, the scenario will be played from the "Get Started" box. Ideal for a guided, proactive invitation.

This action has no impact if the chat window is already open.

Default JavaScript event associated with this action: automation-openChat

This event can be triggered when the action is executed, and additional parameters can be passed in JSON format {"param1":"valeur1"}

Trick

To retrieve the ID of the scenario box to which you want the user to be redirected:

• Access the interface for managing your scenarios
• Open the active scenario for your AlcmeonChat
• Click on the arrow in the upper right corner of the scenario box to which you are redirected.
• Select the “Copy ID” option
• Paste the information into the content of the “Scenario Box Identifier” field.

 

Close the chat window

Forces the chat window to close if it is open. Useful for properly ending an interaction.

This action has no impact if the chat window is already closed.

Default JavaScript event associated with this action: automation-closeChat

This event can be triggered when the action is executed, and additional parameters can be passed in JSON format {"param1":"valeur1"}

Show chat button

Makes the Chat launch button visible again or hides it.

This action has no impact if the Chat launch button is already visible.

Default JavaScript event associated with this action: automation-showButton

This event can be triggered when the action is executed, and additional parameters can be passed in JSON format {"param1":"valeur1"}

Hide the chat button

Hides the chat launch button . Useful for freeing up your teams (e.g., outside of business hours, when advisors are unavailable) or on pages where you want to limit interactions.

This action has no impact if the Chat launch button is already hidden.

Default JavaScript event associated with this action: automation-hideButton 

This event can be triggered when the action is executed, and additional parameters can be passed in JSON format {"param1":"valeur1"}

Display text in the chat invitation bubble

Displays a short message in the invitation bubble to encourage interaction without opening the window.
Fields: Invitation text 1 (required) and Invitation text 2 (optional) for a second line.

Default JavaScript event associated with this action: automation-displayInvitation

This event can be triggered when the action is executed, and additional parameters can be passed in JSON format {"param1":"valeur1"}

Note: You can make text bold using Markdown format by enclosing it in asterisks:
*fat*

Trigger a custom JavaScript event

Emits a CustomEvent on the browser side (name of your choice) with additional parameters in JSON.
Ideal for tracking (GA4, Adobe) or for triggering your own front-end scripts .

Learn more about using JavaScript events

Official Google Tag Manager documentation

Official Adobe Analytics documentation

Alcmeon developer documentation

Examples of use cases