Hoe stel ik de Clang niewsbrief provider in?

Het is mogelijk om vanuit RetailVista Pos en RetailVista ERP automatische email adressen aan te melden bij Clang. Dit gaat doormiddel van een aantal settings en het juist instellen van een "nieuwsbrief provider" in RetailVista.

Nieuwsbrief provider instellen

• Ga naar "Nieuwsbrief providers" via Administratie > Promotioneel > Nieuwsbrief providers
• Klik op "Toevoegen"(Alt +n)
• Geef een duidelijke beschrijving voor de provider(Bijvoorbeeld type + klant naam)
• Kies al provider type "Clang"
• Geef bij "URL" de juist URL op voor de Clang API(dit is de webservice binding URL). Dit is voor Clang 1.23: https://login.myclang.com/app/api/soap/public/index.php?version=1.23&type=literal
• De velden "gebruikersnaam" en "wachtwoord" mogen leeg blijven
• Geef bij "Api token" de verkregen token van de klant op. Dit wordt mogelijk ook aangeduid als "uuid".
• Vul bij "Custom parameters" in ieder geval de "campaignId" paramater op. Deze is vereist. Dit ziet er als volgt uit: campaignId=123.
• Zet "enabled" op "Ja". Let op, als deze op "Nee" staat zal de aanmelding nooit plaatsvinden vanuit ERP of POS.

Instellingen

De volgende instellingen moeten worden aangepast om de Clang provider in te schakelen:

• Relaties > Nieuwsbrief > Nieuwsbrief integratie actief : Ja
• Relaties > Nieuwsbrief > Actieve provider : [De eerder aangemaakte provider]
• Relaties > Nieuwsbrief > Automatisch aanmelden vanuit ERP : Ja
• Point of sale > Geavanceerd > Vragen voor inschrijven nieuwsbrief : Ja

Handig om te weten:

Als de setting "Automatisch aanmelden vanuit ERP" op ja staat, leid elke mutatie en het aanmaken van een email adres van een klant waarbij de "nieuwsbrief status" op "geaccepteerd" staat tot het versturen van dit adres naar Clang.

Heeft het status veld een andere waarde dan wordt het adres niet verstuurd. Tevens leid het aanpassen van dit veld ook niet tot het automatisch toevoegen van de email adressen van de klant.

Overige vragen

Wat is Clang?

Clang is een platform waar vanuit nieuwsbrieven gestuurd kunnen worden. Meer informatie: https://www.e-village.nl/clang

Wat wordt aangeroepen binnen Clang?

Binnen Clang wordt "campaign_execute" aangeroepen met het opgegeven ID in de settings van de provider. Binnen Clang kunnen aan een "campaign" vervolg acties worden aangeroepen.

Kan ik extra parameters meegeven aan de aanroep binnen Clang?

Het is mogelijk om extra paramaters op te geven bij het maken van een "campaign" binnen Clang. Binnen RetailVista kunnen deze extra paramaters worden opgegeven in het "Custom parameters" veld van de "Nieuwsbrief provider". De paramaters worden met een pipe(|) teken gescheiden. de parameternaam en waarde worden gescheiden door een is(=) teken. Extra parameters kunnen er bijvoorbeeld zo uitzien: test1=2|test2=foo

De Clang provider zal parameters die niet bekend zijn binnen de code automatisch doorzetten naar het "options" object in de "campaign_execute" functie.

Wat als toevoegen van een mail adres mislukt?

In de huidige code wordt een foutmelding ingeslikt door de Retail3000 kernel en zal deze niet naar buiten komen. Er is hiervoor gekozen omdat dit een niet blokkerend proces moet zijn.