Description
Chat App Brasil is the most complete WhatsApp plugin for WooCommerce. Connect your store to WhatsApp and send automatic messages to your customers at every step of their journey — from new order to post-sale follow-up.
Messages are sent through the ChatApp Brasil platform, which connects to your store’s own WhatsApp number by QR code. A ChatApp Brasil account is required (paid service) — start with a free 7-day trial, no credit card. The plugin itself is free and has no locked features: everything below works with any ChatApp Brasil plan.
Free 7-day trial
No account yet? Click Start free 7-day trial in the plugin (or go to chatappbrasil.com), confirm your WhatsApp with a code and your account is created on the spot. No credit card. If you don’t subscribe, the trial account is paused at the end of the 7 days — your settings stay saved.
Why Chat App Brasil?
- ✅ WhatsApp + WooCommerce native — no complex setup
- ✅ Floating WhatsApp button with click tracking and full customization
- ✅ Abandoned cart recovery via WhatsApp — built-in capture (popup after add to cart + checkout phone), no extra plugin needed. CartBounty Free & Pro still supported
- ✅ Sell over WhatsApp with the AI — catalog, shipping quote and a cart link that opens the store’s checkout (with XMetric Whats)
- ✅ PIX via WhatsApp — automatic QR code (Mercado Pago & Asaas)
- ✅ Order tracking — Correios and Melhor Envio
- ✅ WooCommerce Subscriptions — renewal and cancellation notifications
- ✅ Back In Stock — notify customers when a product is available again
- ✅ HPOS compatible — WooCommerce 7.1+
Main Features
Automatic Order Notifications
Each WooCommerce status triggers a personalized message to the customer and
optionally to the administrator. Individual toggle per notification — message
is preserved even when deactivated. Supported statuses: new order, pending,
on-hold, processing, completed, cancelled, refunded, failed, order note,
custom statuses.
Payments Tab — Mercado Pago PIX
Automatic QR code and copy-and-paste code delivery. Two modes:
* Immediate: sends in real time
* Reminder: sends only if not paid after X minutes (cancels if paid before)
* PIX expired notification: alerts the customer when time expires
Payments Tab — Asaas PIX
Full integration with the Asaas gateway for PIX payments.
Same immediate/reminder options. QR code + copy-and-paste code.
Payments Tab — Asaas Boleto
Automatic delivery of the boleto link when an Asaas Boleto order is created.
Use %boleto_url% in the message to include the link.
Payments Tab — PIX Expired
Unified notification for Mercado Pago and Asaas when PIX expires without payment.
Configurable delay in minutes after PIX generation.
Tracking Tab — Correios, Melhor Envio or a typed code
Automatic notification when the order enters the chosen statuses (default: Completed) and a tracking code is available.
The code comes from what the store types on the order (with carrier and own link), WooCommerce Correios or Melhor Envio.
Tags: %tracking_code%, %tracking_url%
Abandoned Cart Recovery
Up to 3 follow-ups, configurable interval per step. The built-in capture saves the phone from an optional popup shown after add to cart, or from the checkout phone field (works with any theme: auto-detect or click to pick the field). Reminders carry a %cart_link% that reopens the cart with the phone already filled in. CartBounty Free or Pro keep working if you prefer them.
Tags: %billing_first_name%, %billing_name%, %billing_phone%, %cart_items%, %cart_count%, %cart_total%, %cart_date%, %cart_time%, %cart_link%, %cart_stop%, %cart_coupon%, %cart_coupon_value%
Independent toggle per follow-up.
Aftersales
Automatic message X hours after order completion.
Back In Stock
WhatsApp notification when a product returns to stock.
Easy Digital Downloads (EDD)
New order and completed order notifications for digital products.
Contact Form 7 / Caldera Forms
Messages triggered via contact forms with tag substitution, line breaks preserved.
Floating WhatsApp Button
Position, size (40-200px), horizontal and vertical offset (0-200px),
pulse effect, tooltip, pre-filled message, hide on mobile or desktop, hide on pages.
Click Counts
Button clicks today, in the last 7 days and in total (IP stored hashed, records deleted after 90 days).
Message Logs
Statistics cards (sent, errors, dedup), filters (errors only, deduplicated, type), search, expandable rows with order link,
resend of the message and bulk resend of what failed after an outage.
Private Order Notes
Automatic note on every WhatsApp send with status, number, and resend link.
Security
Configurable deduplication, per-minute limit with a queue, anti-ban spacing, sending-hours filter (outside the window
the message waits for the next allowed time), notice and e-mail when sending fails, API errors in friendly language.
HPOS Compatibility
Fully compatible with WooCommerce HPOS (7.1+).
Available Tags
Order
%id%, %order_key%, %order_date%, %order_time%, %order_link%, %order_status%,
%product%, %product_name%, %order_subtotal%, %order_shipping%, %order_total%,
%order_discount%, %currency%, %cust_note%, %shipping_method%,
%payment_method_title%, %payment_url%
Customer
%billing_first_name%, %billing_last_name%, %billing_email%, %billing_phone%,
%billing_city%, %billing_state%, %billing_address_1%
Shipping
%shipping_first_name%, %shipping_address_1%, %shipping_city%, %shipping_state%
Tracking
%tracking_code% — tracking code (Correios or Melhor Envio)
%tracking_url% — tracking link
Payments
%pix_code% — PIX copy-and-paste code (Mercado Pago or Asaas)
%boleto_url% — boleto link (Asaas)
%payment_url% — pending payment link
Other
%shop_name%, %note%
Spintax: {Hello|Hi|Hey} — random variation per send
External services
This plugin connects to the following external services. Nothing is sent before you configure the corresponding feature.
- ChatApp Brasil (dashboard.chatappbrasil.com) — sends the WhatsApp messages. When a notification or a test is sent, the customer’s phone number, the message text and, when configured, an image URL are sent to the platform with your token. Terms · Privacy
- ChatApp Brasil free trial (chatappbrasil.com) — only when an administrator clicks “Start free 7-day trial”, the store address (site URL) is passed in the link so the signup form comes pre-filled. Terms · Privacy
- XMetric Whats (whats.xmetric.com.br, or the address you enter) — only when you choose XMetric Whats as the sending provider or turn on selling over WhatsApp: the same message data as above, plus the order/cart data needed to finish a sale started in the conversation. Service site: https://whats.xmetric.com.br
- Melhor Envio (app.melhorenvio.com.br) — only when you enter a Melhor Envio token: the Melhor Envio shipment IDs of your orders are sent to fetch tracking codes. Service site: https://melhorenvio.com.br
Installation
- Plugins > Add New > Upload Plugin > select the .zip
- Activate the plugin
- No ChatApp Brasil account yet? Click Start free 7-day trial (no credit card)
- Chat App Brasil > Settings > paste the token of your connection and click Test Connection
- Configure messages in Notifications, Payments, Tracking, and other tabs
FAQ
How do I send automatic WhatsApp messages in WooCommerce?
Configure your token in Chat App Brasil > Settings and set your messages in Chat App Brasil > Notifications. WhatsApp messages are sent automatically on every order status change.
Can I send the PIX QR code via WhatsApp?
Yes. The plugin integrates with Mercado Pago PIX and Asaas PIX. The QR code is automatically sent as an image with the copy-and-paste code when the order is created.
Do I need a paid account?
Yes. The plugin is free, but sending requires a ChatApp Brasil account. You can try it free for 7 days, without a credit card, from the plugin or at chatappbrasil.com.
Does it work with WhatsApp Business?
Yes. You connect a WhatsApp or WhatsApp Business number by reading a QR code in the ChatApp Brasil dashboard. It is not the official WhatsApp Business Platform (Cloud API): there are no per-message fees or template approvals, and automated messages follow WhatsApp’s own usage limits — use the anti-ban settings (spacing, hours window, rate limit).
How does abandoned cart recovery via WhatsApp work?
Turn on your follow-ups in the Abandoned Cart tab. With no other plugin, Chat App Brasil captures the phone itself (popup after add to cart and the checkout phone field) and sends the reminders with a link that reopens the cart. If CartBounty Free or Pro is installed, it is used instead, unless you choose the built-in capture.
Can I send tracking codes via WhatsApp?
Yes. When the order enters the statuses chosen in the Tracking tab (default: Completed) and has a code — typed in the order box, from WooCommerce Correios or from Melhor Envio — the plugin sends the code and link automatically.
The button does not appear
Fill in the phone number in Chat App Brasil > WhatsApp Button.
Messages not sending
Confirm the Access Token, check the Logs, ensure the message is not empty.
Check whether the panel header shows “Sending is failing”: the red strip gives the reason.
Asaas PIX not sending
Ensure the WooCommerce Asaas plugin is active and the order payment method
is “asaas-pix”. The __ASAAS_ORDER meta must be saved.
Tracking notification not sending
Check that the order status is ticked in “When to look for tracking” and that the order has a code:
type it in the order’s “📦 WhatsApp tracking” box or use WooCommerce Correios / Melhor Envio (with the API token
the plugin fetches the code by itself).
“Sending is failing” showing
WhatsApp was disconnected or the subscription expired. The strip at the top of
the panel says which one and shows the right button: reconnect at
dashboard.chatappbrasil.com or renew the subscription. Sending resumes on its
own, and the panel offers to resend what failed in the meantime.
Is the panel available in English?
Yes. Any site that is not in Portuguese gets English automatically. Portuguese
sites are unchanged.
Changelog
3.9.4
- FIX: made-up phone numbers at checkout, in the cart or in a form triggered “Sending is failing — Your WhatsApp was probably disconnected”, with an email, while nothing was broken. The platform also answers “internal error” for numbers that don’t exist; that error now only counts against the store on a number that has already received a message from it
3.9.3
- FIX: saving Notifications cut the abandoned cart tags — %cart_link%, %cart_items%, %cart_total%, %cart_coupon% and the other %cart_…% tags became “rt_link%” and so on, so reminders went out without the link, items or coupon (also %date% in EDD and texts such as “20%de”). Messages already saved this way are repaired automatically on update
- FIX: the external reminder scheduler (?wlp_agendador=) stopped with a fatal error when there was a recent paid order; it now runs after WooCommerce has loaded
- FIX: the reminder coupon was rejected on the block checkout (“enter a valid email…”) and disappeared on reload; it is now applied through the link on both classic and block checkout, still only valid through the link
- FIX: the phone field added to the Easy Digital Downloads checkout was always in English; it now follows the site language
- FIX: Contact Form 7 and Caldera Forms sends showed up in Logs as “Order”; they now show as “Form”, with the form name as origin, and go out right away instead of following the orders’ sending window
- FIX: “Chat App Brasil” appeared twice in the WordPress privacy policy guide
3.9.2
- FIX: abandoned cart reminders with the switch off were still sent when they had text (CartBounty Free and Pro). A reminder that is off is now skipped and the next one goes out at its own time; an empty reminder no longer holds the following ones back
- NEW: “See which” in the “Sending is back” bar lists the messages that failed — when, to whom, origin with the order link, reason and the start of the text — before you resend them
- IMPROVED: the reminder and Back In Stock headers show “○ Off” when there is text but the switch is off (they used to say “● Active”)
3.9.1
- NEW: free 7-day trial (no credit card) offered where it helps: the locked Notifications and Logs screens, Overview, Settings and the setup notice — only while no valid token is connected
- NEW: setup notice can be snoozed for 7 days or hidden for good, per administrator; it now shows only on Dashboard, Plugins and WooCommerce screens
- IMPROVED: when the trial or subscription ends, the notice says so and leads to the plans page (subscribers keep a “renew” link)
- FIX: readme no longer calls the integration “official” or the connection “WhatsApp Business API”; the account requirement and the external services are documented
3.9.0
- NEW: built-in abandoned cart capture — CartBounty is no longer required. Mode: automatic (built-in when CartBounty is not installed), always built-in, or always CartBounty
- NEW: optional popup after add to cart, anchored to the clicked button with an arrow (opens above or below depending on space; bottom panel when the button is off screen). Never blocks the purchase: fill it in or close it, the product is already in the cart. On/off switch, editable texts, reappear interval
- NEW: phone captured at checkout as soon as the customer leaves the field (classic and block checkout, Brazilian Market cellphone). Works with any theme: auto-detect, or click “Pick by clicking on checkout” and click the field
- NEW: phone input mask by country (Brazil, Portugal, US, Canada, Mexico, Argentina, Colombia, Chile, Peru, Uruguay, Paraguay, Spain, Italy, France, Germany, UK), chosen in the settings; any other country works without a mask. At checkout the country of the customer’s address is used, and a number typed with + is read as international
- NEW: the settings show which cart plugin was found (CartBounty Pro/Free, active or deactivated), who is saving carts now and why, and what will be used after saving
- NEW: one cart per customer: coming back in the same browser updates the saved cart instead of creating another; a cart emptied and refilled reopens; a new cart started after a purchase is tracked with the same number; leaving the number on another device keeps only the newest cart
- FIX: on PHP 7.4 to 8.1 the plugin stopped with a fatal error (“Traits cannot have constants”) since the WhatsApp sale and order lookup features; constants moved out of the traits
- FIX: with more than 20 open carts, new carts waited for older ones before getting their first reminder
- IMPROVEMENT: tracking box on the order (“📦 WhatsApp tracking”): the typed code is now saved in its own field and always wins over the automatic ones (before, WooCommerce Correios won and the Melhor Envio plugin overwrote the typed code when generating the label); carrier picker — Correios, Melhor Rastreio or other carrier with its own link using {codigo} — guessed from the code format until the store picks one; shows the automatic code and when the customer was notified; saving the same code again does not resend
- FIX: the tracking box and the “Resend WhatsApp” buttons were not translated
- FIX: %tracking_code%/%tracking_url% and the order lookup use the same resolver as the tracking message; the order lookup now reads the Melhor Envio token from the right place
- FIX: the Admin notification, New order, Order note, Expired PIX and Back In Stock switches now work — the message used to go out even when switched off
- FIX: outside the allowed hours the message waits in the queue and goes out at the start of the next window — it used to be dropped (after-sales and Back In Stock were lost). The “PIX payments” and “Tracking” sending-hours options now work
- FIX: saving Notifications no longer deletes the messages of integrations whose plugin is inactive (Back In Stock, Mercado Pago/Asaas, Subscriptions)
- FIX: amounts (%order_total%, %product%…) in the store format (189,90); a tag with no value disappears instead of staying written, without leaving “Hi !”; a stray “%” in the text no longer breaks the following tags
- FIX: Back In Stock “Send the product photo” can be turned off; the EDD checkout only requires a phone when the field shows; EDD %product% with real line breaks
- FIX: custom statuses also trigger when the change comes from a gateway, webhook or API; status switches with a hyphen in the name now work
- FIX: after-sales delays above 14 days now fire
- IMPROVEMENT: in the log, “↺ Resend this message” resends exactly the clicked row (with or without an order); resending from the order says it sends the current status message. The tracking box gets “↺ Resend tracking”
- IMPROVEMENT: failure and connection notices translated; correct image limit (2 MB); “Failing” badge instead of “Paused”; tracking counted as tracking on the Overview
- FIX: numbers typed with + are no longer prefixed with the store’s country code when sending
- NEW: cart message tags %billing_name% (full name), %cart_items% (one line per item with quantity and price), %cart_count%, %cart_date% and %cart_time% (when the cart was saved); %billing_phone% is now formatted like (11) 9 8285-6700, without the country code for local numbers
- FIX: %cart_total% is the plain number in the store format (189,90) in both capture modes, so “R$ %cart_total%” never shows the symbol twice
- NEW: phone numbers in the carts list are shown formatted, without the country code for local numbers
- NEW: optional consent (off by default): the popup shows a consent line with a link to the privacy policy, and checkout shows a checkbox (official WooCommerce field on classic and block checkout); the phone is only saved when it is ticked. While it is off, the settings warn about privacy-law and number-ban risks
- NEW: unsubscribe: %cart_stop% tag with a link that stops the reminders for that number, and an option (off by default) to add it to the end of every reminder. Checkout respects the request; leaving the number again in the popup counts as a new request
- NEW: personal data requests: saved carts show up in Tools → Export/Erase Personal Data (matched by e-mail and the phones on that customer’s orders), plus suggested privacy policy text
- NEW: reminder coupon (off by default): %cart_coupon% creates a single-use coupon for that cart with a set validity, %cart_coupon_value% shows the discount, the reminder link applies it, and expired unused coupons are deleted daily. The coupon only works when applied through the reminder link (typed by hand it is rejected, so it cannot be passed on), and each phone gets at most one coupon per configurable period (30 days by default); without a coupon, the message line with %cart_coupon% is removed
- NEW: external scheduling: a secret URL for the hosting cron or a free service (cron-job.org) to run reminders every 5 minutes regardless of visits; site visits keep working as a backup, with a lock against double runs. Settings show the last run, where it came from, and warn when reminders are late or WP-Cron is disabled
- IMPROVEMENT: “Recovered” is now “Bought after a reminder”, with a note that it includes people who would have bought anyway
- NEW: %cart_link% tag — reopens the saved cart and goes to checkout with phone, name and e-mail filled in
- NEW: Overview card with the popup funnel (shown, filled in, closed without filling, ignored) and captured, reminded and recovered carts with the recovered revenue
- NEW: Logs → Abandoned carts lists every saved cart: when it was saved and last changed, source, each of the 3 reminders as sent (with time), scheduled (approximate time), turned off or won’t be sent, whether the link was opened, and the order number and value
- NEW: popup and panel texts in Portuguese and English
- IMPROVEMENT: a cart with an empty name no longer produces “Hi !” — spaces left before punctuation by empty tags are removed
- PRIVACY: saved carts are deleted after a configurable number of days (default 30); uninstall drops the table unless “keep data” is on
3.8.0
- NEW: redesigned panel with its own side menu, a header showing the sending status, and the site’s colours. Fields and options are unchanged
- NEW: Overview screen — sending status, messages in the last 7 days (sent, failed, duplicates blocked, queue), active automations and latest messages
- NEW: error strip in the header of every screen when sends are failing, with the reason and the right button (reconnect or renew the subscription)
- NEW: on every message — tag buttons, emoji picker, “Use template” with ready-made text, a preview of what the customer receives and “Send a test to me”
- NEW: unsaved-changes notice with a single “Save changes” button on every screen, and a confirmation when saving Notifications
- NEW: First steps on the Overview — connect the store, send a test and turn on the main automations with ready-made messages
- NEW: Logs — quick “Errors only” and “Deduplicated” filters, and bulk resend of what failed because of connection or subscription in the last 24 hours (50 at most, through the anti-ban queue)
- NEW: when sends recover after an outage, the panel offers to resend what failed meanwhile
- NEW: shop managers can open the Overview and the Logs. Settings, Notifications and Button remain admin-only
- IMPROVEMENT: tabs for integrations whose plugin is not installed are hidden in Notifications, one click away
- IMPROVEMENT: the Tags and Spintax cards no longer repeat on every tab; they live on the Tags tab
- IMPROVEMENT: the “Sends paused” notice is now “Sending is failing” — the plugin never paused sends, and the notice clears itself on the first successful send
- FIX: the “Screen corner” selector of the WhatsApp Button showed stray radio buttons next to the options
- NEW: English panel — screens, notices, alert e-mails and ready-made messages. Any site that is not in Portuguese gets English automatically; Portuguese sites are unchanged
- NEW: on activation the plugin opens the Overview, where the first steps are
- NEW: notice in the WordPress dashboard while the store is not connected (no validated token). It clears itself once the token is validated and can be dismissed
- NEW: Settings → When uninstalling the plugin — choose between deleting everything (default) or keeping settings, log and tables for a reinstall
- IMPROVEMENT: uninstall now also removes scheduled tasks, the per-form WhatsApp settings and leftover helper options
- IMPROVEMENT: on the plugin screens the WordPress menu opens collapsed, so the panel gets the full width. Other screens are unchanged
- FIX: the “Locked feature” notice on the Abandoned carts tab was clipped at the top and bottom
- The plugin’s readme.txt is now in English, which is what WordPress.org displays; the Portuguese version lives in readme-pt_BR.txt
- The Settings screen moved (page=wlp-config). The old address opens the Overview
3.7.2
- FIX: an expired subscription showed up as “Your WhatsApp was probably disconnected”, with the raw ERR_SUBSCRIPTION_EXPIRED code and a reconnect link. The notice now says the subscription expired and links straight to renewal
- IMPROVEMENT: the expired-subscription notice appears on the first refused send, without waiting an hour of failures, and clears itself on the first successful send after payment
- FIX: the failing-sends notice now counts three consecutive failures. It used to depend on two failures one to two hours apart, so low-volume stores were never warned
- FIX: invalid numbers, contacts that blocked the store and rejected images no longer count as a sign of a disconnected WhatsApp
- FIX: in Notifications, typing a message did not unlock its switch. It only became clickable after saving, and the message was stored switched off. It now turns on while typing and saves as active
- NEW: alert e-mail when messages stop going out (WhatsApp disconnected or subscription expired), once per incident. Sent to the WordPress admin or to the addresses set in Settings → Alert e-mail
- IMPROVEMENT: Test Connection answers “subscription expired” instead of “invalid token” when the plan is the problem
3.7.1
- FIX: Sell over WhatsApp — catalog search required every word to be in the product (“cartridge artpig box 1007RL” found nothing if “box” was not in the name). Each word now also searches on its own, and results are ranked by how well they match the request
- FIX: a product with many sizes filled the answer with the first ones, and the requested size was left out even when in stock. The size matching the requested code (1007RL) comes first, and the whole code decides: 1007RL does not match 1007MG
- NEW: each catalog product carries the store’s category (cartridge, needle, ink…), so the AI does not guess the type from the name
- NEW: a requested size that exists but is out of stock comes back as “out of stock”, so the AI says “that one is out” instead of “we don’t have it”
3.7.0
- FIX: Sell over WhatsApp — the shipping quote requested from the chat failed on stores with minimum-amount “Free shipping” (and carrier plugins that read the cart): outside checkout no cart was loaded, and the AI answered “you choose shipping at checkout”. The quote now answers
- NEW: shipping-zone free shipping in the chat. When the order is below the zone’s free-shipping minimum, the store reports the minimum and how much is missing, so the AI can suggest completing the order. Once reached, free shipping shows among the options and checkout opens with it selected
- NEW: only the ZIP code is required to generate the link. Name and street number, when given in the chat, pre-fill checkout; otherwise checkout asks
- NEW: when the link’s order is created and when it is paid, the store notifies XMetric Whats, which confirms the status here and tells the customer in the same chat. The notice runs in the background (checkout is not delayed) and carries only the cart id
3.6.1
- Sell over WhatsApp: the cart status lookup now also reports the order total (products, shipping and discount), so the sales dashboard in XMetric Whats shows the amount actually sold
3.6.0
- NEW: Sell over WhatsApp with the AI — with XMetric Whats as the sending server, the support AI can now search this store’s catalog, show photo and price, quote shipping and send a link that opens the store’s regular checkout with the cart assembled and the conversation’s details pre-filled. Nothing is paid inside the chat: shipping, payment, coupons, fraud checks and stock stay the store’s own
- Selling is OFF by default. Turn it on in Chat App Brasil → Settings, card “Sell over WhatsApp with the AI”: one click generates the sales token and registers this store with XMetric Whats. Without a token, catalog, shipping and cart answer 404 — updating the plugin opens nothing on its own
- The catalog returns only what is in stock; a variable product becomes one line per real combination (size + color that exist together), with brand and size as fields of their own, so the AI can suggest the right substitute when the requested item is missing
- The link is valid for 24 hours, can be reopened and never logs anyone in: a customer already logged in keeps their own account data. When expired, the store says “ask for a new link” instead of opening an empty cart
- Orders born from the link are flagged on the order (origin: WhatsApp link) for reports and for XMetric to show the “via WhatsApp” share
- SECURITY: a price coming from outside is refused by field name, never ignored — the cart carries product, variation and quantity, and the store does the math. Tax ID and e-mail never travel in the link: checkout asks for them
- SECURITY: the sales token is a third secret, separate from the sending key and the order-lookup token. The cart’s personal data is erased when the order is created or the link expires
- Coupons: only what the customer brings, checked against the WooCommerce coupon’s own rules (expiry, usage limit, minimum spend, products and categories). E-mail-restricted coupons pass as “subject to confirmation at checkout”, because only checkout knows the e-mail
- Shipping quote through the same path as checkout (shipping zones, Correios, Melhor Envio, flat rate) from the ZIP code; a cart with digital products only answers “no shipping”. The option the customer picks in the chat travels with the link and checkout opens with it selected — they can still change it there
- An order born from the link is a regular WooCommerce order: it shows up in the orders list like any other, with an order note saying it came from the WhatsApp link
3.5.1
- FIX: a tracking notification that failed to send still marked the order as notified. The order was stamped “tracking sent” without looking at the result, and that stamp is exactly what makes the retry and the Melhor Envio poller skip the order — one platform error and the customer never got the code. Only what actually went out is stamped now
- NEW: tracking that did not go out is retried on its own — 5 minutes later, then 15, 1 hour and 12 hours. Once the attempts run out the plugin gives up (instead of hammering the order hourly for 30 days) and writes an order note with the last error and how to resend
- FIX: when the send went through the anti-ban queue, the failure happened after the plugin had already called the tracking sent, and nobody looked at that order again. The queue now reports back, the stamp is undone and the tracking goes back into the retry line
- FIX: saving the tracking code that was already stored sent nothing and did not say why — anyone generating the label in the Melhor Envio plugin opens the order with the field already filled, clicks save, reads “Code saved” and the customer gets nothing. The button now notifies the customer whenever the order has not been notified yet, and the screen says what actually happened: sent, queued, already notified, or the send error
- NEW: you choose which order statuses trigger the tracking lookup and message (Tracking tab → “When to look for tracking”). It used to be “Completed” and nothing else: a store that ships on “Processing” or on a status of its own never saw the notice go out on its own. Nothing ticked still means Completed, and the Melhor Envio poller now scans exactly the same statuses
- FIX: an internal error from the sending platform (ERR_INTERNAL_ERROR) on a message carrying a link is now retried once without the link preview. The preview is built by the sending server, which has to open the URL in the message: a link it cannot open was taking the whole message down. Without the preview you lose the link card, not the notice
- IMPROVED: ERR_INTERNAL_ERROR showed up raw in the log and in the order note. It now reads as plain Portuguese, like the other errors
3.5.0
- FIX: messages refused with “identical message already sent today” that were never sent. The duplicate mark was written BEFORE the send and survived even when the API refused it — the customer got no notice and every retry hit the same refusal. The mark now only covers what actually went out: a failed send clears its own mark
- FIX: the Resend button (order note, order list and log) and the Test send were blocked as duplicates. These are deliberate actions — sending the same text to the same number again is exactly what was asked — and they now always go out
- FIX: different orders carrying the same text fought over the same mark. The key is now per event (order + number + message), so two orders from the same customer, or two customers, never block each other
- FIX: number and text were glued together with no separator to build the key, so two customers whose number and message fitted together produced the same key — the second one never received anything
- FIX: a blocking window saved blank or as zero lasted FOREVER (a 0 expiry never expires). Blank now means 24h, and the ceiling is one week
- IMPROVED: a duplicate refusal now says what happened to the twin — “already delivered X ago (source: Y)” or “queued, waiting to go out” — instead of announcing a send that may never have happened
- IMPROVED: the order note for a duplicate no longer says “failed ✗” about a message that was delivered, and the log line now carries the order and the source, so the twin can be found
- NEW: Order lookup by the AI — the store can now answer “where is my order?” for the WhatsApp AI, with status, items, tracking and payment link. Turn it on under Chat App Brasil → Configuration, in the “Order lookup by the AI” card: one button generates the token and the screen shows the address and token ready to copy
- The lookup ships TURNED OFF. With no token generated, the address refuses every question — updating the plugin never opens anything by itself
- SECURITY: the AI only sees orders belonging to the phone number of the ongoing conversation. Someone who bought using another phone can get through with the pair order number + CPF/CNPJ, never with the document alone
- SECURITY: “order does not exist” and “document does not match” answer exactly the same, so nobody can discover an order exists by guessing numbers
- SECURITY: the response never includes tax ID, e-mail or address. Only status, date, total, items, tracking and payment link — and the payment link only on orders still awaiting payment
- Phone numbers are matched by area code + the last 8 digits, so the ninth digit and the checkout mask never separate a customer from their own orders
- Tracking in the lookup comes from the same resolver the messages use (Correios → Melhor Envio → Melhor Envio API), so the lookup and WhatsApp never disagree about the same order
- Buttons to generate another token and to switch the lookup off at any time
- IMPROVED: One click turns the lookup on — the plugin registers this store with XMetric Whats by itself, using the sending key it already has, and confirms the gateway managed to query it. Nothing to copy between panels
- The “Order lookup by the AI” card only shows for stores using XMetric Whats as the sending server. With one exception: if the lookup is already on, the card stays visible even with the server back on ChatApp Brasil, because hiding a switch that is on would leave the store unable to turn it off
- Turning the lookup off notifies XMetric Whats, so it stops asking instead of piling up errors on a screen the store owner already switched off
3.4.0
- NEW: Sending server option — besides ChatApp Brasil (the default), the plugin can now send through XMetric Whats. The option is discreet: it sits at the bottom of the Access Token card under Configuration, and shows as a single line of text until it is switched on
- ChatApp Brasil remains the default: anyone who never opens the option sees no change in behaviour, and upgrading from 3.3.1 keeps sending exactly as before
- NEW: Switching XMetric Whats on swaps the fields — server address (pre-filled with https://whats.xmetric.com.br) and the token label becomes “Client key”. The “Save messages to the panel ticket” option disappears, because it does not apply to that server
- IMPROVED: Test Connection now answers two questions on XMetric Whats — whether the key is valid and whether a number is paired. Before, a good token on a store with no connected number was announced as ready to send
- IMPROVED: Changing the server or the address invalidates the previous token validation, as changing the token already did — a key approved by one platform says nothing about the other
- IMPROVED: The XMetric address accepts being pasted in any shape (no https, trailing slash, or the whole panel URL copied from the browser) and is normalised before saving
- INTERNAL: The three call sites that built the API address on their own (text send, media send and token test) now use a single resolver. The wlp_api_url filter still applies, and applies last
3.3.1
- NEW: Direct integration with the Melhor Envio API — set the access token on the Tracking tab and the plugin fetches the tracking code automatically, without depending on the ME plugin to store the data
- NEW: Tracking card on the order screen — add or edit the tracking code by hand and the WhatsApp message goes out to the customer right away
- NEW: Automatic hourly poller that checks Melhor Envio for new codes on completed orders that have no tracking sent yet
- NEW: Automatic retry via Action Scheduler when the tracking code is not available yet at the time the order is completed
- FIX: Duplicate expired PIX message — idempotency through the _wlp_pix_expired_sent meta stops Action Scheduler and the cancellation hook from sending two consecutive messages for the same order (MP and Asaas)
- FIX: Payment method check in wlp_mp_pix_expired switched to strpos, compatible with Mercado Pago PIX gateway variations
- FIX: The %rt_total% tag in abandoned cart now works as an alias of %cart_total%
3.3.0
- FIX: Compatibility with the new platform (Whaticket) — send success is now determined by the HTTP response code instead of the legacy “status” field. Delivered messages no longer show as “Unknown”/error in the log and order notes, and the false “Sends paused” warning is no longer triggered
- FIX: Send endpoint updated to the platform’s documented address (dashboard.chatappbrasil.com/backend/api/messages/send), customizable via the wlp_api_url filter
- NEW: Anti-ban system — configurable minimum spacing between sends (default 20s) plus random jitter (default up to 15s). Burst sends are queued and dispatched one at a time, mimicking human pace; the queue is processed on every request and by a 1-minute cron
- NEW: Messages that exceed the per-minute rate limit now join the anti-ban queue instead of being dropped
- NEW: “Save messages on ticket” option (saveOnTicket) — records store messages in the contact’s conversation on the platform; linkPreview enabled for text sends
- FIX: Token test compatible with the new platform’s error format (HTTP 401/403 and ERR_* codes)
- FIX: The abandoned cart frequency chosen on the settings screen is now persisted on save (it previously reverted to 5 min)
- FIX: The “Block identical messages” and “Sending hours” toggles can now be turned off (the off state was never saved)
- IMPROVEMENT: New platform error codes translated in the log (ERR_SENDING_WAPP_MSG, ERR_SESSION_EXPIRED, ERR_WAPP_INVALID_CONTACT)
- SECURITY: Log directory now uses a secret suffix in its name (uploads/woosend-logs-xxxx) — on Nginx servers .htaccess is ignored and logs (containing customer phone numbers and messages) were reachable at a predictable URL; the legacy directory is migrated automatically
- FIX: Sending-hours window now supports ranges crossing midnight (e.g. 22h–8h) — that configuration used to block all sends
- FIX: Local numbers from area code 55 (Santa Maria-RS region) now get the country code 55 correctly — they were previously sent without it and never delivered
- FIX: Abandoned cart (CartBounty Pro): follow-ups 2 and 3 never fired — the 24h eligibility window was shorter than their delays (48h/72h); the window now covers the full follow-up horizon
- FIX: Abandoned cart (CartBounty Free): added an eligibility window — activating the plugin with historical carts could blast messages to months-old …
