API för direktreklam: skicka personliga brev från ditt eget system
Med Yotrus API skickar ditt CRM, din webbutik eller ditt bokningssystem tryckta, personliga brev helt själv. Du skapar ett brev, lägger till mottagare och godkänner. Du behöver ingen originalfil: Yotru bygger brevet utifrån din webbplats, på svenska. Varje brev har mottagarens namn och en egen QR-kod, så att du ser exakt vem som svarar.
Det här får du
- Inget designarbete
- Skicka med adressen till din webbplats så bygger Yotru brevet med din logga och dina färger. Eller välj en mall och skicka din egen text.
- Personligt för varje mottagare
- Varje brev har mottagarens namn, en egen QR-kod och en egen landningssida. Egna fält per mottagare går att lägga till.
- Se vem som svarar
- Varje skanning hör till en enda mottagare. Du ser den i din instrumentpanel och kan få en avisering via e-post eller Slack direkt.
- Gratis att bygga och testa
- Att skapa brev, hämta förhandsvisningar och lägga till mottagare kostar ingenting. Du betalar när du godkänner en kampanj.
- Kontrollerat före tryck
- När du har godkänt går en person hos oss igenom utskicket innan det skickas till tryckeriet.
- Tryck och porto ingår
- Ett pris per brev för design, tryck, kuvert och leverans.
Så fungerar det
| Steg | Anrop | Vad som händer |
|---|---|---|
| 1 | POST /v1/cards | Du skapar ett brev med product, country och language. Det du utelämnar kommer från mallen eller läses från din webbplats. |
| 2 | POST /v1/recipients | Du lägger till upp till 1 000 mottagare per anrop. Det första anropet öppnar en kampanj av sig självt. |
| 3 | POST /v1/campaigns/{id}/approve | Du godkänner. Svaret innehåller en betalningslänk, och kampanjen går till tryck när den är betald. |
curl -X POST https://api.yotru.com/v1/cards \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Höstkampanj","product":"letter","country":"SE","website":"https://exempel.se"}'
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 Andersson","street":"Storgatan","houseNumber":"1","postcode":"111 22","city":"Stockholm","country":"SE"}]}'Ett förhandsgranskningsanrop returnerar brevet precis som det trycks, så att du kan kontrollera det innan du godkänner.
Det här kan du bygga
- Brev som vinner tillbaka kunder. Din webbutik skriver till kunder som inte har handlat på sex månader.
- Jubileums- och förnyelsebrev. Ditt CRM skickar ett brev när någon har varit kund i ett år.
- Uppföljning. Ditt bokningssystem skickar ett brev efter ett första besök eller en missad tid.
- Post till dina egna kunder. Din programvara erbjuder brev till sina användare, och du är avsändaren hos oss.
Vad det kostar
Samma pris per brev som en beställning på webbplatsen, med tryck, kuvert och porto. Ett brev till Sverige kostar 2,79 € styck vid 100 och 2,19 € vid 5 000, exklusive moms. Det finns inget minimum: under 100 brev kostar varje brev priset för 100. Att skapa och testa är gratis.
Bra att veta innan du bygger
- Brev går till alla 16 länder, bland dem Sverige, Norge, Danmark, Finland och Island.
- Breven byggs med fyra mallar som du fyller med din egen text, dina färger, din logga och ditt foto.
- Ett brev går till ett land, där dess mottagare bor. Upp till 1 000 mottagare ryms i ett anrop, och med en Idempotency-Key i headern är ett upprepat anrop säkert.
Frågor om API:t
- Finns det ett testläge eller en sandlåda?
- Nej, och du behöver inget. Att skapa brev, hämta förhandsvisningar och lägga till mottagare kostar ingenting och skickar ingenting. Bara att godkänna en kampanj kostar pengar.
- Hur får jag en API-nyckel?
- Skapa ett konto och öppna Inställningar, sedan Integrationer och API-nycklar. Din första nyckel skapas när du öppnar sidan och visas en gång. Du måste vara ägare eller administratör och ha bekräftat din e-postadress.
- Skrivs brevet på svenska?
- Ja. Ett brev till Sverige skrivs på svenska om du inte anger något annat. Med language väljer du ett annat av de tio språken.
- Kan brevet ha tryck på baksidan?
- Ja. Med backSide: true trycker vi en andra sida på baksidan, för 0,25 € extra per brev.
- Vad händer med en felaktig adress?
- Den mottagaren avvisas med ett skäl, till exempel address eller duplicate, och resten av listan går igenom.
- Finns det gränser för antalet anrop?
- Varje nyckel kan göra 120 anrop per minut och 300 anrop per dag som skapar eller ändrar brev eller skickar foton.
- Kan jag se vem som svarar på ett brev?
- Ja. Varje brev har en egen QR-kod, så varje skanning hör till en mottagare. Du ser den i instrumentpanelen och kan få en avisering direkt.
- Fungerar det med mitt CRM eller min webbutik?
- Alla system som kan göra ett HTTPS-anrop kan använda API:t. Använder du HubSpot kan du också koppla dina listor utan kod i instrumentpanelen.
Varför vi byggde det så här: Skicka brev via API: från ditt CRM eller din webbshop till brevlådan.