Kom igång
För att kunna använda vårt SMS API behöver du följande:
- Ett konto hos 46elks.
- Tillgång till dina API-uppgifter.
Skriv koden med Ruby
Nu ska vi skriva koden som ska skicka SMS:et. Koden behöver kunna göra följande:
- Definiera innehållet i SMS:et (
message), vem som kommer att ta emot det (to) och vem som är avsändaren (from). - Sätta ditt API-användarnamn (
USERNAME) och API-lösenord (PASSWORD) som BasicAuth i HTTP-headern. - Skicka all denna information till 46elks via en HTTP POST-anrop till https://api.46elks.com/a1/SMS.
- Ta emot svaret och hantera eventuella fel som kan uppstå.
Det finns flera sätt att att implemetera detta i Ruby. Här är ett exempel på hur du kan göra genom att bara använda standardbiblioteken:
Detta exempel har testats med Ruby 2.1.2.
Kopiera in koden ovan i en fil som du döper till send.rb. Byt sedan ut följande i koden mot dina egna uppgifter:
usernamepå rad 3 (Ditt API-username).passwordpå rad 4 (Ditt API-password).topå rad 11 (Ditt telefonnummer).
Tips för formatering av SMS-parametrar
Det mest grundläggande API-anropet för att skicka ett SMS innehåller tre stycken parametrar: to, from och message.
-
tomåste vara ett telefonnummer formaterat enligt E.164.
Exempel: +46766861004. -
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 -
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 bra är den här guiden, 👌🏽 or 👎🏽 ?
Nu kan du köra ditt script i terminalen med kommandot ruby send.rb. Fick du ett SMS till din telefon? - Grattis!
Nästa steg
Du har just skickat ett textmeddelande med en textavsändare (dvs. inte från ett telefonnummer). Genom att göra detta kan du använda SMS för att bl.a. påminna kunder om bokningar och skicka bekräftelser på nya beställningar.
Att skicka ett SMS är det enklaste sättet att komma igång med 46elks och det finns mycket mer att utforska. Till exempel kan du ta emot SMS, automatiskt svara på inkommande SMS eller hantera röstsamtal. Vi har fler exempel för Ruby på GitHub.
Om du har några frågor är du välkommen att kontakta oss. Vi gillar att prata med våra användare!
