WhatsApp group “BBonca – DISPAROS”
WhatsApp campaigns: BBonca
Updated
send bbonca is a message you send in the “BBonca – DISPAROS” group. The system checks the command against the template approved by Meta, schedules the send for the date and time you give, and replies in the same group. This guide shows how to fill in the command to schedule a BBonca WhatsApp campaign. You give the template approved by Meta and choose the audience: a recipient list or the inactive customers.
Command: BBonca send command format
send bbonca
Template: approved_template_name
Campanha: teste_lista_bbonca
Arquivo: lista_teste.xlsx
Enviar em: 2026-11-20 10:30
oferta_principal: Combo da semana com 20% de descontoExample filled in with a recipient list. The value of oferta_principal stays in Portuguese because it goes into the message customers receive (it means “Combo of the week with 20% off”).
The system only recognizes the field names as written: Template:, Campanha: (campaign), Arquivo: (file), Enviar em: (send at) and the others on this page. Don’t translate them in the command.
The Arquivo: line decides who receives the campaign. With it, the campaign goes to your list. Without it, it goes to the inactive customers, up to 100 real customers.
Command for a list
send bbonca Template: name of the template approved by Meta Campanha: campaign name (optional) Arquivo: name of the list file Enviar em: YYYY-MM-DD HH:MM template_variable: value
Command for inactive customers
send bbonca Template: name of the template approved by Meta Campanha: campaign name (optional) Enviar em: YYYY-MM-DD HH:MM template_variable: value
Replace each highlighted part with the real value and send it in the “BBonca – DISPAROS” group. If you don’t want to name the campaign, delete the Campanha: line. The lines can go in any order. Each field appears only once, in the format Field: value. If the template has an image or a coupon, add the Imagem: (image) and Cupom: (coupon) lines.
Generator: campaign command generator
Fill in the fields and tap Generate command. The command appears right below the button. Copy it and send it in the “BBonca – DISPAROS” group.
Send this text in the “BBonca – DISPAROS” group. If you change a field, the command updates on its own.
Replies from the system in the group
Once the command arrives, the group gets three replies:
| Reply | What it contains |
|---|---|
| 1. Received | A notice that the command was recognized. |
| 2. Preparation | Campaign, audience, template and scheduled time. For a list, also the rows read, valid, invalid and duplicated. If something is wrong, you get the reason for the rejection. |
| 3. Final notice | How many messages were sent and how many failed, the reasons some were not sent, and the time the campaign finished. |
Before scheduling, the system reads the template you gave from Meta (whether it has an image, which variables it uses, whether it has a coupon and a button) and checks that the command matches it.
Fields of the send command
| Field | How to fill it in |
|---|---|
| send bbonca | First line, required. “bb onça” or “bb onca” also work. |
| Template | Required. Exact name of the template approved by Meta. |
| Enviar em | “Send at.” Required. Date and time of the send: 2026-11-20 10:30 or 20/11/2026 10:30 (day/month/year). It can’t be in the past. |
| Campanha | “Campaign.” Optional. If left out, it becomes campanha_bbonca_YYYYMMDD. |
| Arquivo | “File.” Optional, and it decides the audience. With it, the list receives the campaign. Without it, the inactive customers receive it.Forgot the line? The campaign goes to up to 100 real inactive customers. |
| Imagem | “Image.” Only if the template has an image. Name of a file in BBonca’s authorized folder. |
| Cupom | “Coupon.” Only if the template has a coupon. The coupon code. |
| variable: value | One line for each variable the template asks for. Write the name exactly as it is in Meta, letter by letter, including upper and lower case. E.g.: oferta_principal: Combo da semana. The nome (name) variable is filled in automatically. |
BBonca has no Loja: (store) field. If it appears, the command is rejected.
List of recipients
With Arquivo:, you choose who receives the campaign.
| File | Rule |
|---|---|
| Location | BBonca’s authorized folder, the same one used for images. |
| Format | .xlsx or .csv. |
| Columns | The first row is the header: nome (name) in the 1st column and telefone (phone) in the 2nd. |
| Phone | With the area code (DDD), with or without the 55 country code in front. |
| In the command | Just the file name, no folder. |
Rows with no name or with an invalid phone number are dropped. Repeated phone numbers count only once.
People who asked to stop getting BBonca messages (opt-out), people protected by the control group and, if you use the field below, people who got a promotion less than N days ago.
| Optional field | Rule |
|---|---|
| Dias mínimos entre envios | “Minimum days between sends.” Removes from the list anyone who got a promotion less than N days ago. It must be greater than zero. Without the field, nobody is removed for the interval. |
Inactive: campaign for inactive customers
To reactivate customers who stopped buying, use the command without the Arquivo: line. With the defaults, it includes customers with 30 to 120 days without a purchase, up to 100 customers:
send bbonca Template: approved_template_name Enviar em: 2026-11-20 18:00 oferta_principal: Volta pra Toca com 15% de desconto
The oferta_principal value goes to customers in Portuguese. It means “Come back to the Toca with 15% off”.
| Optional field | Rule |
|---|---|
| Dias mínimos sem compra | “Minimum days without a purchase.” Default: 30. |
| Dias máximos sem compra | “Maximum days without a purchase.” Default: 120. It must be equal to or greater than the minimum. |
| Limite | “Limit.” Maximum number of customers. Default: 100. It must be at least 1. |
| Prefixo telefone | “Phone prefix.” Default: 5517. You usually don’t need to change it. |
Example choosing the audience: 60 to 90 days without a purchase, up to 50 customers.
send bbonca Template: approved_template_name Campanha: reativacao_60_90 Dias mínimos sem compra: 60 Dias máximos sem compra: 90 Limite: 50 Enviar em: 2026-11-20 18:00 oferta_principal: Volta pra Toca com 15% de desconto
With the defaults, that is up to 100 real customers. Check the audience in the preparation reply before the send time.
Rules for sending and protections for inactive customers
The inactive-customer audience is built on the send date. A delay in the queue doesn’t change who receives the campaign.
The system applies these rules on its own. They don’t go in the command: a minimum wait of 30 days, a 15-day recycling period, at most 4 attempts in 30 days, opt-out (people who asked to stop) and engagement.
Sending the same command twice doesn’t create a second campaign.
If everyone is blocked, the campaign ends with a failure: “Sem destinatários elegíveis” (no eligible recipients).
Rejections: reasons the command is rejected
When the command is rejected, the group gets the reason and nothing is scheduled. Fix it and send it again.
Template:orEnviar em:is missing.Enviar em:is in the past or in a format the system doesn’t recognize.- The template doesn’t exist in Meta or isn’t approved.
- A variable the template asks for is missing, or there is an extra one it doesn’t use.
- An image or a coupon was given, but the template doesn’t use it.
- The image or the list file isn’t in BBonca’s authorized folder.
Arquivo:has a path (folder) instead of just the name.Loja:orLojas:was used.Dias mínimos entre enviosis zero, negative, unreadable, or was used in inactive-customer mode.- The days without a purchase or
Limiteare not numbers, the day range is reversed, or the limit is less than 1.
After sending: what to check
Read the preparation reply before the send time and check:
- the audience: list or inactive customers;
- the template and the scheduled time;
- for a list, how many rows were valid.
After the send, the final notice shows how many messages went out and how many failed.