# Flash Manager Integration — Automatic Order Sync **Category:** External platforms  ·  **Min plan:** Free  ·  **Slug:** `flash-manager` **Flash Manager** (`flash-manager.com`) is a COD order-management and order-confirmation platform — its own tagline is *COD order management, WhatsApp confirmations & Meta ROAS*. Algerian merchants use it as a call-center workspace where a confirmation team calls or WhatsApps every new order, marks it confirmed or cancelled, and follows the delivery afterwards. DZBuild ships a **native integration** with it, so every order placed on your store lands in Flash Manager automatically, with no export and no copy-paste. ## Video tutorial [Flash Manager Integration — Automatic Order Sync](https://www.youtube-nocookie.com/embed/uOLAkJ-ik60) ## Features * **Order sync** — new DZBuild orders are sent to Flash Manager automatically. * **Confirmation center** — your team confirms orders in Flash Manager, including by WhatsApp. * **Delivery tracking** — Flash Manager's own delivery statuses are shown back inside DZBuild. * **Advanced reports** — Flash Manager's reporting on your order flow. * **Campaign ROAS tracking**: Flash Manager's Meta ROAS view of your orders. DZBuild passes the campaign id when the link the customer arrived on carries a `campaign_id`, `utm_campaign` or `campaignid` parameter. * **Advanced API** — the connection uses your own Flash Manager API key, stored encrypted. ## What it does Once your store is connected, DZBuild sends each **new order** to Flash Manager within seconds of it being placed. This covers orders from every selling surface: your storefront checkout, your [landing pages](https://dzbuild.com/docs/selling/landing-pages.md), orders you create manually from the [Orders](https://dzbuild.com/docs/selling/orders.md) page, and orders created through the DZBuild API. Nothing has to be clicked per order, and no CSV is involved. Once Flash Manager accepts an order, DZBuild records it as sent and skips it on every later attempt, so re-sending an order or pressing **Send unsynced orders** again does not create a second copy. The one case that can still slip through is two send attempts starting for the same order in the same instant; it is rare, but if you suspect it, look in Flash Manager for two orders carrying the same DZBuild order number. The **Recent orders** table on DZBuild lists each order once, so it cannot show the duplicate. In the other direction, DZBuild checks Flash Manager regularly and shows the confirmation and delivery status of each sent order inside the integration page: a delivered order shows up within about 5 minutes, other confirmation and delivery changes within about 30 minutes. Those statuses are only **copied onto your DZBuild orders** if you switch the mirror option on; it is off by default. ### Status mirroring When **Update order status from FlashManager** is enabled, Flash Manager's vocabulary is translated to DZBuild order statuses like this: | Flash Manager status | Your DZBuild order becomes | | -------------------------------------------------------- | -------------------------- | | New, Callback, No answer | Pending | | Confirmed, Confirmed by customer, Self-confirmation | Confirmed | | Cancelled, Duplicate, Wrong number | Cancelled | | Label created, Ready for pickup | Processing | | Picked up, Out for delivery, Attempted delivery, Delayed | Shipped | | Delivered | Delivered | | Failure | Returned | warning Two guards always apply, even with mirroring on. An order that has already been **sent to a delivery company** from DZBuild is never overwritten — its courier tracking stays the source of truth. And an order already in a final state (`delivered`, `returned`, `cancelled`) never walks backwards. ## Benefits * **No manual re-entry.** Your confirmation agents stop retyping names, phones, wilayas and totals into a second tool — the order is already there, complete. * **Faster confirmation.** Orders appear in the confirmation queue seconds after checkout, while the buyer still remembers ordering. Calling early is what keeps confirmation rates high. * **Fewer returns.** Wrong numbers, duplicates and undecided buyers get filtered *before* the parcel is handed to a courier, instead of coming back as a paid return. * **One place to look.** The integration page shows how many orders were sent, how many are still open, and what Flash Manager says about each one, next to your own store status. * **ROAS visibility.** Because every order reaches Flash Manager, its Meta ROAS reporting sees your full order volume, not a manually exported subset. ## How to activate 1. Open **Dashboard → Add-ons** at [`/dashboard/addons`](https://dzbuild.com/dashboard/addons). 2. Scroll to the **External platforms** section and find the **FlashManager** card. 3. Click **Connect FlashManager** — it opens the management page at `/dashboard/addons/flash-manager`. 4. In Flash Manager, generate an API key carrying the `orders:write` permission and copy it. Their menus move from time to time, so look for the API section of their settings or ask Flash Manager support. DZBuild only accepts keys that start with `fm_`. 5. Paste it into the **API key** field and click **Connect**. The integration is **free on every DZBuild plan** — Free, Pro, Unlimited and Enterprise. There is nothing to buy on the DZBuild side. ## Using it ### Connection card * The header shows a **Connected** or **Not connected** badge. * Press **Test connection** to display your Flash Manager **account**, **plan**, and **orders used** out of your plan's monthly allowance. After **Connect** they show for a moment, then the page reloads without them. * Your API key is **stored encrypted and never rendered in the browser**. Once connected, the field only shows a masked hint like `fm_live_••••••••abcd`; typing a new key replaces the old one. * **Disconnect** removes the connection at any time. When you connect again, both settings go back to their defaults (**Send new orders automatically** on, **Update order status from FlashManager** off), so switch the mirror option back on and press **Save** if you used it. warning The key you generate must carry the `orders:write` permission. A key without it is refused at connect time with a clear message — generate a new key in Flash Manager with that permission enabled. ### Counters Four tiles summarise the sync — **Orders sent**, **In progress**, **Completed**, and **Not sent yet**. ### Settings * **Send new orders automatically** — on by default. This is what makes new orders flow without any action from you. * **Update order status from FlashManager** — off by default. Turn it on only if Flash Manager is your primary source of order statuses. Press **Save** to apply. ### Sending older orders If there are orders that were never sent, for example orders placed before you connected, a **Send unsynced orders** button appears. It asks for confirmation first, because those orders count against your Flash Manager plan's monthly order quota. Each press queues up to 200 of your most recent unsent orders, whatever their status (cancelled and delivered orders included), and sends them gradually in the background; once they are sent, press it again for older ones. ### Recent orders table The last sent orders are listed with **Order**, **Customer**, **Total**, **Store status**, **FlashManager number**, **FlashManager status**, and **Sent at**. Confirmed and delivered rows are highlighted in green, cancelled and failed ones in red. ### If something goes wrong When Flash Manager refuses a request, a **Last error** banner appears at the top of the page with the reason: monthly order limit reached on your Flash Manager plan, or missing permissions. If Flash Manager rejects the key itself, DZBuild disconnects the integration instead and the page shows **Not connected**: paste a valid key and click **Connect**. Once the cause is fixed, new orders flow again on their own; after a plan limit this can take up to an hour. Orders that failed in the meantime are not retried: they stay in **Not sent yet**, so press **Send unsynced orders** to send them. ## FAQ ### Does the Flash Manager integration cost anything on DZBuild? No. It is free on all DZBuild plans. You only pay Flash Manager for their own plan, and their plans carry a monthly order quota, whose size is set by Flash Manager and shown on their pricing page. That quota lives entirely on their side. All DZBuild sees is the moment you reach it: sending pauses and the **Last error** banner says the plan limit was reached. Orders placed while sending is paused are not sent later on their own: press **Send unsynced orders** once your quota is back. ### Can the same order be sent twice? Almost never. DZBuild remembers every order Flash Manager has accepted and ignores it on later send attempts, so re-sending or backfilling does not duplicate anything. A duplicate is only possible when two send attempts for the same order start at the same instant, before either of them has been recorded. If you do spot one, delete it in Flash Manager: the DZBuild side stays correct. ### Do I have to click anything for each new order? No. With **Send new orders automatically** on (the default), orders leave for Flash Manager within seconds of being placed: storefront, landing page, manually created, or created through the API. The **Send unsynced orders** button exists only for backfilling older orders. ### I already send orders to a courier from DZBuild. Will Flash Manager overwrite my statuses? Not unless you ask for it. **Update order status from FlashManager** is off by default, and even when enabled, orders already sent to a delivery company from DZBuild are never touched, so your courier tracking stays authoritative. ### Where do I find the other integrations? All add-ons and external platforms live on the same page — see the [Add-ons catalog](https://dzbuild.com/docs/addons/overview.md) and the **External platforms** section of [`/dashboard/addons`](https://dzbuild.com/dashboard/addons).