Magento-connector
Werkt met Magento
Verbind Magento 2 of Adobe Commerce met FreeScout zodat gesprekken overeenkomende klantorders en aankoopcontext tonen. Een kleine alleen-lezen Magento-module biedt een supportsamenvatting via de Magento REST API, en de FreeScout-connector toont deze in de gesprekszijbalk. ReplyRabbit voert ook producteigendomcontext aan de AI-laag zodat concepten kunnen verwijzen naar wat een klant heeft gekocht.
Op zoek naar het overzicht?
Overzicht
De Magento-connector voegt een bestelzijbalk toe aan FreeScout-gesprekken. Wanneer een gesprek een e-mailadres van een klant heeft, roept de connector de moo-support/summary endpoint op je Magento-winkel voor het matchen van bestellingen en toont deze naast het gesprek.
De zijbalk toont een klantenpaneel, volledige ordergeschiedenis, regelitems per order met aantallen en prijzen, financiële totalen, customer lifetime value (CLV), gemiddelde orderwaarde (AOV) en producteigendom-rechten die doorstromen naar de ReplyRabbit AI-context voor relevantere concepten.
Er zijn twee componenten te installeren:
- De ReplyRabbit Connector-module voor Magento 2. Het voegt twee alleen-lezen REST-endpoints toe (
/rest/V1/moo-support/summaryen/rest/V1/moo-support/purchased-products) achter een speciale admin-machtiging genaamd ReplyRabbit Connector API. Het wijzigt de winkel of het afrekenen niet. - De FreeScout Magento-connectormodule. Het roept die endpoints aan via HTTPS met een Magento-integratietoegangstoken en toont de bestellingszijbalk. Het heeft een eigen instellingenpagina per mailbox in FreeScout.
De orderzijbalk werkt op zichzelf. Het producteigendom-recht dat naar AI-concepten stroomt, is het deel dat ReplyRabbit gebruikt.
Vereisten
Voordat je begint, zorg dat je het volgende hebt:
- Een werkende FreeScout-installatie.
- Een Magento 2.4 of nieuwere winkel (Magento Open Source of Adobe Commerce) bereikbaar via HTTPS, met SSH-toegang om Magento CLI-commando's uit te voeren.
- Magento-beheerderstoegang om een Integration te maken.
- ReplyRabbit geïnstalleerd en geactiveerd als je producteigendom-context in AI-concepten wilt.
- Een Magento Connector-licentie (18 EUR eenmalig, voor één FreeScout-installatie), of een actief ReplyRabbit Pro- of Team-abonnement, dat deze bevat.
Als ReplyRabbit nog niet is geïnstalleerd, begin dan met Hoe je de ReplyRabbit-module installeert, en voltooi dan Hoe je ReplyRabbit instelt.
Installeer de Magento-module
Magento-module downloaden
Log in op app.replyrabbit.app en download de Magento-module ZIP van de Magento-connector-kaart.Pak het uit in app/code
Upload de ZIP naar je Magento-root en pak het uit. Het maaktapp/code/Moogento/SupportData.De module inschakelen
Voer vanuit de Magento-root uit:Op een winkel in productiemodus, voer ook uitbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deployzoals je bij elke module-installatie zou doen.
Composer-installaties
moogento/m2-supportdata uit de Moogento-pakketrepository. De ZIP-installatie hierboven vereist geen Composer-inloggegevens.Een Magento-integratietoken aanmaken
De connector authenticeert met een toegangstoken van een Magento Integration. Maak er een aan met de alleen-lezen toestemming van de module.
Integraties openen
Ga in de Magento-beheeromgeving naar Systeem, dan Extensies, dan Integraties, en klik op Nieuwe integratie toevoegen.Geef het een naam en stel het API-bereik in
Voer een naam in zoals "ReplyRabbit Connector" en je beheerderswachtwoord. Op de API tabblad, stel Resourcetoegang naar Aangepast en vink alleen ReplyRabbit Connector API (onder de admin-boom op het hoogste niveau). Sla op.Activeer en kopieer het toegangstoken
Klik Activeren naast de nieuwe integratie, en vervolgens Toestaan. Kopieer de Toegangstoken. Magento toont het token in de integratiedetails, zodat je er later naar kunt terugkeren.
Alleen-lezen toegang
Installeer de FreeScout-connector-module
De FreeScout Magento-connector-module roept de Magento-endpoints aan en toont de bestelzijbalk in gesprekken. Het is een eigen module met eigen instellingen, los van ReplyRabbit.
De connector-module downloaden
Log in op app.replyrabbit.app om de FreeScout-connector-module-ZIP te downloaden. Beide downloads verschijnen zodra je de connector hebt gekocht of een actief ReplyRabbit Pro- of Team-plan hebt.Uploaden naar FreeScout
Ga in FreeScout naar Modules, klik op de uploadknop, kies de ZIP en installeer deze.Activeer de module
Activeer de Magento-integratie module uit de modulelijst.
Per mailbox configureren
Nadat de module is geïnstalleerd, verbind je deze met je winkel op de eigen per-mailbox instellingenpagina van de connector.
Open de connectorinstellingen
Open in FreeScout de mailbox die Magento-ordergegevens moet tonen, open het menu met mailboxinstellingen en kies Winkelconnector. Dit is de instellingenpagina van de Magento-connector, geen sectie binnen de ReplyRabbit-instellingen.Voer de Magento-basis-URL in
Plak de basis-URL van je Magento-winkel via HTTPS, bijvoorbeeldhttps://your-store.com. Een afsluitende schuine streep is niet nodig.Voer het toegangstoken in
Plak de Toegangstoken van de Magento-integratie. Het wordt versleuteld opgeslagen en na opslaan wordt alleen een gemaskeerd voorbeeld getoond.Stel de winkel-ID in (optioneel)
Laat leeg om orders in alle winkels te matchen. Voer een Magento-winkel-ID in om de zijbalk te beperken tot één winkel of winkelweergave.Voeg je connectorlicentiesleutel toe
Als je de connector hebt gekocht, voer dan de licentiesleutel in. Sla deze stap over als een actief ReplyRabbit Pro- of Team-plan de installatie dekt.Opslaan en testen
Sla de instellingen op. Open een FreeScout-gesprek waarin het klant-e-mailadres overeenkomt met een Magento-order en bevestig dat de orderzijbalk verschijnt.
Elke FreeScout-mailbox slaat zijn eigen basis-URL, access token en store-ID op, zodat u verschillende mailboxen aan verschillende Magento-winkels of store views kunt koppelen.
Wat de connector toont
- Een klantpaneel voor de persoon in het gesprek.
- Volledige bestelgeschiedenis met ordernummer, datum, status en totaal.
- Regelitems per bestelling met aantallen en prijzen.
- Financiële totalen (subtotaal, korting, verzending, belasting, terugbetalingen).
- Customer lifetime value (CLV) en gemiddelde orderwaarde (AOV).
- Producteigendom-recht voor AI-concepten.
Hoe je de connector krijgt
De Magento Connector is een betaalde module. Je kunt hem op twee manieren krijgen:
- Koop de Magento Connector voor 18 EUR als eenmalige licentie voor één FreeScout-installatie en plak daarna de licentiesleutel in de connectorinstellingen.
- Gebruik een actief ReplyRabbit Pro- of Team-plan, dat de connector zonder extra kosten bevat.
Koop de licentie of download de connector vanuit je ReplyRabbit-dashboard. Bezoek de prijzenpagina voor ReplyRabbit-planopties. Als een actief ReplyRabbit Pro- of Team-plan de installatie dekt, werkt de connector zodra deze is geconfigureerd, zonder aparte licentiesleutel.
Probleemoplossing
| Symptoom | Wat te controleren |
|---|---|
| Bestelzijbalk verschijnt niet | Bevestig dat de basis-URL en het toegangstoken in de connectorinstellingen correct zijn en dat het mailboxpaneel is ingeschakeld. |
| HTTP 404 van de winkel | De ReplyRabbit Connector-module is niet geïnstalleerd of ingeschakeld. Voer opnieuw uit bin/magento module:enable Moogento_SupportData en bin/magento setup:upgrade, en leeg vervolgens de cache. |
| HTTP 401 of 403 van de winkel | De integratie is niet geactiveerd, het token is opnieuw gegenereerd, of de integratie mist de ReplyRabbit Connector API resource. Reactiveer de integratie en plak het huidige token. |
| "Connection refused" of time-outfout | Controleer of de FreeScout-server je winkel-URL via HTTPS kan bereiken. Firewalls, IP-allowlists of onderhoudsmodus kunnen het verzoek blokkeren. |
| Base-URL wordt geweigerd | De winkel moet via HTTPS worden aangeboden. Een gewone http:// URL of een onbereikbare host wordt geweigerd. |
| Bestellingen zijn leeg voor een bekende klant | Bevestig dat het klant-e-mailadres in het FreeScout-gesprek overeenkomt met het e-mailadres in hun Magento-bestellingen en dat de winkel-ID (indien ingesteld) overeenkomt met de winkel waar ze hebben besteld. |
| Regelitems, financiën of CLV worden niet getoond | Bevestig dat de licentiesleutel van de connector is opgeslagen, of dat een actief ReplyRabbit Pro- of Team-plan de installatie dekt. |
| Producteigendom-context verschijnt niet in concepten | Bevestig dat de connector is gelicentieerd, ReplyRabbit is geïnstalleerd, de connector bestellingen retourneert en de AI-contextfunctie is ingeschakeld voor de mailbox. |
Voor bredere problemen, zie Probleemoplossing ReplyRabbit.
Privacy en gegevensverwerking
Wanneer de connector Magento bevraagt, stuurt hij het e-mailadres van de klant via HTTPS naar je eigen Magento-winkel. De ordergegevens die je winkel retourneert, vullen de FreeScout-zijbalk en bouwen, met ReplyRabbit, de AI-context voor concepten op.
Het integratietoken heeft alleen de alleen-lezen ReplyRabbit Connector API resource, zodat de connector nooit naar je winkel schrijft. Het token wordt versleuteld opgeslagen in FreeScout en uitgaande verzoeken verifiëren TLS en volgen geen redirects.
Er worden geen Magento-bestelgegevens naar derden verzonden, behalve via de AI-provider die voor de mailbox is geselecteerd, en alleen wanneer de AI-contextfunctie deze gebruikt. Als je beleid vereist dat bestelgegevens volledig op je eigen servers blijven, gebruik dan een lokale AI-provider (zoals Ollama) voor de mailbox.
Volgende stappen
- Voltooien Hoe je ReplyRabbit instelt als de mailbox nog provider-, context- of stijlinstellingen nodig heeft.
- Ook op WooCommerce? Zie de WooCommerce-connector handleiding.
FAQ
Heb ik een Magento-module nodig voor de connector?
Ja. De connector leest een support-summary-endpoint dat de ReplyRabbit Connector-module toevoegt aan de Magento 2 REST API. Er zijn twee downloads, de Magento-module en de FreeScout Magento-connector-module, beide beschikbaar vanuit je ReplyRabbit-account.
Welke Magento-versies worden ondersteund?
Magento 2.4 en later, inclusief Magento Open Source en Adobe Commerce, op PHP 8.0 tot en met 8.4. Magento 1 wordt niet ondersteund.
Hoeveel kost de Magento Connector?
De Magento Connector is inbegrepen bij een actief ReplyRabbit Pro- of Teamplan. Anders kost hij 18 EUR als eenmalige licentie voor één FreeScout-installatie. Als je hem koopt, plak je de licentiesleutel in de connectorinstellingen.
Welke machtiging heeft het toegangstoken nodig?
Alleen de ReplyRabbit Connector API-resource, die alleen-lezen is. De connector schrijft nooit naar je winkel, dus de integratie heeft geen andere beheerdersrechten nodig.
Kan elke FreeScout-mailbox verbinden met een andere Magento-winkel?
Ja. Elk mailbox slaat zijn eigen basis-URL, toegangstoken en optionele winkel-ID op in de connectorinstellingen, zodat verschillende winkels of winkelweergaven verbinding kunnen maken met verschillende mailboxen.