MeContaí

Documentation

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 desconto

Example 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”).

Field names stay in Portuguese

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.

Choose the audience before you copy

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.

Who is the campaign for?
Exact name of the template approved by Meta.
If left blank, it becomes campanha_bbonca_YYYYMMDD.
Only if the template has an image. Name of the file in BBonca’s authorized folder.
Only if the template has a coupon. The coupon code.
One per line, in the format name: value. Use the exact name from Meta, with the same upper and lower case. The nome (name) variable is filled in automatically.

Replies from the system in the group

Once the command arrives, the group gets three replies:

ReplyWhat it contains
1. ReceivedA notice that the command was recognized.
2. PreparationCampaign, 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 noticeHow many messages were sent and how many failed, the reasons some were not sent, and the time the campaign finished.
Checked against the template

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

FieldHow to fill it in
send bboncaFirst line, required. “bb onça” or “bb onca” also work.
TemplateRequired. 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: valueOne 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.
Single store

BBonca has no Loja: (store) field. If it appears, the command is rejected.

List of recipients

With Arquivo:, you choose who receives the campaign.

FileRule
LocationBBonca’s authorized folder, the same one used for images.
Format.xlsx or .csv.
ColumnsThe first row is the header: nome (name) in the 1st column and telefone (phone) in the 2nd.
PhoneWith the area code (DDD), with or without the 55 country code in front.
In the commandJust the file name, no folder.

Rows with no name or with an invalid phone number are dropped. Repeated phone numbers count only once.

Not sent, even if they are on the list

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 fieldRule
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 fieldRule
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
Without the Arquivo line, the campaign goes to inactive customers

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.

Fixed protections for inactive customers

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.

Repeated command

Sending the same command twice doesn’t create a second campaign.

Nobody eligible

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: or Enviar 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: or Lojas: was used.
  • Dias mínimos entre envios is zero, negative, unreadable, or was used in inactive-customer mode.
  • The days without a purchase or Limite are 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.