Terug naar integraties

Magento 2-integratie

Installeer de Raccomando-extensie voor Magento 2

Volg deze stappen om je Magento 2-catalogus te synchroniseren met Raccomando — van het aanmaken van de integratie tot je eerste volledige synchronisatie.

Vereisten

  • - Magento 2.4.x
  • - PHP 8.2 of 8.3
  • - Beheerderstoegang tot Stores → Configuration, plus CLI/SSH-toegang om bin/magento-commando's uit te voeren

Stap 1 — Maak de integratie aan in je dashboard

Ga in je Raccomando-dashboard naar Integrations en kies Magento om de begeleide koppelflow te starten. Geef je winkel een naam zodat je hem later herkent.

Wat je krijgt: een API-URL en een API-sleutel, eenmalig getoond. Kopieer de sleutel direct en bewaar hem op een veilige plek — een wachtwoordmanager werkt prima. Ben je hem kwijt, maak dan een nieuwe sleutel aan en trek de oude in via Dashboard → Settings → API Keys, plak de nieuwe sleutel in de Magento-beheeromgeving en voer Test Connection opnieuw uit — een ingetrokken sleutel stopt direct met werken.

Open de koppelflow

Stap 2 — Installeer de extensie

Gebruik de gehoste Composer-repository van Raccomando (aanbevolen), of download het zip-bestand en installeer het handmatig.

Aanbevolen — Composer

Voeg vanuit je Magento-hoofdmap de repository van Raccomando toe en installeer het package:

composer config repositories.raccomando composer https://raccomando.ai/composer
composer require raccomando/module-integration

Schakel daarna de module in en voer setup uit:

bin/magento module:enable Raccomando_Integration
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Alternatief — Download het zip-bestand en pak het uit in app/code

Extensie downloaden (v1.0.1)

Pak het gedownloade bestand uit in je Magento-hoofdmap:

unzip raccomando-magento-integration-1.0.1.zip -d app/code/Raccomando/Integration

Schakel daarna de module in en voer setup uit:

bin/magento module:enable Raccomando_Integration
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

De Composer-commando's gebruiken de gehoste package-repository van Raccomando; handmatige artifact-staging is niet nodig.

Stap 3 — Configureer de extensie

Ga in je Magento-beheeromgeving naar Stores → Configuration → Raccomando → Integration en vul de onderstaande velden in. (Deze sectie bevat ook een Installation Guide-melding bovenaan die terugverwijst naar deze pagina.)

General Settings

Enabled

Schakel de Raccomando-integratie in voor deze winkel.

API URL

Basis-URL van je Raccomando API. Standaard https://api.raccomando.ai — wijzig dit alleen voor een self-hosted omgeving of een niet-productieomgeving.

API Key

Je Raccomando API-sleutel uit stap 1, eenmalig uitgegeven bij het koppelen. Wordt versleuteld opgeslagen en na opslaan weer verborgen.

Test Connection

Klik hierop nadat je de twee bovenstaande velden hebt opgeslagen, om te controleren of Magento Raccomando kan bereiken met deze sleutel.

Sync Settings

Cron Sync Enabled

Schakelt de geplande volledige catalogus-synchronisatie in.

Cron Schedule

Cron-expressie voor de geplande volledige synchronisatie (standaard 0 2 * * * — dagelijks om 2:00 uur).

Batch Size

Aantal entiteiten per API-verzoek tijdens een volledige synchronisatie (standaard 100).

Sync Logging

Logt synchronisatieacties naar de tabel raccomando_sync_log — handig bij troubleshooting, veilig om aan te laten staan.

Order Sync Enabled

Verstuurt ordergebeurtenissen naar Raccomando. Standaard uit — orders/aankopen worden nog niet verwerkt door het platform, dus laat dit uit tenzij Raccomando-support anders aangeeft.

Trigger Full Sync

Start direct een volledige synchronisatie, ongeacht het cronschema.

Stap 4 — Test de verbinding

Sla je wijzigingen op en klik daarna op Test Connection.

Bij succes zie je een bevestiging zoals "Connected to Acme (My Store)." — de naam van je organisatie en de naam van deze integratie, ter bevestiging dat de sleutel aan het juiste account is gekoppeld.

Bij een mislukte poging vertelt het bericht wat je moet controleren (een ongeldige/geweigerde sleutel, of een onbereikbare API-URL) — de sleutel zelf wordt nooit getoond.

Stap 5 — Voer je eerste synchronisatie uit

Klik in de Magento-beheeromgeving op Trigger Full Sync onder Sync Settings — of laat Cron Sync Enabled aan staan en wacht op de geplande run (standaard: dagelijks om 2:00 uur).

Volg de voortgang vanuit je Raccomando-dashboard: open Integrations om te zien hoe de Latest Sync Job van deze winkel overgaat van Scheduled naar Running naar Succeeded, met een teller van verwerkte/totale items, en hoe de kolom Products wordt bijgewerkt met je gesynchroniseerde productaantal. Liet je in plaats daarvan het tabblad van de koppelflow open staan, dan toont de laatste stap daar hetzelfde resultaat als "Catalog synced ✓".

Bekijk je integraties

Problemen oplossen

Test Connection mislukt met een ongeldige sleutel

De sleutel is verkeerd overgetypt, of de vorige sleutel is ingetrokken vanuit het Raccomando-dashboard — bijvoorbeeld omdat er een nieuwe is uitgegeven ter vervanging (zie "Een nieuwe sleutel uitgeven" hieronder). Het veld API Key toont de opgeslagen waarde nooit, dus plak bij twijfel een sleutel waarvan je zeker bent, in plaats van te proberen te controleren wat er nu is opgeslagen.

Test Connection mislukt met een netwerkfout, of er komt niets binnen

Controleer de API-URL (moet beginnen met https://, zonder pad erachter) en of deze Magento-server api.raccomando.ai kan bereiken via HTTPS op poort 443 — een firewall of uitgaande proxy die verkeer blokkeert is de meest voorkomende oorzaak.

Synchronisatie start nooit

Controleer of Cron Sync Enabled op Yes staat en of Magento's eigen cron draait (bin/magento cron:run, of controleer crontab -l op de Magento-regel). Klik op Trigger Full Sync om direct te synchroniseren zonder op het schema te wachten.

Een nieuwe sleutel uitgeven

Sleutel kwijt, of denk je dat hij gecompromitteerd is? Ga in je Raccomando-dashboard naar Settings → API Keys, klik op Create Key om een nieuwe uit te geven en trek daarna de oude sleutel in via Revoke — een ingetrokken sleutel stopt direct met werken. Plak de nieuwe sleutel op dezelfde manier als tijdens het instellen in het veld API Key en klik opnieuw op Test Connection.

Volgende stappen

Zodra je catalogus is gesynchroniseerd, voeg je de storefront-widgets van Raccomando — zoeken en aanbevelingen — toe aan je Magento-thema. Na je eerste synchronisatie linkt de laatste stap van de koppelflow direct naar de widget-instellingen van je integratie ("Widgets voor je winkel instellen →").

Bekijk je integraties