Kom igång
För att kunna använda API:et behöver du följande:
- Ett konto på 46elks.
- Dina API-uppgifter.
Format
Det mest grundläggande API-anropet för att skicka ett SMS innehåller tre stycken parametrar: to, from och message.
-
Parametern
tomåste vara ett telefonnummer formaterat enligt E.164.
Exempel: +46766861004. -
Parametern
frommåste vara antingen ett E.164-formaterat telefonnummer eller en enkel sträng. Strängen kallas ofta för "Text sender ID" eller "alphanumeric sender ID".
Exempel: +46766861004, ElkCo -
Parametern
messageär själva innehållet i SMS:et och kan bestå av siffror, bokstäver och andra tecken. Du kan till och med skicka emojis.
Exempel: Hur var den här intervjun, 👌🏽 or 👎🏽 ?
Nedan visas ett komplett JSON-exempel på hur datan för ett korrekt API-anrop kan se ut:
Uppdelning av meddelanden
Ett SMS kan ibland delas upp i flera mindre SMS-delar beroende på vad SMS:et innehåller för tecken. Du behöver inte själv tänka på att dela upp ett SMS eftersom det sker automatiskt av API:et. Oavsett hur många delar SMS:et består av kommer mottagaren fortfarande se ett enda sammanhängande meddelande.
Mer om hur uppdelningen går till hittar du i vår dokumentation.
Leveransrapporter
Du kan få notiser när ditt SMS ändrar status genom att ange en webhook i parametern whendelivered i samband med API-anropet. Se rad 10 i exemplet nedan.
API:et kommer sedan att skicka ett x-www-form-urlencoded HTTP POST-anrop till den specifierade URL:en varje gång SMS:et ändrar status. Anropet kommer ha följade format:
| Parameter | Type | Description |
|---|---|---|
| id | string | The unique id of the message in our systems. |
| status | string | Either ”delivered” or ”failed”. |
| delivered | string | The delivery time in UTC. Only included if status is
set to delivered. |
Mer om leveransrapporter hittar du i dokumentationen.
Pris
Vi fakturerar dig (och faktureras själva av operatörerna) per skickad SMS-del. Meddelanden som inte passar i en enskild del kommer att delas upp i flera delar och du kommer att faktureras för varje del. Vi har en omfattande artikel som beskriver alla detaljer kring detta och en bra tumregel är:
- Om meddelandet inte innehåller främmande tecken, emoji eller andra symboler än !"#¤%&'()*+,-.:;<>=?¡ så får du plats med 153 tecken per SMS-del.
- I annat fall får du plats med 67 tecken per SMS-del
Vänligen notera att det bara är en grov uppskattning. Antalet tecken som får plats kan variera (det har med encoding att göra). Som nämnt tidigare har vi en artikel som bekriver detta mer ingående som du med fördel kan läsa. Du kan även höra av dig till vår support om du har frågor så hjälper vi dig.
Aktuella priser hittar du på vår prislista. Vi erbjuder volymrabatter till kunder som skickar mer än 50 000 SMS per månad.
Täckning
Du kan använda 46elks för att skicka SMS nästan överallt i världen. Flaggorna nedan representerar alla 219 länder och provinser där vi just nu har täckning. Hör av dig om du har speciella behov.
🇦🇫 🇦🇱 🇩🇿 🇦🇩 🇦🇴 🇦🇮 🇦🇬 🇦🇷 🇦🇲 🇦🇼 🇦🇺 🇦🇹 🇦🇿 🇧🇸 🇧🇭 🇧🇩 🇧🇧 🇧🇾 🇧🇪 🇧🇿 🇧🇯 🇧🇲 🇧🇹 🇧🇴 🇧🇶 🇧🇦 🇧🇼 🇧🇻 🇧🇷 🇮🇴 🇧🇳 🇧🇬 🇧🇫 🇧🇮 🇰🇭 🇨🇲 🇨🇦 🇨🇻 🇰🇾 🇨🇫 🇹🇩 🇨🇱 🇨🇳 🇨🇽 🇨🇨 🇨🇴 🇰🇲 🇨🇩 🇨🇩 🇨🇰 🇨🇷 🇭🇷 🇨🇺 🇨🇾 🇨🇿 🇨🇮 🇩🇰 🇩🇯 🇩🇲 🇩🇴 🇪🇨 🇪🇬 🇸🇻 🇬🇶 🇪🇪 🇪🇹 🇫🇰 🇫🇴 🇫🇯 🇫🇮 🇫🇷 🇬🇫 🇹🇫 🇬🇦 🇬🇲 🇬🇪 🇩🇪 🇬🇭 🇬🇮 🇬🇷 🇬🇱 🇬🇩 🇬🇵 🇬🇺 🇬🇹 🇬🇬 🇬🇳 🇬🇼 🇬🇾 🇭🇹 🇭🇲 🇭🇳 🇭🇰 🇭🇺 🇮🇸 🇮🇳 🇮🇩 🇮🇷 🇮🇶 🇮🇪 🇮🇲 🇮🇱 🇮🇹 🇯🇲 🇯🇵 🇯🇪 🇯🇴 🇰🇿 🇰🇪 🇰🇼 🇰🇬 🇱🇦 🇱🇻 🇱🇧 🇱🇸 🇱🇷 🇱🇾 🇱🇮 🇱🇹 🇱🇺 🇲🇴 🇲🇰 🇲🇬 🇲🇼 🇲🇾 🇲🇻 🇲🇱 🇲🇹 🇲🇶 🇲🇷 🇲🇺 🇾🇹 🇲🇽 🇲🇩 🇲🇳 🇲🇪 🇲🇸 🇲🇦 🇲🇿 🇳🇦 🇳🇵 🇳🇱 🇳🇿 🇳🇮 🇳🇪 🇳🇬 🇳🇴 🇴🇲 🇵🇰 🇵🇸 🇵🇦 🇵🇬 🇵🇾 🇵🇭 🇵🇱 🇵🇹 🇵🇷 🇶🇦 🇷🇴 🇷🇺 🇷🇼 🇷🇪 🇧🇱 🇰🇳 🇱🇨 🇻🇨 🇼🇸 🇸🇲 🇸🇹 🇸🇦 🇸🇳 🇷🇸 🇸🇨 🇸🇱 🇸🇬 🇸🇰 🇸🇮 🇸🇧 🇸🇴 🇿🇦 🇬🇸 🇰🇷 🇸🇸 🇪🇸 🇱🇰 🇸🇩 🇸🇷 🇸🇯 🇸🇿 🇸🇪 🇨🇭 🇸🇾 🇹🇼 🇹🇯 🇹🇿 🇹🇭 🇹🇱 🇹🇬 🇹🇴 🇹🇹 🇹🇳 🇹🇷 🇹🇲 🇹🇨 🇺🇬 🇺🇦 🇦🇪 🇬🇧 🇺🇸 🇺🇾 🇺🇿 🇻🇪 🇻🇳 🇻🇬 🇻🇮 🇾🇪 🇿🇲 🇿🇼 🇦🇽Throughput
Som standard kan du skicka 100 SMS per minut och konto. Alla SMS utöver detta kommer läggas i en kö och skickas i turordning (först in, först ut). Kontakta oss om du är i behov av att kunna skicka fler SMS per minut så hittar vi en lösning tillsammans.
Mer info
Vid frågor eller funderingar kan du alltid höra av dig till vår support.
