Analyse van interfacefouten van CleverReach-interfaces

We ontwikkelen voortdurend plugins en interfaces voor het koppelen van een extern systeem (bijv. CRM, CMS of winkelsystemen) en onze e-mailmarketingtool CleverReach. Met onze plugins kun je in een paar stappen snel een verbinding maken tussen beide systemen en aan de slag met je e-mailmarketing. Onze plugins zijn allemaal gratis (behalve PrestaShop) en worden regelmatig bijgewerkt.

Deze help center post dient uitsluitend voor de analyse van foutmeldingen voor de CleverReach plugins voor Shopware 5, Shopware 6, WordPress, WooCommerce, Typo3, Joomla!, Zapier, lexoffice, OpenCart, Prestashop, Magento 2, Shopify, XTCommerce, BigCommerce, Ecwid, ZohoCRM, Drupal en Oxid. 

Andere plugins worden aangeboden door externe leveranciers. Als je foutmeldingen krijgt, wend je dan tot de ontwikkelaar of leverancier van de betreffende plugin. Zij kunnen je zo snel mogelijk helpen. Alvast bedankt.

We beginnen dit bericht met een checklist met de belangrijkste criteria voor jou, daarna zetten we de meest voorkomende foutmeldingen op een rij en beantwoorden we veelgestelde vragen. Als onze lijst je probleem niet oplost, of als je andere problemen of vragen hebt, geven we je aan het einde van het bericht een lijst met opmerkingen en contactgegevens.

Checklist

1. Gebruik je de nieuwste versie van de plugin?

Je kunt de laatste versie van de plugin altijd direct vinden in je plugin manager door te zoeken naar "CleverReach".

2. Is de plugin aangesloten en geactiveerd?

Controleer of de plugin correct is verbonden met je account. Navigeer naar de plugin in je pluginbeheer. Als je een melding krijgt dat je de plugin met je account moet verbinden, is deze nog niet verbonden. Maak verbinding met de plugin. Controleer ook of de plugin is geactiveerd in je Pluginbeheer.  

3. Accountgegevens

Heb je al je accountgegevens ingevoerd via het profielpictogram >[Mijn account -> Instellingen -> Mijn gegevens]

Je kunt pas een succesvolle verbinding tot stand brengen als je al je gegevens hebt ingevoerd.

4. API-toegang voor de gebruiker

Heb je "REST API" toegang geactiveerd voor de gebruiker die verbinding maakt met CleverReach via de plugin? Je vindt de instructies hier.

5. Toegangsbeperkingen

De winkel moet direct toegankelijk zijn via internet. Er mag geen HTACCESS actief zijn die de toegang tot de winkel of plugin beperkt.

Zorg ervoor dat alle bestanden van de plugin algemene rechten hebben zodat de plugin gegevens kan verzenden en ontvangen. 

6. Technische vereisten

De winkel of server moet CURL kunnen verwerken en uitvoeren. 

De browser waarmee u verbinding probeert te maken moet de nieuwste versie van Chrome of Firefox zijn. 

Algemene foutmeldingen

"Slecht verzoek: maximum aantal kenmerken overschreden":

U hebt te veel gegevensvelden gemaakt in uw CleverReach-account. Je kunt maximaal 45 gegevensvelden maken. De plugin maakt automatisch 17 gegevensvelden aan tijdens de eerste synchronisatie, bijv. voor- en achternaam, adresgegevens, enz.

Verwijder gegevensvelden uit uw CleverReach-account die niet zijn ingevuld of niet langer nodig zijn. Daarna zou de foutmelding verdwenen moeten zijn.

"(InitialSyncTask) mislukt vanwege verlengde inactiviteitsperiode":

Synchronisatie duurt langer dan verwacht. Het kan bijvoorbeeld helpen om de time-out in de winkel te verhogen.

  1. Pas de PHP-configuratie (php.ini bestand) aan op de shopserver.
    1. Stel de variabele max_execution_time in op 300 (5 minuten),
    2. stel dan de PHP variabele max_input_vars in op 10000
    3. en start dan de eerste import opnieuw

"Kan juiste URL niet bepalen. Shop niet correct geconfigureerd of plugin niet actief!".

Deze foutmelding betekent dat de shop URL en shop configuratie URL niet identiek zijn.

Ga naar de instellingen van je winkel en kijk naar de URL van de winkel en vergelijk deze met de URL in de adresbalk van je browser. De URL's moeten hetzelfde zijn.  

Als ze niet identiek zijn, log dan in via de URL in de winkelconfiguratie.

Veelgestelde vragen

Vraag: Niet al mijn ontvangers worden overgedragen. Wat kan ik doen?

Antwoord: Dit hangt af van de versie van de plugin. De laatste versie van onze plugins zet al je ontvangers over als actieve ontvangers, als ze geabonneerde nieuwsbriefontvangers zijn in je systeem, inclusief Double Opt in.

Alle andere ontvangers - kopers enz. - worden ook overgebracht naar CleverReach als actieve ontvangers wanneer u onze v3 plugins gebruikt.

Vraag: We hebben enorme prestatieproblemen wanneer we de CleverReach Shopware-plugin gebruiken. De prestaties van de winkel zijn extreem traag. Waarom is dat?

Antwoord: De meest waarschijnlijke reden waarom je winkel langzamer draait dan normaal kan te wijten zijn aan de asynchrone controle van onze plugin. Elke 5 seconden controleert het systeem of er nieuwe ontvangergegevens, bestellingen, tags, enz. moeten worden overgedragen.

