Transactionele e-mails versturen via de API

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 eigen systeem 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 ontwerp je hier de opmaak van je Lightspeed-mails. Dat werkt anders dan de API. 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:

Een transactionele e-mail per soort bericht, met onderwerp en inhoud
Het ID van elke e-mail
Een API-sleutel
Een developer die de koppeling inbouwt

Voeg je later een nieuwe soort mail toe, bijvoorbeeld "Bestelling bezorgd"? Dan krijgt die een eigen ID en moet je developer die ook inbouwen.

Een transactionele e-mail aanmaken

Ga naar Assets > Transactioneel.
Klik op Nieuwe e-mail.
Vul een onderwerp in.
Ontwerp de inhoud in de editor en sla op.
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".

Het complete ontwerp komt uit de editor: header, tekst, knoppen en footer. De API stuurt alleen het seintje en de klantgegevens mee, geen tekst of HTML.

Let op: Zonder onderwerp of inhoud weigert de API de verzending.

Het ontwerp van je mail

De API stuurt alleen het seintje en de klantgegevens; de opmaak komt altijd uit je ontwerp.

Maak per soort mail één transactionele e-mail aan. Bijvoorbeeld "Bestelling ontvangen", "Bestelling onderweg" en "Bestelling bezorgd". Elk ontwerp heeft een eigen ID en een eigen vaste tekst.

Gegevens per klant tonen met merge-tags

Gegevens die per klant of order verschillen, vul je met merge-tags. Je gebruikt twee soorten:

Klant- en shopgegevens die je systeem meestuurt, zoals voornaam, achternaam, adres en tags maar ook shopnaam en shop logo. Bijvoorbeeld {{ first_name }}. Deze vaste gegevens staan al klaar onder Merge tags in de editor.
Custom velden voor ordergegevens, zoals ordernummer, track-and-trace-link en bezorgdatum.

Voeg een custom veld zo toe:

Ga naar Instellingen > Custom velden.
Maak het veld aan, bijvoorbeeld ordernummer.
Plaats de merge-tag in de editor: {{ profile.ordernummer }}.
Geef de exacte veldnaam door aan je developer. Hij stuurt de waarde mee in het verzoek.

Let op: Reloadify slaat custom velden op het klantprofiel op en vult de mail pas bij het versturen.

Stuurt je systeem voor dezelfde klant twee mails kort na elkaar, bijvoorbeeld voor twee bestellingen? Dan kunnen beide mails de gegevens van de laatste bestelling tonen.

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

Tip: Wil je één mail gebruiken voor meerdere bezorgstatussen? Stuur de status mee als custom veld en toon per status een andere tekst met Liquid. Lees meer in Inhoud van e-mails personaliseren met Liquid.

Een API-sleutel aanmaken

Ga naar Instellingen > API-inloggegevens.
Klik op Nieuwe API-sleutel.
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:

je shop geverifieerd is voor verzending;
je shop een actief abonnement heeft;
de afzendernaam en het afzenderadres zijn ingesteld.

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. De API geeft dan een foutmelding.

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.

Een transactionele mail activeert een inactief profiel niet opnieuw.

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 deze gegevens door aan je developer.

Documentatie: https://api.reloadify.com/api-docs
Aanmelden: POST https://api.reloadify.com/oauth/token met grant_type=client_credentials, client_id en client_secret. Het token is twee uur geldig. Vraag daarna een nieuw token aan.
Versturen: POST https://api.reloadify.com/api/v2/languages/{taal}/transactional_emails/{id}/send
- Verplicht: profile.email
- Optioneel: profile.id (eigen klantnummer), voornaam, achternaam, tags, adres en custom_attributes
- custom_attributes is een lijst met name en één waarde: string_value, integer_value, date_value, datetime_value of boolean_value. De name moet bestaan onder Instellingen > Custom velden.
- Het veld active wordt genegeerd. Een inactief profiel activeer je niet via dit endpoint.
Antwoord bij succes: HTTP 202 met een reference en status: "queued". De mail gaat binnen enkele seconden de deur uit. Een bounce na verzending komt niet terug via de API, maar is zichtbaar op het klantprofiel.
Limiet: maximaal 60 verzoeken per minuut per shop. Daarboven volgt HTTP 429. Wacht kort en verstuur het verzoek opnieuw.

Voorbeeld van het verzoek:

curl -X POST "https://api.reloadify.com/api/v2/languages/Nederlands/transactional_emails/1755/send" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": {
      "email": "[email protected]",
      "first_name": "Anna",
      "custom_attributes": [
        { "name": "ordernummer", "string_value": "WP-48213" },
        { "name": "track_and_trace", "string_value": "https://postnl.nl/track/3S..." }
      ]
    }
  }'

Deze meldingen krijgt je developer terug van de API.

Melding	Betekenis	Oplossing
Transactional email has no subject configured	Geen onderwerp	Vul een onderwerp in bij de instellingen van de e-mail.
Transactional email has no content designed yet	Geen inhoud	Ontwerp de mail in de editor en sla op.
Transactional email template contains invalid Liquid	Fout in een merge-tag	Controleer de merge-tags in de editor.
Could not find transactional email with id	Verkeerd ID	Controleer het ID in de adresbalk.
Shop is not verified for sending yet	Shop niet geverifieerd	Neem contact op met support.
Shop has no active subscription	Geen actief abonnement	Controleer je abonnement.
Shop has no sender name and email configured	Geen afzender ingesteld	Stel de afzender in bij de verzendinstellingen.
Profile is inactive or email filtered	Klant kan geen mail ontvangen	Controleer het e-mailadres van de klant
HTTP 429	Meer dan 60 verzoeken per minuut	Wacht kort en verstuur opnieuw.