Skip to main content

Rules & Limits

Understanding the rules and limits of chatbot flows helps you design effective conversations that work within the system's constraints.

WhatsApp message limits

These limits are set by WhatsApp and apply to all message types:

ComponentMaximum
Text message body4,096 characters
Interactive body1,024 characters
Interactive header (text)60 characters
Interactive footer60 characters
Interactive buttons3 buttons per message
Button label20 characters
List menu button text20 characters
List sections10 sections
List rows per section10 rows
List total rows30 across all sections
List row title24 characters
List row description72 characters
SPM products1 product
MPM products30 products across up to 10 sections

Flow structure rules

RuleDetails
One trigger per flowEvery flow must have exactly one Trigger node
Trigger must be firstThe Trigger node must be the starting point of the flow
No loopsConnections cannot create circular paths (A → B → C → A)
Flow names must be uniqueNo two flows can have the same name (case-insensitive)
Unique keywordsTwo active flows cannot share the same keyword
Unique button IDsTwo active flows cannot use the same button click trigger ID

Field limits

FieldMinimumMaximum
Flow name3 characters255 characters
Flow description1,000 characters
Version change summary500 characters

Node rules

RuleDetails
Trigger nodeCannot be deleted; every flow must have one
End nodeEvery path should end with an End node
Connected nodesAll nodes must be reachable from the trigger
Template messagesOnly approved templates can be used
HTTP Call timeoutConfigurable per node (set a reasonable timeout to avoid hanging)

Activation rules

RuleDetails
Version requiredFlow must have at least one saved version
Published versionOnly published versions can be activated
Keyword conflictCannot activate if keywords conflict with another active flow
Button ID conflictCannot activate if button ID conflicts with another active flow
Active conversationsCannot delete a flow with active conversations

Manual trigger limits

LimitValue
Contacts per triggerUp to 5 contacts per request
Marketing limitUp to 4 marketing messages per contact before blocking

Variable rules

RuleDetails
NamingLetters, numbers, and underscores only
Case sensitive{{Name}} and {{name}} are different
ScopeVariables exist only within a single flow execution
Empty variablesAppear as empty text in messages if not set

Permission requirements

ActionWho can do it
View flowsUsers with flow view permissions
Create/edit flowsUsers with flow edit permissions
Activate/deactivateUsers with flow management permissions
Delete flowsUsers with flow delete permissions
Trigger manuallyUsers with flow trigger permissions
View logsUsers with flow log permissions
info

Permission requirements depend on your organization's role configuration. Contact your administrator if you need access to specific features.