Genom att integrera Postal direkt med din applikation via API får mer kontroll över hur dina utskick skickas och tas emot. Du kan läsa mer om skillnaden mellan API och SMTP-integration här.
Integrationen har två delar:
- API-anslutning för att skicka meddelanden.
- Webhook-anslutning för att ta emot status om skickade meddelanden.
Vi rekommenderar att du även integrerar webhooks för att ta emot status om de meddelanden du skickar, men det är valfritt.
Klientbibliotek
Det finns flera färdiga klientbibliotek för att hjälpa dig att skicka e-post med Postal:
Dessa bibliotek är open source och tillhandahålls av communityn. Vi kan tyvärr inte erbjuda någon support för biblioteken utan hänvisar till respektive biblioteks GitHub-repository.
Skicka direkt mot API:t
Du kan också göra din egen koppling mot Postals API. Det finns två API:er:
- Messages API. Få information om ett skickat meddelande.
- Send API. Skicka meddelanden från din applikation.
All information om dessa två API:er, samt information om struktur, fel och anslutning hittar du i API-dokumentationen.
När du använder API:t ska du använda bas-URL:en https://postal.oderland.com
Exempelvis blir URL:en för att skicka ett meddelande: https://postal.oderland.com/api/v1/send/message
Ta emot status via webhooks
Vi rekommenderar att du också tar emot status på de meddelanden som du skickar. För att kunna få status tillbaka måste du skicka med hjälp av API:t och inte via SMTP. Med webhooks får du möjlighet att:
- Se vilka meddelanden som studsar, och du kan exempelvis ta bort adressen ur ditt register
- Se vilka länkar som klickas på i ditt meddelande
- Se hur många gånger ditt meddelande har öppnats
- Få information om andra fel som kan inträffa när ditt meddelande skickas
Mer information om respektive webhook, dess svarsstruktur och vilka events som finns hittar du i webhooks-dokumentationen. Vi har även skrivit följande guide om hur du sätter upp en webhook i Postals webbgränssnitt.