An integration connects your store to a channel. There are two kinds: a marketplace (you sell and receive orders - Amazon, eBay, Kaufland…) and an ad (advertising / price comparison - Google Shopping, Meta…). Both are set up the same way, through a short wizard. The assistant walks through it with you.
Just ask
Copy, paste and adapt:
I want to add an Amazon marketplace integration. Walk me through it one step at a time, and don't activate anything until I say so.
Other examples: "Set up Google Shopping for my store." · "Which channels can I add for my catalogue?" · "Add eBay Germany and stop before the connection step."
How it goes, step by step
Pick a channel. The assistant lists the channels you can add and, if you like, recommends ones that fit your catalogue. You choose (e.g. Amazon), and if the channel has variants (e.g. Amazon "Offers" vs "New products") it helps you pick the right one.
Create the integration. The assistant creates it and reads the wizard's list of steps.
Work through the wizard in order. One step at a time - identifiers, offer settings, product filter, category mapping, attribute mapping. Steps can't be skipped or reordered.
The connection step (see the panel below) - you finish this in your browser.
Category & attribute steps - map your categories and fill in the required channel attributes. See the Category Mapping and Attribute Mapping guides.
Summary - this finishes and activates the integration.
The connection / login step is done by you, in the browser. For security, the assistant cannot enter your channel credentials. It hands you a link - either an authorisation (OAuth) page or the Koongo settings page - you complete it, then tell the assistant to continue and it re-checks the connection.
Don't publish everything by accident. The Summary step activates the integration, and in AUTO product mode it pushes every matching product to the live channel. When testing, say: "Set this to MANUAL mode, publish one product so I can check it, then stop."
Order sync (marketplaces)
On marketplaces that sell - Amazon, eBay, Kaufland, bol… - Koongo can pull your orders from the channel back into your store. Order sync has two parts: first you turn on the capability (which adds a short "order settings" step to fill in), then you start the syncing. The assistant does both with you.
Just ask
Turn on order sync for my Amazon marketplace, help me fill in the order settings, then start syncing.
Other examples: "Can I enable order sync on this channel?" · "Stop syncing orders for now." · "Fetch my latest orders now."
How it goes
Enable it (if the channel supports it). You can turn order sync on when you create the marketplace, or later on one you already have. The assistant first checks whether the channel allows it; if it does, it turns the capability on and a new order settings step appears.
Fill in the order settings. The assistant walks you through that new step, like any other wizard step.
Start syncing. Once the settings are in, tell the assistant to start - orders then flow in automatically at regular intervals.
Sync now (optional). Ask it to fetch orders immediately instead of waiting for the next automatic run.
Order sync is only available on channels that support it (and when your store platform handles orders). If a channel can't do it, the assistant will tell you. Ads never have order sync.
Turning the capability on does not start syncing by itself - it only adds the settings step. Syncing begins only after you tell the assistant to start it.
Ads work the same way
Creating an ad (Google Shopping, Meta, Microsoft…) follows the exact same flow - pick the channel, create, run the wizard, finish at Summary. The only difference: ads have no order sync, so there is no order-mode step.
After you finish (or re-export), Koongo regenerates products in the background. Ask the assistant to "check the status" and it will wait until generation is done before reading the report.
Behind the scenes (for the curious)
Behind the scenes (for the curious)
The assistant uses these tools in order: list_marketplace_channels → get_marketplace_channel → create_marketplace → get_marketplace (reads the wizard steps) → configure_marketplace_step (one step at a time) → connection step returns an OAuth or settings link → test_marketplace_connection / marketplace_status → category & attribute steps → Summary step activates. For ads the equivalents are list_ad_channels, create_ad, configure_ad_step, ad_status (no order mode). Product mode is set with set_marketplace_product_mode (or set_ad_product_mode). Order sync: get_marketplace reports canEnableOrderSync; enable_marketplace_order_sync adds the order-settings step; configure_marketplace_step fills it in; set_marketplace_order_mode starts/stops the syncing; sync_marketplace_orders pulls orders on demand.