Ved å integrere Postal direkte med applikasjonen din via API, får du mer kontroll over hvordan utsendelsene sendes og mottas. Du kan lese mer om forskjellen mellom API- og SMTP-integrasjon her .
Integrasjonen har to deler:
- API-tilkobling for å sende meldinger
- Webhook-tilkobling for å motta status om sendte meldinger
Vi anbefaler at du også integrerer webhooks for å motta status om meldingene du sender, men det er valgfritt.
Klientbibliotek
Det finnes flere ferdige klientbiblioteker som hjelper deg med å sende e-post med Postal:
Disse bibliotekene er åpen kildekode og leveres av fellesskapet. Vi kan dessverre ikke tilby noen støtte for bibliotekene, men referer til det respektive bibliotekets GitHub-depot.
Send direkte til API
Du kan også opprette din egen tilkobling til Postals API. Det er to APIer:
- Messages API . Få informasjon om en sendt melding.
- Send API . Send meldinger fra applikasjonen din.
All informasjon om disse to API-ene, samt informasjon om struktur, feil og tilkobling , finnes i API-dokumentasjonen .
Når du bruker API, bruk basis-URLen https://postal.oderland.com
For eksempel vil nettadressen for å sende en melding være: https://postal.oderland.com/api/v1/send/message
Motta status via webhooks
Vi anbefaler at du også mottar status på meldingene du sender. For å få status tilbake må du sende ved hjelp av API og ikke via SMTP. Med webhooks får du muligheten til å:
- Se hvilke meldinger som spretter, og du kan for eksempel fjerne adressen fra registeret ditt
- Se hvilke lenker som er klikket på i meldingen din
- Se hvor mange ganger meldingen din har blitt åpnet
- Få informasjon om andre feil som kan oppstå når meldingen sendes
Du kan finne mer informasjon om hver webhook, dens svarstruktur og hvilke hendelser som er tilgjengelige i webhooks-dokumentasjonen .
For å komme i gang med webhooks, må vi registrere tilbakeringingen din i Postal. Når du har fullført integrasjonen på nettstedet ditt , kontakt oss med din tilbakeringings-URL for søknaden din, så registrerer vi den.