DocsICP FilingConsole
首页 Chat App Message Service User Guide Chat Flow Chat Flow components Triggers

Triggers

更新时间: 2026-06-04 19:37:23

An incoming message triggers a flow by default. You can also configure WhatsApp, Instagram, Messenger, or manual triggers.

Note

  • If the Trigger Type is WhatsApp, Instagram, or Messenger, you must bind the flow to a specific account as described in Message-based triggers.

  • A manual trigger starts the flow through a marketing campaign or API call. You can choose whether the flow accepts system variables from Intelligent Marketing. When a marketing campaign triggers a flow, an active conversation must exist within the last 24 hours between the end user and the sending account.

Procedure

Manual triggers

Configure a manual trigger to start a flow through an API call or marketing campaign.

  1. Log on to the Chat App Message Service console.

  2. In Chat Flow > Flow Management tab, click Create Flow and select Create on Blank Canvas.

  3. Set Trigger Type to Manual and configure the flow information.

    Specify a Flow Name and Description. Both are required.

  4. Configure Basic Settings to define initial variables for the flow in the start node.

    Click the Start node on the canvas. In the Basic Settings panel on the right, enter a Variable Name (required). Click Add variable to add more. Variables passed from the API or webhook must match the names defined here; otherwise, the flow discards them.

    • When Do Not Accept Incoming Variables is enabled, the flow rejects external variables and uses only custom variables defined within its components.

    • When Intelligent Marketing System Variable is enabled, the flow receives system variables from Intelligent Marketing. You can also define custom system variables.

    Intelligent Marketing system variables include groupId, marketingId, marketingInstanceId, customerPhoneNumber, and customerName. Click Add variable to define additional custom variables.

    Note

    To trigger a flow from a marketing campaign, the flow must be published and an active conversation must exist within the last 24 hours between the end user and the sending account.

    After publishing a manually triggered flow, click Test in the Actions column to open OpenAPI Explorer, where you can click the debug button to test the flow.

Message-based triggers

Configure a flow triggered by a mobile originated (MO) message. Bind the account when you create the flow, or modify the binding afterward. For more information about how to create a flow, see Create a flow.

Option 1: Bind on creation

Bind a WABA when you create a WhatsApp-triggered flow.

  1. Log on to the Chat App Message Service console.

  2. In Chat Flow > Flow Management tab, click Create Flow and select Create on Blank Canvas.

  3. Set Trigger Type to WhatsApp, configure the flow information, and specify the account name and number in the Bind Account section. Click OK to create the flow and bind the WABA.

    Note

    • A WhatsApp message trigger requires a WABA binding. You must provide a WABA name and phone number.

    • An Instagram message trigger requires an Instagram binding. You must provide an AccountId.

    • A Messenger message trigger requires a Messenger binding. You must provide a PageId.

Option 2: Modify configuration

Modify the trigger configuration for an existing WhatsApp-triggered flow.

  1. Log on to the Chat App Message Service console.

  2. In Chat Flow > Flow Management tab, find the target flow and click Settings.

  3. Modify the Bind Account information, then click OK to save the configuration.

    Specify the Account Name and Number.

    Note

    You cannot modify a published flow. To make changes, you can either temporarily unpublish the flow or create a copy and edit the new version.

上一篇: Use available variables 下一篇: Component library: Core