For the complete documentation index, see llms.txt. This page is also available as Markdown.

Inbound

Overview

The WhatsApp Incoming Messages Trigger is an input node (inbound trigger) based on communication events. Its main function is to listen to active communication channels and trigger an automation flow or chatbot instantly when a customer sends a new message.

Service Retention Rule: The trigger has native state-control intelligence. It will only start the automation if the customer in question does not have any human support or ticket already open in the system. If the customer is already being served by an operator, the messages they send will continue straight to the agent's screen, ignoring this trigger to avoid interruptions or loops in the human conversation.

Configuration Parameters

The trigger configuration links the automation to the company's official phone line or communication channel using the following criterion:

  • Channel: Dropdown menu used to select which phone number or official WhatsApp API will be monitored by this specific flow. The component scans the integrated accounts in the platform panel to make them available in the selector.

Visual Builder

The graphical interface is designed for quick and secure coupling, isolating the starting point of the journey:

  • Validated Instance Selectors: The dropdown displays the connection codenames and their respective international phone numbers (e.g.: Connection Name (+55 11 99999-9999)), allowing the production or testing number to be easily associated with the automation.

  • Initial Node Without Input: In the graphical flow editor, this component is positioned at the far left edge of the screen. It has no input connectors, since the energy that starts its execution comes exclusively from an external stimulus (the message sent by the end user).

Special Operators

The logical properties of this component handle session control, insertion of registration data, and media handling:

  • Contact Payload Injection (Native Data): As soon as the triggering message is received, the trigger engine automatically captures the public data made available by the customer's WhatsApp profile, such as the Phone Number and the Display Name (PushName), making these variables immediately available to the next blocks in the flow.

  • Opening the Session Window (24-hour window): Successful activation of this component validates and opens the WhatsApp API conversation window. This ensures that subsequent message blocks in the automation can send texts, media, and interactive buttons without the cost of pre-approved templates (session messages).

Practical Examples

The table below demonstrates classic scenarios of how this trigger behaves according to the user's current status in the system:

Selected Channel

Customer Status in the System

Customer Action

Trigger Behavior

Main Business WhatsApp

No active support cases (New or Closed).

Sent a "Hello, good afternoon!".

Triggers the flow: The trigger captures the contact and starts the self-service chatbot menu.

Technical Support WhatsApp

Being served by Operator Carlos.

Sent a photo of the receipt.

Ignores the trigger: The image goes straight to Carlos's screen; the automation does not interfere with the conversation.

Headquarters Sales WhatsApp

Waiting in the Sales Department's queue.

Sent "I want to speak to someone".

Ignores the trigger: The contact remains in the human panel's waiting queue, maintaining arrival priority.

Last updated

Was this helpful?