Magento-kobling
Fungerer med Magento
Koble Magento 2 eller Adobe Commerce til FreeScout slik at samtaler viser matchede kundeordrer og kjøpskontekst. En liten skrivebeskyttet Magento-modul eksponerer et støttesammendrag over Magento REST API, og FreeScout-koblingen viser det i samtaleens sidepanel. ReplyRabbit mater også produkteterskapskontekst inn i AI-laget slik at utkast kan referere til det en kunde har kjøpt.
Ser du etter oversikten?
Oversikt
Magento-koblingen legger til et ordre-sidepanel i FreeScout-samtaler. Når en samtale har en kundes e-postadresse, kaller koblingen moo-support/summary endepunkt på Magento-butikken din for å matche ordrer og viser dem ved siden av samtalen.
Sidepanelet viser et kundepanel, full ordrehistorikk, ordrelinjer per ordre med antall og priser, økonomiske totaler, kundens livstidsverdi (CLV), gjennomsnittlig ordreverdi (AOV) og produktrettigheter som flyter inn i ReplyRabbit AI-konteksten for mer relevante utkast.
Det er to komponenter å installere:
- Den ReplyRabbit Connector-modul for Magento 2. Den legger til to skrivebeskyttede REST-endepunkter (
/rest/V1/moo-support/summaryog/rest/V1/moo-support/purchased-products) bak en egen admin-tillatelse kalt ReplyRabbit Connector API. Den endrer ikke butikkfronten eller betalingen. - Den FreeScout Magento connector-modul. Den kaller disse endepunktene over HTTPS ved hjelp av et Magento-integrasjonstilgangstoken og viser ordresidepanelet. Den har sin egen innstillingsside per postkasse i FreeScout.
Ordre-sidepanelet fungerer på egen hånd. Produkteterskapsrettighetene som flyter inn i AI-utkast, er delen som bruker ReplyRabbit.
Forutsetninger
Før du starter, må du sørge for at du har:
- En fungerende FreeScout-installasjon.
- En Magento 2.4 eller nyere butikk (Magento Open Source eller Adobe Commerce) tilgjengelig over HTTPS, med SSH-tilgang for å kjøre Magento CLI-kommandoer.
- Magento-admintilgang for å opprette en integrasjon.
- ReplyRabbit installert og aktivert hvis du vil ha produkteterskapskontekst i AI-utkast.
- En Magento Connector-lisens (18 EUR engangsbeløp, for én FreeScout-installasjon), eller en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer den.
Hvis ReplyRabbit ikke er installert ennå, start med Hvordan installere ReplyRabbit-modulen, og fullfør deretter Hvordan sette opp ReplyRabbit.
Installer Magento-modulen
Last ned Magento-modulen
Logg inn på app.replyrabbit.app og last ned Magento-modulens ZIP fra Magento connector-kortet.Pakk det ut i app/code
Last ZIP-filen opp til Magento-roten din og pakk den ut. Den oppretterapp/code/Moogento/SupportData.Aktiver modulen
Fra Magento-roten, kjør:På en butikk i produksjonsmodus, kjør ogsåbashbin/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 gjort for enhver modulinstallasjon.
Composer-installasjoner
moogento/m2-supportdata fra Moogento-pakkearkivet. ZIP-installasjonen ovenfor trenger ingen Composer-legitimasjon.Opprett et Magento-integrasjonstoken
Konnektoren autentiserer med et tilgangstoken fra en Magento-integrasjon. Opprett en med modulens skrivebeskyttede tillatelse.
Åpne Integrasjoner
I Magento-administrasjonen, gå til System, deretter Utvidelser, deretter Integrasjoner, og klikk Legg til ny integrasjon.Gi den navn og angi API-omfanget
Skriv inn et navn som "ReplyRabbit Connector" og adminpassordet ditt. På API fanen, sett Ressurstilgang til Egendefinert og kryss av bare ReplyRabbit Connector API (under det øverste admin-treet). Lagre.Aktiver og kopier tilgangstokenet
Klikk Aktiver ved siden av den nye integrasjonen, og deretter Tillat. Kopier Tilgangstoken. Magento viser tokenet i integrasjonsdetaljene, så du kan komme tilbake til det senere.
Skrivebeskyttet tilgang
Installer FreeScout-konnektormodulen
FreeScout Magento-koblingsmodulen kaller Magento-endepunktene og viser ordre-sidepanelet i samtaler. Det er en egen modul med egne innstillinger, atskilt fra ReplyRabbit.
Last ned koblingsmodulen
Logg inn på app.replyrabbit.app for å laste ned FreeScout-koblingsmodulen som ZIP. Begge nedlastingene vises når du har kjøpt koblingen eller har en aktiv ReplyRabbit Pro- eller Team-plan.Last opp til FreeScout
I FreeScout, gå til Moduler, klikk på opplastingsknappen, velg ZIP-filen og installer den.Aktiver modulen
Aktiver Magento-integrasjon modul fra Modullisten.
Konfigurer per postkasse
Etter at modulen er installert, kobler du den til butikken din på connectorens egen innstillingsside per postkasse.
Åpne innstillingene for koblingen
I FreeScout, åpne postkassen som skal vise Magento-ordredata, åpne menyen for postkasseinnstillinger og velg Butikkobling. Dette er innstillingssiden for Magento-koblingen, ikke en seksjon inne i ReplyRabbit-innstillingene.Skriv inn Magento-base-URL-en
Lim inn base-URL-en til Magento-butikken din over HTTPS, for eksempelhttps://your-store.com. En avsluttende skråstrek er ikke nødvendig.Skriv inn tilgangstokenet
Lim inn Tilgangstoken fra Magento-integrasjonen. Den lagres kryptert, og bare en maskert forhåndsvisning vises etter lagring.Angi butikk-ID (valgfritt)
La stå tomt for å matche ordrer på tvers av alle butikker. Skriv inn en Magento-butikk-ID for å begrense sidepanelet til én butikk eller butikkvisning.Legg til connector-lisensnøkkelen din
Hvis du kjøpte koblingen, angi lisensnøkkelen. Hopp over dette trinnet hvis en aktiv ReplyRabbit Pro- eller Team-plan dekker installasjonen.Lagre og test
Lagre innstillingene. Åpne en FreeScout-samtale der kundens e-post samsvarer med en Magento-ordre, og bekreft at ordre-sidepanelet vises.
Hver FreeScout-postkasse lagrer sin egen basis-URL, tilgangstoken og butikk-ID, slik at du kan koble ulike postkasser til ulike Magento-butikker eller butikkvisninger.
Hva koblingen viser
- Et kundepanel for personen i samtalen.
- Full ordrehistorikk med ordrenummer, dato, status og total.
- Ordrelinjer per ordre med antall og priser.
- Økonomiske totaler (delsum, rabatt, frakt, mva, refusjoner).
- Kundens livstidsverdi (CLV) og gjennomsnittlig ordreverdi (AOV).
- Produkteierskapsrettighet for AI-utkast.
Hvordan få koblingen
Magento Connector er en betalt modul. Du kan få den på to måter:
- Kjøp Magento Connector for 18 EUR som en engangslisens for én FreeScout-installasjon, og lim deretter inn lisensnøkkelen i innstillingene for connectoren.
- Bruk en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderer koblingen uten ekstra kostnad.
Kjøp lisensen eller last ned connectoren fra ReplyRabbit-dashbord. Besøk prisside for alternativer for ReplyRabbit-planer. Hvis en aktiv ReplyRabbit Pro- eller Team-plan dekker installasjonen, fungerer koblingen når den er konfigurert, uten en separat lisensnøkkel.
Feilsøking
| Symptom | Hva du bør sjekke |
|---|---|
| Ordresidepanelet vises ikke | Bekreft at basis-URL-en og tilgangstokenet i koblingsinnstillingene er riktige, og at postkassepanelet er aktivert. |
| HTTP 404 fra butikken | ReplyRabbit Connector-modulen er ikke installert eller aktivert. Kjør på nytt bin/magento module:enable Moogento_SupportData og bin/magento setup:upgrade, og tøm deretter hurtigbufferen. |
| HTTP 401 eller 403 fra butikken | Integrasjonen er ikke aktivert, tokenet er regenerert, eller integrasjonen mangler ReplyRabbit Connector API ressurs. Aktiver integrasjonen på nytt og lim inn gjeldende token. |
| "Tilkobling avvist" eller tidsavbruddsfeil | Sjekk at FreeScout-serveren kan nå butikk-URL-en din over HTTPS. Brannmurer, IP-tillatelseslister eller vedlikeholdsmodus kan blokkere forespørselen. |
| Basis-URL avvises | Butikken må leveres over HTTPS. En vanlig http:// URL eller en utilgjengelig vert avvises. |
| Ordrer er tomme for en kjent kunde | Bekreft at kundens e-post i FreeScout-samtalen samsvarer med e-posten på Magento-ordrene deres, og at butikk-ID-en (hvis angitt) samsvarer med butikken de bestilte fra. |
| Ordrelinjer, økonomi eller CLV vises ikke | Bekreft at lisensnøkkelen for koblingen er lagret, eller at en aktiv ReplyRabbit Pro- eller Team-plan dekker installasjonen. |
| Produkteierskapskontekst vises ikke i utkast | Bekreft at koblingen er lisensiert, at ReplyRabbit er installert, at koblingen returnerer ordrer, og at AI-kontekstfunksjonen er aktivert for postkassen. |
For bredere problemer, se Feilsøking av ReplyRabbit.
Personvern og datahåndtering
Når koblingen spør Magento, sender den kundens e-postadresse til din egen Magento-butikk over HTTPS. Ordredataene som returneres fra butikken din, fyller FreeScout-sidepanelet og bygger, med ReplyRabbit, AI-konteksten for utkast.
Integrasjonstokenet trenger bare den skrivebeskyttede ReplyRabbit Connector API ressurs, så koblingen skriver aldri til butikken din. Tokenet lagres kryptert i FreeScout, og utgående forespørsler verifiserer TLS og følger ingen omdirigeringer.
Ingen Magento-ordredata sendes til tredjeparter unntatt gjennom AI-leverandøren som er valgt for postkassen, og bare når AI-kontekstfunksjonen bruker dem. Hvis policyen din krever at ordredata skal holde seg helt på dine egne servere, bruk en lokal AI-leverandør (for eksempel Ollama) for postkassen.
Neste trinn
- Fullfør Hvordan sette opp ReplyRabbit hvis postkassen fortsatt trenger leverandør-, kontekst- eller stilinnstillinger.
- Også på WooCommerce? Se WooCommerce-kobling guide.
FAQ
Trenger jeg en Magento-modul for koblingen?
Ja. Connectoren leser et support-summary-endepunkt som ReplyRabbit Connector-modulen legger til i Magento 2 REST API. Det er to nedlastinger, Magento-modulen og FreeScout Magento connector-modulen, begge tilgjengelige fra ReplyRabbit-kontoen din.
Hvilke Magento-versjoner støttes?
Magento 2.4 og nyere, inkludert Magento Open Source og Adobe Commerce, på PHP 8.0 til og med 8.4. Magento 1 støttes ikke.
Hvor mye koster Magento-koblingen?
Magento Connector er inkludert med en aktiv ReplyRabbit Pro- eller Team-plan. Ellers koster den 18 EUR som en engangslicens for én FreeScout-installasjon. Hvis du kjøper den, lim inn lisensnøkkelen i koblingsinnstillingene.
Hvilken tillatelse trenger tilgangstokenet?
Bare ReplyRabbit Connector API-ressursen, som er skrivebeskyttet. Koblingen skriver aldri til butikken din, så integrasjonen trenger ingen andre administratortillatelser.
Kan hver FreeScout-postkasse kobles til en annen Magento-butikk?
Ja. Hver postkasse lagrer sin egen base URL, access token og valgfrie store ID i connector-innstillingene, så ulike butikker eller butikkvisninger kan kobles til ulike postkasser.