Op deze manier zorgen we voor de live synchronisatie in onze plugin. Als je bijvoorbeeld onze marketingautomatisering gebruikt en je wilt een automatisering activeren nadat een klant zich heeft aangemeld of iets heeft gekocht, dan is de live synchronisatie heel belangrijk om onmiddellijk een e-mail te versturen.

De CleverReach plugin voert de meeste taken op de achtergrond uit. Om de taken op de achtergrond te detecteren en te starten, simuleert de CleverReach plugin langlopende (achtergrond)processen door asynchroon "background worker web requests" aan te roepen met een minimale vertraging van 5 seconden tussen twee opeenvolgende aanroepen.

Dit betekent dat de plugin de webverzoeken (d.w.z. de URL van de voorkant) elke 5 seconden naar zichzelf stuurt. Als u wilt, kunnen we deze periode ook verhogen naar een willekeurig tijdsinterval, maar dit zou betekenen dat de wijzigingen in de winkel een bepaalde tijd nodig hebben (tijdsinterval dat de klant wil instellen) om te worden overgedragen naar CleverReach.

Het tijdsinterval van 5 seconden is de standaardwaarde voor al onze klanten (omdat we de gegevens naar CleverReach willen sturen zodra ze in de winkel verschijnen).Als u de periode wilt aanpassen of wij kunnen dit voor u doen, stuur ons dan een e-mail of stuur een verzoek met alle info zoals hieronder beschreven. Bij voorbaat dank.

Vraag: De verbinding tussen de plugin en CleverReach werkt niet.

Mogelijk antwoord: Als u extra authorisatie (htaccess) gebruikt op uw server, is het noodzakelijk om de CleverReach plugin URL's publiek toegankelijk te maken. De volgende URL's moeten toegankelijk zijn vanaf het internet als u bijvoorbeeld Shopware 5 gebruikt:

{shop_url}/CleverReachAsyncProcess/run

{shop_url}/CleverReachAuth/redirectCallback

{shop_url}/CleverReachAutomationEventsController/handle

{shop_url}/CleverReachBlogSearch/zoeken

{shop_url}/CleverReachFormEventsController/webhookHandle

{shop_url}/CleverReachFormulieren/formulier

{shop_url}/CleverReachProductZoek/Zoek

{shop_url}/CleverReachReceiverEventsController/webhookHandle

{shop_url}/CleverReachSearch/product zoeken

{shop_url}/CleverReachWebhooks/verwerkWebhookRequest

 

Voor elke integratie zijn de URL's anders. Neem contact met ons op als je een andere integratie gebruikt, zodat we je de juiste URL's kunnen sturen. Bij voorbaat hartelijk dank.

Vraag: De autoconfiguratie is mislukt.

Antwoord: De autoconfiguratie wordt uitgevoerd wanneer de module voor het eerst wordt geopend (na de installatie). Dit controleert de bestaande winkelconfiguraties en probeert een interne oproep te maken om de plugin- of winkelinstellingen correct in te stellen.

Dit proces dient om de optimale instelling van de plugin te bepalen en om latere bruikbaarheid te garanderen.

Deze configuraties worden dan opgeslagen en gebruikt voor alle asynchrone procesaanroepen van de plugin.

Als het systeem detecteert dat er iets mis is met de achtergrondprocessen en de taakuitvoering, dan moet het systeem de standaard URL-parameters van de winkel gebruiken en proberen de asynchrone testoproep uit te voeren met de standaard systeemconfiguratie. Als de oproep mislukt, moet het systeem de test herhalen met alle combinaties van de volgende opties:

  1. Verander het aanroepprotocol van HTTP in HTTPS en omgekeerd, afhankelijk van wat standaard werd gebruikt.
  2. Verhoog de timeout van een asynchrone aanroep, omdat sommige systemen een cURL timeout van minder dan een seconde niet accepteren.
  3. De optie om 301/302-omleidingen te volgen instellen/terugzetten.
  4. Gebruik IPv4 of IPv6 IP-omzettingsopties.
  5. Als alle opties met succes zijn uitgevoerd en opgeslagen, wordt u doorgestuurd naar de selectie van de import van de ontvanger.

Als de plugin of jijzelf de winkelinstellingen niet succesvol konden wijzigen, neem dan contact op met ons serviceteam. Alvast bedankt.

Krijg je steeds foutmeldingen of andere dan die in onze lijst? Of wil je contact opnemen met ons serviceteam?

Om uw geval beter te kunnen analyseren, kunt u ons een gedetailleerde foutbeschrijving sturen. Je kunt ons ook schermafbeeldingen sturen waarop de fout zichtbaar is.

Stuur ons voor een gedetailleerde analyse ook de URL van je backend en een gebruikersnaam en wachtwoord. Verder hebben we de FTP-toegangsgegevens voor je server nodig om de analyse snel en succesvol te kunnen uitvoeren.

Alvorens toegang te krijgen tot de externe software vragen wij om bevestiging van onderstaande disclaimer. Hiervoor is een e-mail van de beheerder van het CleverReach account of de accounthouder voldoende:

Hierbij bevestig ik de volgende informatie:

"Ik erken dat CleverReach® alleen e-mailondersteuning verschuldigd is volgens de AVG. Toegang tot mijn systeem is een vrijwillige dienst die verder gaat dan het contract. Dit proces is een hoffelijkheidsrelatie in engere zin, waarvoor CleverReach geen aansprakelijkheid aanvaardt.waarvoor CleverReach geen aansprakelijkheid aanvaardt."

Stuur een e-mail met alle details naar support@cleverreach.com. Onze service helpt je graag op de best mogelijke manier. Alvast bedankt.