Chat Message Trigger

The Chat message trigger runs a workflow when a message is received in MergePoint Chat. Use it to build conversational agents, assistants, or automated responders that activate when a user sends a message.

---

Setup

In the Start node inspector, select Chat message. Configure the options below.

---

Message Source

Choose which messages the trigger listens to:

• MergePoint — messages sent inside MergePoint Chat
• External — messages arriving from an external channel
• All — both sources

---

Agent Configuration

When this trigger is used to power a chat agent, configure the agent's identity:

• Agent name — the display name shown in the chat interface
• Agent description — a brief description of what the agent does
• Agent icon — an icon displayed next to the agent's name

Publicly available — when enabled, the chat agent can be accessed without logging in to MergePoint.

Hub enabled — when enabled, the agent appears in the MergePoint Chat hub.

---

Input Properties

Define structured input fields the agent can collect from users during the conversation. Each property has a name and type. These become available as step outputs in the workflow.

---

File Uploads

Allow file uploads — when enabled, users can attach files to their messages. Specify which MIME types are accepted (e.g. image/png, application/pdf).

---

Web Search

Allow web search — when enabled, the agent can perform web searches as part of its response.

---

Response Mode

Choose how the workflow sends its reply:

• Streaming — the response is streamed back to the user as it is generated, word by word
• Complete — the full response is sent once the workflow finishes

---

Filters

• Filter keywords — only trigger the workflow when the message contains specific words or phrases
• Ignore bots — skip messages sent by automated bots or other agents

---

Activation

The trigger only processes live messages after the workflow is published.