Direct mail API: verstuur persoonlijke kaarten vanuit je eigen software
Met de API van Yotru verstuurt je CRM, webshop of boekingssysteem zelf gedrukte, persoonlijke kaarten. Je maakt een kaart, stuurt ontvangers en keurt goed. Een ontwerp heb je niet nodig: Yotru bouwt de kaart vanaf je website. Op elke kaart staat de naam van de ontvanger en een eigen QR-code, zodat je precies ziet wie reageert.
Wat je krijgt
- Geen ontwerpwerk
- Stuur een webadres mee en Yotru bouwt de kaart met je logo en kleuren. Of kies een template en stuur je eigen tekst en foto.
- Persoonlijk per ontvanger
- Elke kaart heeft de naam van de ontvanger, een eigen QR-code en een eigen landingspagina. Een foto en eigen velden per ontvanger kunnen erbij.
- Zien wie reageert
- Elke scan hoort bij één ontvanger. Je ziet hem in je dashboard en kunt meteen een melding krijgen per mail of in Slack.
- Gratis bouwen en testen
- Kaarten maken, voorbeelden ophalen en ontvangers sturen kost niets. Je betaalt als je een campagne goedkeurt.
- Gecontroleerd voor het drukken
- Na je goedkeuring loopt bij ons iemand de partij na voordat die naar de drukker gaat.
- Drukwerk en verzending erbij
- Eén prijs per kaart voor ontwerp, druk en bezorging door PostNL.
Zo werkt het
| Stap | Call | Wat er gebeurt |
|---|---|---|
| 1 | POST /v1/cards | Je maakt een kaart. Wat je weglaat, komt uit de template of wordt van je website gelezen. |
| 2 | POST /v1/recipients | Je stuurt tot 1.000 ontvangers per call. De eerste call opent vanzelf een campagne. |
| 3 | POST /v1/campaigns/{id}/approve | Je keurt goed. Het antwoord bevat een betaallink, en na betaling gaat de campagne naar de drukker. |
curl -X POST https://api.yotru.com/v1/recipients \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"cardId":"CARD_ID","recipients":[{"name":"Anna de Vries","street":"Kerkstraat","houseNumber":"12","postcode":"1011 AB","city":"Amsterdam","country":"NL"}]}'Met een aparte call haal je de kaart op zoals hij gedrukt wordt, zodat je hem kunt controleren voordat je goedkeurt.
Wat je ermee kunt bouwen
- Kaarten voor slapende klanten. Je webshop stuurt een kaart naar klanten die zes maanden niets hebben besteld.
- Jubileum- en verlengkaarten. Je CRM stuurt een kaart als iemand een jaar klant is.
- Opvolging. Je boekingssysteem stuurt een kaart na een eerste bezoek of een gemiste afspraak.
- Post voor je eigen klanten. Je software biedt kaarten aan zijn gebruikers aan, en jij bent de afzender bij ons.
Wat het kost
Dezelfde prijs per kaart als bij een bestelling via de site, met drukwerk en verzending erbij. Er is geen minimum: onder de 100 kaarten geldt per kaart de prijs van 100 stuks. Kaarten maken en ontvangers sturen is gratis.
Goed om te weten voordat je bouwt
- Kaarten bouw je met tien templates die je vult met je eigen tekst, kleuren, logo en foto. Een kant-en-klaar eigen ontwerp uploaden zit nog niet in de API.
- De stand van een campagne haal je op met één call: open, wacht op betaling, goedgekeurd, bij de drukker of verstuurd.
- Je stuurt tot 1.000 ontvangers per call, en met een Idempotency-Key in de header is een herhaalde call veilig.
Vragen over de API
- Is er een testmodus of sandbox?
- Nee, en die heb je niet nodig. Kaarten maken, een voorbeeld ophalen en ontvangers toevoegen kost niets en verstuurt niets. Alleen een campagne goedkeuren kost geld.
- Hoe kom ik aan een API-sleutel?
- Maak een account en open Instellingen, dan API. De eerste sleutel wordt aangemaakt zodra je die pagina opent en je ziet hem één keer. Je moet eigenaar of beheerder zijn en je e-mailadres bevestigd hebben.
- Wat gebeurt er met een adres dat niet klopt?
- Die ontvanger wordt geweigerd met een reden, zoals adres of dubbel, en de rest van de lijst gaat door.
- Zijn er limieten?
- Per sleutel 120 calls per minuut, en 300 calls per dag waarmee je kaarten maakt of wijzigt of foto's meestuurt.
- Heb ik een ontwerper of ontwerpbestand nodig?
- Nee. Stuur je webadres mee en Yotru bouwt de kaart met je logo en kleuren. Je kunt tekst, kleuren, logo en foto ook zelf meesturen.
- Kan ik zien wie op een kaart reageert?
- Ja. Elke kaart heeft een eigen QR-code, dus elke scan hoort bij één ontvanger. Je ziet hem in je dashboard en kunt meteen een melding krijgen.
- Werkt het met mijn CRM of webshop?
- Elk systeem dat een HTTPS-call kan doen, kan de API gebruiken. Gebruik je HubSpot, dan kun je je lijsten ook zonder code koppelen in het dashboard.
- In welke taal is de documentatie?
- In het Engels, net als de antwoorden van de API zelf.
Waarom we hem zo hebben opgezet: Kaarten versturen via een API: zo hebben we die van Yotru opgezet.