Bulk Operations
Run scheduled or manual actions for filtered client groups.
Bulk Operations let you apply actions to many clients at once.
Use them to send messages, assign or remove tags, mark chats as read, or transfer chats for a filtered group of clients.
Bulk Operations Page
The Bulk Operations page shows every created bulk run.
| Column | Description |
|---|---|
| Date | The date when the bulk operation was created or executed. |
| Status | Current lifecycle state, such as Draft, Ready, Scheduled, Running, Completed, Failed, or Canceled. |
| Clients / Chats | Number of client and chat targets in the operation snapshot. |
| Items | Processing counters for the selected clients. |
| Actions | The actions configured for the operation, such as Send message. |
Item Counters
Each operation shows detailed item counters.
| Counter | Meaning |
|---|---|
| Processing | Items that are still being processed. |
| Processed | Items that were processed successfully. |
| Item errors | Items that failed before the configured action could be completed. |
| Sent | Messages or action results sent successfully. |
| Send failed | Messages that could not be sent. |
| Skipped | Items skipped by the operation rules. |
Use these counters to understand whether the operation finished cleanly or needs review.
Create a Bulk Operation
- Open Bulk Operations.
- Click Create Bulk Operation.
- Configure the Filters tab.
- Configure the Actions tab.
- Click Create.
Creating the record saves its filters and actions. An immediate operation must build a recipient snapshot before it can run. A scheduled operation builds and runs at the configured time.
Operation Lifecycle
| Status | What you can do |
|---|---|
| Draft | Edit or delete the operation, then click Build Snapshot. |
| Ready | Review the target count, run the operation, or delete it. |
| Scheduled | Wait for the configured time, edit it, or cancel it. |
| Running | Monitor counters or cancel the remaining work. |
| Completed | Review processed, sent, failed, and skipped results. |
| Failed | Review the counters and configuration before creating a corrected run. |
| Canceled | No new items are processed. Review any items completed before cancellation. |
The snapshot fixes the recipient set for an immediate run. If the subscription recipient limit truncates it, GChat shows a warning.
Filters
Filters define which clients will be included in the operation.
Schedule Bulk Run
Enable Schedule bulk run when the operation should run automatically at a selected local time.
When scheduling is enabled, set:
| Field | Description |
|---|---|
| Run date | The date when the operation should run. |
| Run time | The local time when the operation should run. |
| Time zone | The time zone used for the scheduled run. |
Example:
| Field | Value |
|---|---|
| Run date | 09.07.2026 |
| Run time | 09:00 |
| Time zone | Europe/Moscow (UTC+3) |
Client Creation Date
Use Created Clients At From and Created Clients At To to include only clients created during a specific date range.
| Field | Description |
|---|---|
| Created Clients At From | Start date for client creation. |
| Created Clients At To | End date for client creation. |
Leave these fields empty if the operation should not filter by client creation date.
Last Message Date
Enable Use Last Message Date to filter clients by the date of their latest message.
Use this when you want to target clients who were recently active, inactive for a period, or last contacted during a specific time window.
Tags
Use tag filters to include or exclude clients.
| Field | Description |
|---|---|
| Include All Tags | Include only clients that have the selected tags. |
| Exclude Any Tags | Exclude clients that have any of the selected tags. |
Tag filters are useful for avoiding repeated outreach or targeting a specific client segment.
Integrations
Use Integrations to include clients from selected connected channels or sources.
Leave it empty if the operation can include clients from any integration.
Changing filters or actions on a scheduled operation returns it to a draft state and requires a new snapshot.
Actions
Actions define what the bulk operation will do to the filtered clients.
Click Add action to add another action. Use the delete icon to remove an action before creating the operation.
Available action types:
| Action | Description |
|---|---|
| Assign client tags | Add selected tags to matching clients. |
| Remove client tags | Remove selected tags from matching clients. |
| Mark chat as read | Mark matching client chats as read. |
| Transfer chat | Transfer matching chats to a selected staff member. |
| Send message | Send a message to matching clients. |
Send Message Action
Choose Send message when the operation should send a message to every matching client.
The message editor supports text and attachments. Use it for announcements, follow-ups, reminders, or reactivation campaigns.
Bulk message text can use message variables to personalize each message with client, chat, operator, or custom field data.
Example:
Hello {client.name}, your client ID is {client.id}.When the operation sends the message, GChat replaces the variables separately for each matched client.
Before creating the operation, check:
- The message text is correct.
- Attachments are added if needed.
- Filters match only the intended clients.
- The operation is scheduled only if it should run later.
Recommended Workflow
- Start with a narrow filter.
- Review the expected client segment.
- Add one action first.
- Use scheduling only when timing matters.
- Build the snapshot and check the target count before an immediate run.
- Click Run Operation only after the audience and actions are correct.
- After the run, check Processed, Sent, Send failed, and Skipped counters.
Best Practices
- Use tag filters to avoid sending the same message to the same clients repeatedly.
- Schedule large operations during a predictable working window.
- Keep bulk messages short and clear.
- Test a new message on a small segment before running it for a large audience.
- Review failed and skipped items after every important operation.
- Avoid combining too many actions in one operation unless the workflow is already tested.
Troubleshooting
Operation Has Send Failures
Check whether the target integration is active and whether clients can receive messages through that channel.
Operation Skipped Items
Skipped items usually mean the client did not match the final rules or the selected action could not be applied.
Wrong Clients Were Included
Review the filters, especially tags, integration, client creation dates, and last message date.
Scheduled Operation Did Not Run at the Expected Time
Check the selected run date, run time, and time zone.