Magento-connector
Virker med Magento
Tilslut Magento 2 eller Adobe Commerce til FreeScout, så samtaler viser matchede kundeordrer og købskontekst. Et lille skrivebeskyttet Magento-modul eksponerer et support-resumé over Magento REST API, og FreeScout-connectoren viser det i samtale-sidepanelet. ReplyRabbit sender også produkt-ejerskabskontekst ind i AI-laget, så kladder kan referere til, hvad en kunde har købt.
Leder du efter oversigten?
Oversigt
Magento-connectoren tilføjer et ordre-sidepanel til FreeScout-samtaler. Når en samtale har en kundes e-mailadresse, kalder connectoren moo-support/summary endpoint på din Magento-butik til at matche ordrer og viser dem ved siden af samtalen.
Sidepanelet viser et kundepanel, fuld ordrehistorik, ordrelinjer pr. ordre med antal og priser, økonomiske totaler, kundens livstidsværdi (CLV), gennemsnitlig ordreværdi (AOV) og produktadgangsrettigheder, der flyder ind i ReplyRabbit AI-konteksten for mere relevante kladder.
Der er to komponenter at installere:
- Den ReplyRabbit Connector-modul til Magento 2. Den tilføjer to skrivebeskyttede REST-endpoints (
/rest/V1/moo-support/summaryog/rest/V1/moo-support/purchased-products) bag en dedikeret admin-tilladelse kaldet ReplyRabbit Connector API. Den ændrer ikke butiksfacaden eller betalingen. - Den FreeScout Magento connector-modul. Den kalder disse endpoints over HTTPS ved hjælp af et Magento-integrationsadgangstoken og gengiver ordre-sidepanelet. Den har sin egen indstillingsside pr. postkasse i FreeScout.
Ordre-sidebjælken fungerer alene. Produkt ejerskab-rettigheden, der flyder ind i AI-kladder, er den del, der bruger ReplyRabbit.
Forudsætninger
Før du starter, skal du sikre dig, at du har:
- En fungerende FreeScout-installation.
- En Magento 2.4 eller nyere butik (Magento Open Source eller Adobe Commerce), der kan nås via HTTPS, med SSH-adgang til at køre Magento CLI-kommandoer.
- Magento-adminadgang til at oprette en Integration.
- ReplyRabbit installeret og aktiveret, hvis du vil have produkt-ejerskabskontekst i AI-udkast.
- En Magento Connector-licens (18 EUR engangsbeløb for én FreeScout-installation), eller en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer den.
Hvis ReplyRabbit ikke er installeret endnu, skal du starte med Sådan installerer du ReplyRabbit-modulet, derefter afslut Sådan opsætter du ReplyRabbit.
Installer Magento-modulet
Download Magento-modulet
Log ind på app.replyrabbit.app og download Magento-modulets ZIP fra Magento connector-kortet.Pak den ud i app/code
Upload ZIP-filen til din Magento-rod, og pak den ud. Den opretterapp/code/Moogento/SupportData.Aktivér modulet
Fra Magento-roden skal du køre:På en butik i produktionstilstand skal du også kørebashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploysom du ville gøre ved enhver modulinstallation.
Composer-installationer
moogento/m2-supportdata fra Moogento-pakkeopbevaringsstedet. ZIP-installationen ovenfor kræver ingen Composer-legitimationsoplysninger.Opret et Magento-integrationstoken
Connectoren godkender med et adgangstoken fra en Magento Integration. Opret en med modullets skrivebeskyttede tilladelse.
Åbn Integrations
I Magento-administrationen skal du gå til System, derefter Udvidelser, derefter Integrationer, og klik på Tilføj ny integration.Navngiv den, og indstil API-omfanget
Indtast et navn som "ReplyRabbit Connector" og din admin-adgangskode. På API fane, sæt Ressourceadgang til Brugerdefineret og markér kun ReplyRabbit Connector API (under det øverste admin-træ). Gem.Aktiver og kopier adgangstokenet
Klik Aktiver ved siden af den nye integration, og derefter Tillad. Kopier Adgangstoken. Magento viser tokenet i integrationsoplysningerne, så du kan vende tilbage til det senere.
Skrivebeskyttet adgang
Installer FreeScout-connectormodulet
FreeScout Magento-connector-modulet kalder Magento-endpoints og viser ordre-sidepanelet i samtaler. Det er sit eget modul med sine egne indstillinger, adskilt fra ReplyRabbit.
Download connectormodulet
Log ind på app.replyrabbit.app for at downloade FreeScout connector-modulets ZIP. Begge downloads vises, når du har købt connectoren eller har en aktiv ReplyRabbit Pro- eller Team-plan.Upload til FreeScout
I FreeScout skal du gå til Moduler, klik på upload-knappen, vælg ZIP-filen, og installer den.Aktiver modulet
Aktiver Magento-integration modul fra Modullisten.
Konfigurer pr. postkasse
Når modulet er installeret, skal du forbinde det til din butik på connectorens egen indstillingsside pr. postkasse.
Åbn connector-indstillingerne
I FreeScout skal du åbne den postkasse, der skal vise Magento-ordredata, åbne menuen for postkasseindstillinger og vælge Store Connector. Dette er Magento-connectorens indstillingsside, ikke et afsnit inde i ReplyRabbit-indstillingerne.Indtast Magento-base-URL'en
Indsæt basis-URL'en for din Magento-butik over HTTPS, for eksempelhttps://your-store.com. En afsluttende skråstreg er ikke nødvendig.Indtast access-tokenet
Indsæt Adgangstoken fra Magento-integrationen. Den gemmes krypteret, og der vises kun en maskeret forhåndsvisning efter lagring.Indstil butiks-ID (valgfrit)
Lad feltet være tomt for at matche ordrer på tværs af alle butikker. Indtast et Magento-butiks-ID for at begrænse sidepanelet til én butik eller butiksvisning.Tilføj din connector-licensnøgle
Hvis du købte connectoren, skal du indtaste dens licensnøgle. Spring dette trin over, hvis en aktiv ReplyRabbit Pro- eller Team-plan dækker installationen.Gem og test
Gem indstillingerne. Åbn en FreeScout-samtale, hvor kundens e-mail matcher en Magento-ordre, og bekræft, at ordre-sidepanelet vises.
Hver FreeScout-postkasse gemmer sin egen base-URL, access token og butiks-ID, så du kan forbinde forskellige postkasser med forskellige Magento-butikker eller butiksvisninger.
Hvad connectoren viser
- Et kundepanel til personen på samtalen.
- Fuld ordrehistorik med ordrenummer, dato, status og total.
- Linjeposter pr. ordre med antal og priser.
- Økonomiske totaler (subtotal, rabat, forsendelse, moms, refunderinger).
- Kundelivstidsværdi (CLV) og gennemsnitlig ordreværdi (AOV).
- Produkt ejerskabsrettighed for AI-udkast.
Sådan får du connectoren
Magento Connector er et betalt modul. Du kan få det på to måder:
- Køb Magento Connector for 18 EUR som en engangslicens til én FreeScout-installation, og indsæt derefter dens licensnøgle i connector-indstillingerne.
- Brug en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer connectoren uden ekstra omkostning.
Køb licensen eller download connectoren fra din ReplyRabbit dashboard. Besøg prisside for ReplyRabbit-planmuligheder. Hvis en aktiv ReplyRabbit Pro- eller Team-plan dækker installationen, virker connectoren, når den er konfigureret, uden en separat licensnøgle.
Fejlfinding
| Symptom | Hvad du skal kontrollere |
|---|---|
| Ordre-sidebjælken vises ikke | Bekræft, at basis-URL'en og adgangstokenet i connector-indstillingerne er korrekte, og at postkassepanelet er aktiveret. |
| HTTP 404 fra butikken | ReplyRabbit Connector-modulet er ikke installeret eller aktiveret. Kør igen bin/magento module:enable Moogento_SupportData og bin/magento setup:upgrade, og tøm derefter cachen. |
| HTTP 401 eller 403 fra butikken | Integrationen er ikke aktiveret, tokenet er blevet regenereret, eller integrationen mangler ReplyRabbit Connector API ressource. Genaktiver integrationen, og indsæt det aktuelle token. |
| "Connection refused" eller timeout-fejl | Tjek, at FreeScout-serveren kan nå din butiks-URL over HTTPS. Firewalls, IP-allowlister eller vedligeholdelsestilstand kan blokere anmodningen. |
| Basis-URL afvises | Butikken skal leveres over HTTPS. En almindelig http:// URL eller en utilgængelig vært afvises. |
| Ordrer er tomme for en kendt kunde | Bekræft, at kundens e-mail på FreeScout-samtalen matcher e-mailen på deres Magento-ordrer, og at butiks-ID'et (hvis angivet) matcher den butik, de bestilte fra. |
| Linjeposter, økonomi eller CLV vises ikke | Bekræft, at connector-licensnøglen er gemt, eller at en aktiv ReplyRabbit Pro- eller Team-plan dækker installationen. |
| Produkt ejerskabskontekst vises ikke i udkast | Bekræft, at connectoren er licenseret, at ReplyRabbit er installeret, at connectoren returnerer ordrer, og at AI-kontekstfunktionen er aktiveret for postkassen. |
For bredere problemer, se Fejlfinding af ReplyRabbit.
Privatliv og datahåndtering
Når connectoren forespørger Magento, sender den kundens e-mailadresse til din egen Magento-butik over HTTPS. De ordredata, der returneres fra din butik, udfylder FreeScout-sidepanelet og opbygger sammen med ReplyRabbit AI-konteksten til kladder.
Integrationstokenet behøver kun den skrivebeskyttede ReplyRabbit Connector API ressource, så connectoren skriver aldrig til din butik. Tokenet gemmes krypteret i FreeScout, og udgående anmodninger verificerer TLS og følger ingen omdirigeringer.
Ingen Magento-ordredata sendes til tredjeparter undtagen via den AI-udbyder, der er valgt til postkassen, og kun når AI-kontekstfunktionen bruger dem. Hvis din politik kræver, at ordredata forbliver helt på dine egne servere, skal du bruge en lokal AI-udbyder (såsom Ollama) til postkassen.
Næste trin
- Afslut Sådan opsætter du ReplyRabbit hvis postkassen stadig mangler udbyder-, kontekst- eller stilindstillinger.
- Også på WooCommerce? Se WooCommerce-connector guide.
FAQ
Har jeg brug for et Magento-modul til connectoren?
Ja. Connectoren læser et support-summary-endpoint, som ReplyRabbit Connector-modulet tilføjer til Magento 2 REST API. Der er to downloads, Magento-modulet og FreeScout Magento connector-modulet, begge tilgængelige fra din ReplyRabbit-konto.
Hvilke Magento-versioner understøttes?
Magento 2.4 og nyere, inklusive Magento Open Source og Adobe Commerce, på PHP 8.0 til og med 8.4. Magento 1 understøttes ikke.
Hvad koster Magento Connector?
Magento Connector er inkluderet med en aktiv ReplyRabbit Pro- eller Team-plan. Ellers koster det 18 EUR som engangslicens til én FreeScout-installation. Hvis du køber det, skal du indsætte dets licensnøgle i connector-indstillingerne.
Hvilken tilladelse kræver access-tokenet?
Kun ReplyRabbit Connector API-ressourcen, som er skrivebeskyttet. Connectoren skriver aldrig til din butik, så integrationen har ikke brug for andre admin-tilladelser.
Kan hver FreeScout-postkasse forbindes til en forskellig Magento-butik?
Ja. Hver postkasse gemmer sin egen base URL, access token og valgfrie store ID i connector-indstillingerne, så forskellige butikker eller butiksvisninger kan forbindes til forskellige postkasser.