Kom igång
För att kunna använda vårt SMS API behöver du följande:
- Ett konto på 46elks.
- Dina API-uppgifter.
Skriv din C#-kod
Nu är det dags att skriva din C#-kod. Sammanfattningsvis ska din kod 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). - Bifoga ditt API-användarnamn (
<YOUR USERNAME>) och API-lösenord (<YOUR PASSWORD>) som BasicAuth till HTTP Header. - 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å.
Du kan utgå ifrån detta kodexempel:
Och här är ett exempel på en projektfil (testad i .NET Core 5.0):
För att kunna skicka ett SMS behöver du byta ut följande i koden till dina egna uppgifter:
user(Ditt API-username).pwd(Ditt API-password).to(Ditt telefonnummer).- Om du vill kan du även ändra
fromochmessagetill egna värden.
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 👎🏽 ?
Är du ny på .NET Core?
Här är några extra fingervisningar ifall du är ny till .NET Core.
Ladda ner och installera .NET Core.
-
Öppna din terminal och kör nedanstående kommandon. Dessa kommandon skapar nödvändiga programfler och lägger till externa paket.
Använd din favoriteditor för att byta ut hela innehållet i filen Program.cs mot koden från kodexemplet.
Redigera
message,to,fromoch API-authentiseringen (<YOUR USERNAME>och<YOUR PASSWORD>).Nu kan du köra din kod. Om du använder terminalen kommer det se ut ungefär så här:
Om koden kördes utan problem, kan du förvänta dig ett resultat som liknar detta:
Du ska nu ha fått ett SMS. Bra jobbat!
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 C#-exempel 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!
