Magento-anslutning
Fungerar med Magento
Anslut Magento 2 eller Adobe Commerce till FreeScout så att konversationer visar matchade kundorder och köpkontext. En liten skrivskyddad Magento-modul exponerar en supportsammanfattning via Magento REST API, och FreeScout-anslutningen visar den i konversationens sidopanel. ReplyRabbit matar också in produktägarskapskontext i AI-lagret så att utkast kan referera till vad en kund har köpt.
Letar du efter översikten?
Översikt
Magento-anslutningen lägger till ett ordersidofält i FreeScout-konversationer. När en konversation har en kund-e-postadress anropar anslutningen moo-support/summary endpoint på din Magento-butik för att matcha ordrar och visar dem bredvid konversationen.
Sidofältet visar en kundpanel, fullständig orderhistorik, orderrader per order med antal och priser, ekonomiska summor, kundens livstidsvärde (CLV), genomsnittligt ordervärde (AOV) och produktäganderätt som flödar in i ReplyRabbit AI-kontexten för mer relevanta utkast.
Det finns två komponenter att installera:
- Den ReplyRabbit Connector-modul för Magento 2. Den lägger till två skrivskyddade REST-endpoints (
/rest/V1/moo-support/summaryoch/rest/V1/moo-support/purchased-products) bakom en dedikerad admin-behörighet som kallas ReplyRabbit Connector API. Det ändrar inte butiksfronten eller kassan. - Den FreeScout Magento-anslutningsmodul. Det anropar dessa slutpunkter över HTTPS med en Magento-integrationsåtkomsttoken och renderar ordersidofältet. Det har sin egen inställningssida per brevlåda i FreeScout.
Ordersidofältet fungerar på egen hand. Produktägarskapsbehörigheten som flödar in i AI-utkast är den del som använder ReplyRabbit.
Förutsättningar
Innan du börjar, se till att du har:
- En fungerande FreeScout-installation.
- En Magento 2.4 eller senare butik (Magento Open Source eller Adobe Commerce) nåbar över HTTPS, med SSH-åtkomst för att köra Magento CLI-kommandon.
- Magento-administratörsåtkomst för att skapa en integration.
- ReplyRabbit installerat och aktiverat om du vill ha produktägandekontext i AI-utkast.
- En Magento Connector-licens (18 EUR engångsbelopp, för en FreeScout-installation), eller en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderar den.
Om ReplyRabbit inte är installerat än, börja med Hur du installerar ReplyRabbit-modulen, sedan slutför Hur du konfigurerar ReplyRabbit.
Installera Magento-modulen
Ladda ner Magento-modulen
Logga in på app.replyrabbit.app och ladda ner Magento-modulens ZIP från Magento-anslutningskortet.Packa upp det i app/code
Ladda upp ZIP-filen till din Magento-rot och packa upp den. Den skaparapp/code/Moogento/SupportData.Aktivera modulen
Från Magento-roten, kör:På en butik i produktionsläge, kör ävenbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploysom du skulle göra för vilken modulinstallation som helst.
Composer-installationer
moogento/m2-supportdata från Moogento-paketarkivet. ZIP-installationen ovan kräver inga Composer-uppgifter.Skapa en Magento-integrationstoken
Anslutningen autentiserar med en åtkomsttoken från en Magento-integration. Skapa en med begränsning till modulens skrivskyddade behörighet.
Öppna Integrationer
I Magento-administrationen, gå till System, sedan Tillägg, sedan Integrationer, och klicka på Lägg till ny integration.Namnge den och ställ in API-omfånget
Ange ett namn som "ReplyRabbit Connector" och ditt adminlösenord. På API fliken, ställ in Resursåtkomst till Anpassad och markera endast ReplyRabbit Connector API (under den översta admin-trädstrukturen). Spara.Aktivera och kopiera åtkomsttoken
Klicka Aktivera bredvid den nya integrationen och sedan Tillåt. Kopiera Åtkomsttoken. Magento visar token i integrationsdetaljerna, så du kan återvända till den senare.
Läsbehörighet
Installera FreeScout-anslutningsmodulen
FreeScout Magento-anslutningsmodulen anropar Magento-slutpunkterna och renderar ordersidofältet i konversationer. Det är en egen modul med egna inställningar, separat från ReplyRabbit.
Ladda ner anslutningsmodulen
Logga in på app.replyrabbit.app för att ladda ner FreeScout-anslutningsmodulens ZIP. Båda nedladdningarna visas när du har köpt anslutningen eller har en aktiv ReplyRabbit Pro- eller Team-plan.Ladda upp till FreeScout
I FreeScout, gå till Moduler, klicka på uppladdningsknappen, välj ZIP-filen och installera den.Aktivera modulen
Aktivera Magento-integration modul från modullistan.
Konfigurera per brevlåda
När modulen är installerad ansluter du den till din butik på connectorns egen inställningssida per brevlåda.
Öppna inställningarna för anslutningen
I FreeScout, öppna brevlådan som ska visa Magento-orderdata, öppna menyn för brevlådeinställningar och välj Butiksanslutning. Detta är Magento-anslutningens inställningssida, inte ett avsnitt inuti ReplyRabbit-inställningarna.Ange Magento-bas-URL:en
Klistra in bas-URL:en för din Magento-butik över HTTPS, till exempelhttps://your-store.com. Ett avslutande snedstreck behövs inte.Ange åtkomsttoken
Klistra in Åtkomsttoken från Magento-integrationen. Den lagras krypterad, och endast en maskerad förhandsvisning visas efter sparning.Ange butiks-ID (valfritt)
Lämna tomt för att matcha ordrar i alla butiker. Ange ett Magento-butiks-ID för att begränsa sidopanelen till en butik eller butiksvy.Lägg till din connector-licensnyckel
Om du köpte anslutningsmodulen anger du dess licensnyckel. Hoppa över detta steg om en aktiv ReplyRabbit Pro- eller Team-plan täcker installationen.Spara och testa
Spara inställningarna. Öppna en FreeScout-konversation där kundens e-post matchar en Magento-order och bekräfta att ordersidofältet visas.
Varje FreeScout-brevlåda lagrar sin egen bas-URL, åtkomsttoken och butiks-ID, så du kan ansluta olika brevlådor till olika Magento-butiker eller butiksvyer.
Vad anslutningen visar
- En kundpanel för personen i konversationen.
- Fullständig orderhistorik med ordernummer, datum, status och totalsumma.
- Radposter per order med kvantiteter och priser.
- Ekonomiska summor (delsumma, rabatt, frakt, skatt, återbetalningar).
- Kundlivstidsvärde (CLV) och genomsnittligt ordervärde (AOV).
- Rättighet till produktägande för AI-utkast.
Hur du får anslutningen
Magento Connector är en betald modul. Du kan få den på två sätt:
- Köp Magento Connector för 18 EUR som en engångslicens för en FreeScout-installation och klistra sedan in dess licensnyckel i connectorinställningarna.
- Använd en aktiv ReplyRabbit Pro- eller Team-plan, som inkluderar anslutningen utan extra kostnad.
Köp licensen eller ladda ner connectorn från ditt ReplyRabbit-instrumentpanel. Besök prissidan för alternativ för ReplyRabbit-planer. Om en aktiv ReplyRabbit Pro- eller Team-plan täcker installationen fungerar anslutningen när den är konfigurerad, utan separat licensnyckel.
Felsökning
| Symptom | Vad man ska kontrollera |
|---|---|
| Order-sidofältet visas inte | Bekräfta att bas-URL:en och åtkomsttoken i kopplingens inställningar är korrekta och att brevlådepanelen är aktiverad. |
| HTTP 404 från butiken | Modulen ReplyRabbit Connector är inte installerad eller aktiverad. Kör om bin/magento module:enable Moogento_SupportData och bin/magento setup:upgrade, rensa sedan cachen. |
| HTTP 401 eller 403 från butiken | Integrationen är inte aktiverad, token har återskapats, eller så saknar integrationen ReplyRabbit Connector API resurs. Återaktivera integrationen och klistra in den aktuella token. |
| "Connection refused" eller timeout-fel | Kontrollera att FreeScout-servern kan nå din butiks-URL över HTTPS. Brandväggar, IP-tillåtelselistor eller underhållsläge kan blockera begäran. |
| Bas-URL avvisas | Butiken måste serveras över HTTPS. En vanlig http:// URL eller en oåtkomlig värd nekas. |
| Ordrar är tomma för en känd kund | Bekräfta att kundens e-postadress i FreeScout-konversationen matchar e-postadressen på deras Magento-beställningar och att butiks-ID:t (om angivet) matchar butiken de beställde från. |
| Radposter, ekonomi eller CLV visas inte | Bekräfta att kopplingens licensnyckel är sparad, eller att en aktiv ReplyRabbit Pro- eller Team-plan täcker installationen. |
| Kontext om produktägande visas inte i utkast | Bekräfta att kopplingen är licensierad, att ReplyRabbit är installerat, att kopplingen returnerar beställningar och att AI-kontextfunktionen är aktiverad för brevlådan. |
För bredare problem, se Felsökning av ReplyRabbit.
Integritet och datahantering
När anslutningen frågar Magento skickar den kundens e-postadress till din egen Magento-butik över HTTPS. Orderdata som returneras från din butik fyller FreeScout-sidopanelen och, med ReplyRabbit, bygger AI-kontextet för utkast.
Integrationstoken behöver bara den skrivskyddade ReplyRabbit Connector API resurs, så anslutningen skriver aldrig till din butik. Token lagras krypterad i FreeScout, och utgående förfrågningar verifierar TLS och följer inga omdirigeringar.
Inga Magento-beställningsdata skickas till tredje part utom via den AI-leverantör som valts för postlådan, och endast när AI-kontextfunktionen använder dem. Om din policy kräver att beställningsdata stannar helt på dina egna servrar använder du en lokal AI-leverantör (till exempel Ollama) för postlådan.
Nästa steg
- Slutför Hur du konfigurerar ReplyRabbit om mailboxen fortfarande behöver leverantörs-, kontext- eller stilinställningar.
- Även på WooCommerce? Se WooCommerce-anslutning guide.
Vanliga frågor
Behöver jag en Magento-modul för anslutningen?
Ja. Anslutningen läser en support-summary-endpoint som ReplyRabbit Connector-modulen lägger till i Magento 2 REST API. Det finns två nedladdningar, Magento-modulen och FreeScout Magento-anslutningsmodulen, båda tillgängliga från ditt ReplyRabbit-konto.
Vilka Magento-versioner stöds?
Magento 2.4 och senare, inklusive Magento Open Source och Adobe Commerce, på PHP 8.0 till 8.4. Magento 1 stöds inte.
Hur mycket kostar Magento Connector?
Magento Connector ingår med en aktiv ReplyRabbit Pro- eller Team-plan. Annars kostar den 18 EUR som en engångslicens för en FreeScout-installation. Om du köper den, klistra in dess licensnyckel i anslutningens inställningar.
Vilken behörighet behöver åtkomsttoken?
Endast ReplyRabbit Connector API-resursen, som är skrivskyddad. Anslutningen skriver aldrig till din butik, så integrationen behöver inga andra adminbehörigheter.
Kan varje FreeScout-brevlåda ansluta till en annan Magento-butik?
Ja. Varje brevlåda lagrar sin egen bas-URL, åtkomsttoken och valfria butiks-ID i anslutningsinställningarna, så olika butiker eller butiksvyer kan ansluta till olika brevlådor.