Externe commerce synchronisatie

Overzicht

Kanalen & integraties → Externe commerce (/nl/integrations/commerce) houdt de checkout op Shopify of WooCommerce terwijl ondersteunde gegevens worden gespiegeld naar OrderInChat. De widget, WhatsApp en Instagram AI, automatiseringen en optionele verzendlabels gebruiken de gespiegelde gegevens.

Deze integratie kloont het bron-thema niet en vervangt de externe checkout niet.

Shopify-verbinding

OrderInChat gebruikt Shopify OAuth, zodat je tokens niet handmatig hoeft te kopiëren.

1. Maak in het Shopify Partner-dashboard een app aan met de naam Order in Chat.
2. Voeg de callback-URL https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback toe aan Toegestane omleidings-URL's.
3. Geef deze Admin API-rechten: read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. Ga in OrderInChat naar Kanalen & integraties → Externe commerce, kies Shopify, voer de HTTPS-winkel-URL in (bijvoorbeeld https://your-store.myshopify.com) en klik op Verbind met Shopify.
5. Keur de machtigingen in Shopify goed. Je keert automatisch terug naar OrderInChat. Klik vervolgens op Test verbinding, Registreer webhooks en Synchroniseer nu.

Als je OAuth niet kunt gebruiken, vouw dan de sectie Handmatige tokeninstelling uit en plak de Admin API-toegangstoken en de API-geheim sleutel van de aangepaste app. De API-geheim is vereist om de HMAC-handtekeningen van Shopify-webhooks te verifiëren. OrderInChat versleutelt inloggegevens en toont ze nooit meer.

Officiële handleidingen: Shopify aangepaste apps en Admin API-toegangstokens.

WooCommerce-verbinding

Open in WordPress WooCommerce → Instellingen → Geavanceerd → REST API, maak een sleutel aan met Lezen-machtiging voor alleen mirror-synchronisatie, of Lezen/Schrijven-machtiging als Bulk Editor-wijzigingen teruggeschreven moeten worden naar WooCommerce, en voer de HTTPS-winkel-URL, consumenten sleutel en consumenten geheim in. Om WordPress-pagina's en berichten te synchroniseren, voer ook een WordPress-gebruikersnaam en Toepassing wachtwoord in van Gebruikers → Profiel.

Officiële handleiding: WooCommerce REST API.

Sommige hosts weigeren HTTP Basic-authenticatie. De connector kan WooCommerce-verzoeken opnieuw proberen met authenticatie via de query-string; inloggegevens worden uit logs verwijderd.

Synchronisatiegedrag

1. Sla de verbinding op en test deze.
2. Registreer webhooks — maakt abonnementen aan op de externe winkel, zodat wijzigingen in producten, bestellingen en klanten OrderInChat bijna in realtime op de hoogte stellen. OrderInChat controleert ook regelmatig op wijzigingen voor het geval een webhook wordt gemist.
3. Selecteer de te spiegelen bronnen.
4. Voer de initiële synchronisatie uit.

Voor de veiligheid verifieert OrderInChat elke webhook en controleert de gegevens opnieuw bij Shopify of WooCommerce voordat ze worden opgeslagen. De regelmatige controles vangen gemiste webhooks op alleen terwijl Gebruik als commercebron is ingeschakeld. Als de webhookstatus een fout toont en de verbinding inactief is, gebruik dan Registreer webhooks en Synchroniseer nu na wijzigingen op de bronwinkel; Alleen Test verbinding werkt producten niet bij. Herhaalde updates creëren geen dubbele records.

Het verzendgewicht van Shopify-varianten wordt geïmporteerd vanuit het gewicht van de variant in Shopify; de producteditor toont het in de geconfigureerde gewichtseenheid van de winkel. Dimensiemetavelden genaamd length, width of height worden omgezet naar centimeters. Shopify-productbeschrijvingen komen uit de eigen beschrijving van het product, niet van gedeelde themasecties of banners; themateksten worden geen product-specifieke beschrijving. Concept- en gearchiveerde producten worden niet aan klanten getoond.

Wanneer je winkel externe commerce gebruikt, kopen klanten via de URL van het bronproduct. Winkelwagentje-checkout van OrderInChat en WhatsApp-checkoutflows zijn voor die winkel uitgeschakeld.

Voorraadlocaties

Shopify-locaties en per-variant voorraadniveaus worden gespiegeld naar OrderInChat-magazijn-/locatierecords. Product- en variantvoorraad tonen het totaal over alle locaties voor chat en checkout. WooCommerce-kern geeft één totale voorraadwaarde weer, dus deze wordt gespiegeld naar een standaard virtuele locatie; voorraad op meerdere locaties uit WooCommerce-plugins vereist een ondersteunde plugin.

Je kunt je eigen OrderInChat-locaties toevoegen onder Catalogus → Voorraad. De cellen voor voorraad in de Bulk Editor worden per locatie uitgebreid. Voorraad naar Shopify sturen werkt alleen de geselecteerde locatie bij en vereist de scope write_inventory. Vergrendelde voorraadvelden worden niet overschreven door een latere voorraad-synchronisatie.

Verzendlabels

OrderInChat-verzendlabels zijn standaard uitgeschakeld. Schakel ze alleen in als OrderInChat de enige plek moet zijn waar labels worden aangemaakt. Zelfs wanneer ingeschakeld, koopt OrderInChat geen label wanneer de externe bestelling al vervulling of trackinginformatie heeft.

Widget-snippet

Shopify: Registreer webhooks probeert ook automatisch de chatwidget op je Shopify-winkel te installeren. Je kunt de snippet nog steeds in Custom Liquid plakken indien nodig. Geef write_script_tags op de aangepaste app als auto-installatie mislukt.

WooCommerce: De REST API kan themascripts niet injecteren. Kopieer de JavaScript- of PHP-snippet van de integratiepagina in de voettekst van het thema of functions.php.

Pagina's → Kennisbank

Wanneer Pagina's en berichten is ingeschakeld, worden Shopify-pagina's/artikelen/beleid en WooCommerce-pagina's/berichten toegevoegd aan (of bijgewerkt in) de OrderInChat Kennisbank voor AI-antwoorden. Overeenkomende Shopify-beleids titels vullen ook de velden voor retour/voorwaarden in de winkel. Dit is geen volledige thema/CMS-kloon.

API-beperkingen

De integratie rapporteert niet-ondersteunde of niet-beschikbare gegevens in plaats van waarden uit te vinden. Veelvoorkomende beperkingen zijn:

• Shopify stelt niet alle betalingsinstellingen bloot via de Admin API.
• Door de vervoerder berekende verzendprijzen blijven berekend bij de externe checkout.
• WooCommerce REST omvat geen WordPress-pagina's zonder een WordPress Toepassing Wachtwoord.
• Beoordelingen en boekingen vereisen een platform- of app-API die die bronnen blootstelt.
• Product-add-ons worden alleen gespiegeld wanneer de bron-API een echt equivalent heeft.