Naar de hoofdinhoud

Transactionele e-mails versturen via de API

Ontwerp orderbevestigingen en verzendupdates in Reloadify en laat je webshop ze automatisch versturen.

Geschreven door Francine

Een transactionele e-mail stuur je naar één klant op het moment dat er iets gebeurt. Denk aan een orderbevestiging, een verzendupdate of een wachtwoord-reset. Jij ontwerpt de mail in Reloadify, je webshop bepaalt wanneer hij verstuurd wordt.

Let op: Het menu-item Assets > Transactioneel zie je alleen als je shop via de Reloadify API of Lightspeed is gekoppeld.

Gebruik je Lightspeed? Dan werkt het anders. Lees hiervoor Transactionele e-mails (Lightspeed only).

Zo werkt het

Reloadify weet niet wanneer een order binnenkomt of verzonden wordt. Dat weet alleen je webshop of ordersysteem. Je developer koppelt dat systeem aan Reloadify: bij elke gebeurtenis stuurt het een seintje en Reloadify verstuurt de bijbehorende mail.

Je hebt nodig:

  • per soort bericht een transactionele e-mail;

  • het ID van elke e-mail;

  • een API-sleutel;

  • een developer die de koppeling bouwt.

Een transactionele e-mail aanmaken

  1. Ga naar Assets > Transactioneel.

  2. Klik op Nieuwe e-mail.

  3. Vul een onderwerp in.

  4. Ontwerp de inhoud in de editor en sla op.

  5. Noteer het ID van de e-mail. Je vindt het in de adresbalk: in .../transactional_emails/1755/... is het ID 1755.

Maak per soort bericht één e-mail aan, zoals "Bestelling ontvangen", "Bestelling onderweg" en "Bestelling bezorgd". Voeg je later een nieuwe soort toe? Dan krijgt die een eigen ID en bouwt je developer die ook in.

Let op: Zonder onderwerp of inhoud verstuurt Reloadify de mail niet.

Klant- en bestelgegevens in je e-mail tonen

Het ontwerp komt altijd uit de editor: header, tekst, knoppen en footer. Je webshop stuurt alleen het seintje en de gegevens mee. Met merge-tags toon je de gegevens die per klant of bestelling verschillen.

Klantgegevens

Naam, adres en tags slaat Reloadify op het klantprofiel op. Ook shopnaam en shoplogo zijn beschikbaar. Je vindt deze merge-tags onder Merge tags in de editor, bijvoorbeeld {{ first_name }}.

Wil je extra gegevens over de klant tonen, zoals een klantnummer? Gebruik dan een custom veld:

  1. Ga naar Instellingen > Custom velden. Lees meer in Je eigen afwijkende data synchroniseren met custom velden.

  2. Maak het veld aan, bijvoorbeeld klantnummer.

  3. Plaats de merge-tag in de editor: {{ profile.klantnummer }}.

  4. Geef de exacte veldnaam door aan je developer.

Stuurt je webshop een veld mee dat niet bestaat onder Instellingen > Custom velden? Dan negeert Reloadify dat veld.

Bestelgegevens

Ordernummer, producten, afleveradres en bezorgstatus horen bij één bestelling. Je webshop stuurt ze per e-mail mee. Bestelt een klant twee keer kort na elkaar, dan toont elke mail toch de gegevens van de eigen bestelling.

  1. Spreek met je developer af welke bestelgegevens meegaan en welke merge-tags daarbij horen. Bijvoorbeeld {{ data.order.number }} voor het ordernummer.

  2. Plaats de merge-tags in de editor.

  3. Laat je developer een proefverzending doen, ook met twee bestellingen kort na elkaar voor dezelfde klant.

Het voorbeeld in de editor toont de bestelgegevens leeg. Die gegevens bestaan pas bij een echte verzending.

Tip: Wil je één mail gebruiken voor meerdere bezorgstatussen? Laat je developer de status meesturen bij de bestelgegevens en toon per status een andere tekst met Liquid. Lees meer in Inhoud van e-mails personaliseren met Liquid.

Bestelgegevens in je ontwerp plaatsen

Bestelgegevens beginnen altijd met data. Daarna volgen de namen die je met je developer hebt afgesproken. Bijvoorbeeld {{ data.order.number }} voor het ordernummer of {{ data.shipping.city }} voor de plaats van het afleveradres.

Een bestelling heeft vaak meerdere producten. Toon die met een lijst:

{% for line in data.order.lines %}{{ line.name }} – {{ line.price }}{% endfor %}

Hiermee toont de mail elk product met naam en prijs. Vraag je developer welke namen bij jullie producten horen, zoals name of price.

Let op: Toon je tekst die de klant zelf heeft ingevuld, zoals een adres of opmerking? Voeg dan | escape toe: {{ data.shipping.street | escape }}. Zo voorkom je dat ingetypte tekens de opmaak van je e-mail breken.

Een API-sleutel aanmaken

  1. Ga naar Instellingen > API-inloggegevens.

  2. Klik op Nieuwe API-sleutel.

  3. Kopieer de client ID en de client secret en geef ze aan je developer.

Let op: Met de client ID en client secret verstuurt iedereen mails namens je shop. Zet ze nooit in een chat of e-mail.

Voordat je live gaat

Verstuurt je webshop zelf al orderbevestigingen of verzendmails? Zet die uit zodra de Reloadify-versies live staan. Anders ontvangt je klant elke mail twee keer.

Gebruik transactionele mails alleen voor informatie over een bestelling of account. Ook uitgeschreven klanten ontvangen deze mails. Plaats er daarom geen aanbiedingen, kortingscodes of productaanbevelingen in.

Je shop verstuurt alleen als:

Wie de mail ontvangt

Reloadify zoekt de klant op e-mailadres. Bestaat de klant nog niet, dan maakt Reloadify een nieuw profiel aan. Bestaat de klant al, dan werkt Reloadify naam, tags, adres en custom velden bij.

Uitgeschreven klanten ontvangen transactionele mails wel. Een uitschrijving voor de nieuwsbrief geldt alleen voor marketingmails.

Een klant ontvangt de mail niet als zijn profiel inactief is of zijn e-mailadres gefilterd is. Een transactionele mail activeert een inactief profiel niet opnieuw.

Een profiel wordt inactief:

  • automatisch na een bounce of een geblokkeerde verzending;

  • als je het profiel zelf deactiveert: in het klantprofiel, met de actie Deactiveren in een serie, in bulk via een segment, via de profiel-API of met een CSV-import;

  • als de klant is verwijderd in Shopify of Shopware.

Een e-mailadres is gefilterd als het op de e-mailfilterlijst van je shop staat. Ook adressen van bol.com (@verkopen.bol.com), Amazon en Spamhaus ontvangen nooit transactionele mail. Klanten die via bol.com of Amazon bestellen, krijgen dus geen mail van Reloadify.

Verzonden mails terugvinden

Open het klantprofiel. Onder Activiteiten zie je de verzonden mail met onderwerp, tijdstip, opens en clicks. De totaalcijfers per mail vind je onder Assets > Transactioneel.


Informatie voor je developer

Geef je developer de API-sleutel, de ID's van je e-mails en de afspraken over de bestelgegevens. Stuur daarnaast het artikel Transactionele e-mails koppelen via de API voor developers. Daarin staat alles wat nodig is om de koppeling te bouwen.

Was dit een antwoord op uw vraag?