Blocks Overview
Understand how blocks run inside an automation step.
Blocks are actions performed by a funnel. They can send a message, update client data, call an external API, route a chat, store a value, or stop a run.
How a Step Runs
When a funnel enters a step, GChat runs its blocks from top to bottom.
- The first block starts.
- When it completes, the next block starts.
- Processing continues until the last block or a stop block is reached.
- GChat then evaluates the step's outgoing triggers.
Drag blocks in the inspector to change their order. Order matters whenever one block prepares data for another. For example, put Set variable before an HTTP request that reads that variable.
Choose a Block
| Goal | Block |
|---|---|
| Send text to the client | Send text |
| Send one or more files, optionally with text | Send media + text |
| Send a voice recording | Send voice |
| Send a round video message | Send video note |
| Add or remove client segmentation | Add client tags / Remove client tags |
| Save a value on the client | Change custom field |
| Assign the conversation | Transfer to operator |
| Store temporary run data | Set variable |
| Call another service | HTTP request |
| End this run | Stop automation |
| Cancel selected parallel funnels | Stop funnels |
Message Blocks
Send text, media, voice, and video notes.
Client and Routing
Update tags, fields, variables, and assignments.
HTTP Request
Configure methods, parameters, headers, and request bodies.
Flow Control
Stop the current run or selected funnels.
Add and Configure a Block
- Select a step on the canvas.
- In the inspector, click Add block or trigger.
- Choose an item from Blocks.
- Open the block card and complete its required fields.
- Drag the block to the required position in the step.
- Open Checklist and resolve any errors.
- Click Save.
Use a block's actions menu to rename or delete it. Renaming changes the label shown in the builder and does not change the action type.
Expressions in Blocks
Text, variable values, and HTTP request fields can insert runtime data with expressions.
Hello, {sys.client.name}!Use autocomplete in an expression field to select available system, funnel, and environment variables. See Expression Language for syntax and functions.
Validation
The builder prevents saving when a required block value is missing or an expression is invalid. The checklist links each error to the affected step and block.
An unconnected outgoing trigger is a warning rather than an error. The funnel can be saved, but that branch ends after the step finishes.