Afsendelse af SMS-beskeder med Python: En trin-for-trin-guide

I denne vejledning lærer du, hvordan du sender SMS-beskeder ved hjælp af PHP og GatewayAPI. Vi guider dig trin for trin gennem opsætningen, herunder hvordan du strukturerer din kode, sender anmodninger med cURL og fortolker serverens svar. Vejledningen er rettet mod udviklere med grundlæggende PHP-kendskab.

Før vi begynder, er det vigtigt, at du har en grundlæggende forståelse af PHP og en GatewayAPI-konto med kontokredit. Du kan også vælge at bruge vores EU setup, hvor hosting og ejerskab udelukkende ligger inden for EU. Denne opsætning er især relevant for kunder, der har særlige krav til deres data.

Lad os dykke ned i processen trin for trin.

Sådan kommer du i gang

Når du er logget ind på GatewayAPI.com, vil du blive præsenteret for et dashboard, der indeholder en række kodeeksempler på forskellige sprog, som sikrer, at du kan integrere med API’en, uanset hvilket sprog du foretrækker. Eksemplerne indeholder de API-nøgler, som blev genereret ved kontooprettelsen. Her er det naturligvis “Python” eksemplet, som vi tager i brug. 

Installation af dependencies:
Før du dykker ned i koden, skal du sikre dig, at dit Python-miljø er sat korrekt op. Den vigtigste dependency, du har brug for, er requests-biblioteket. For at installere det, skal du åbne din terminal eller kommandoprompt og køre følgende kommando:

Opsætning af din editor:
Når du har installeret de nødvendige dependencies, skal du kopiere det medfølgende kodeeksempel fra dit dashboard til din foretrukne kodeeditor.

Tilpasning af beskeden

Indtast telefonnummeret:
Find pladsholderen til at indtaste modtagerens telefonnummer i koden og indsæt det telefonnummer du gerne vil benytte.

Skift Sender ID:
Ændr afsenderens navn fra standard “ExampleSMS” til “GatewayAPI” (eller et andet foretrukket Sender ID).

Ændr meddelelsens indhold:
Standardbeskeden i eksemplet er “Hello World”. Du kan ændre dette til en mere personlig besked som “Hello Oliver, how are you?” eller en hvilken som helst anden tekst.

Husk at ændre token:
Hvis du har kopieret nedenstående kode frem for det på dit dashboard, så husk at erstatte det token, som er i eksemplet med dit unikke token. Det kan findes i dit dashboard under API → API Keys.

Koden bør gerne se sådan ud nu:

Afsendelse af SMS

Når du har foretaget alle de nødvendige ændringer, skal du gemme dit script og gå tilbage til din terminal og køre dit Python-script. Hvis alt er sat korrekt op, vil beskeden blive sendt til det angivne telefonnummer. Du vil nu kunne se en besked på modtagertelefonen. I vores eksempel blev beskeden “Hej Oliver, hvordan har du det?” fra GatewayAPI modtaget.

Typiske fejl

• Anvendelse af forkerte legitimationsoplysninger, fx ved at forveksle token med key eller secret.
• Manglende dependencies: Hvis man undlader at installere nødvendige biblioteker eller moduler, kan det føre til ModuleNotFoundError eller ImportError.

Hvis du støder på udfordringer eller har brug for yderligere information, kan du få mere information i vores dokumentation eller kontakte vores supportteam via supportchatten. 

Python – den hellige gral inden for kodning?

Tre fun-facts om kodesproget Python:

• Navnet “Python” kommer ikke fra slangen, men fra den britiske komikergruppe Monty Python. Guido van Rossum, skaberen af Python, var fan af Monty Pythons Flyvende Cirkus og ville have et navn, der var kort, unikt og lidt mystisk.
• Python har en række vejledende principper, som du kan se ved at skrive import this i en Python-interpreter. Dette vil vise dig “The Zen of Python”, en samling af 19 aforismer, der indkapsler filosofien bag Python-kodesproget.
• Python er et af de hurtigst voksende programmeringssprog. Dets enkelhed og alsidighed, især inden for datalogi og webudvikling, har ført til dets udbredte anvendelse i forskellige brancher.

Afsluttende bemærkninger

Som afrunding får du her nogle vigtige tips, der sikrer, at SMS-udsendelser forløber problemfrit:

• Begræns dit Sender ID til max 11 alfanumeriske tegn eller 15 numeriske cifre. Specialtegn kan forårsage problemer eller overskrive dit ID.
• Hvis du anvender links, skal du starte whitelisting-processen på forhånd. Godkendelse tager typisk under en arbejdsdag.
• Sørg for, at din SMS- eller PHP-filkodning er indstillet til UTF-8. Dette er afgørende for problemfri drift, især for Windows-brugere, der kan støde på alternative standardindstillinger.

Denne guide berørte de væsentligste punkter ved SMS-beskeder via GatewayAPI. For en dybdegående vejledning, se vores dokumentation.

For en trin-for-trin gennemgang kan du se vores YouTube-video, hvor min kollega demonstrerer Python-baseret messaging på samme vis som vejledningen i dette blogindlæg.

God fornøjelse!

Om forfatteren

Oliver fokuserer på integrationer og er manden, du skal gå til, hvis du har brug for en integration med dit foretrukne system. Når han ikke arbejder på GatewayAPI, studerer han ivrigt AI og Deep Learning. Oliver nyder generelt bare at arbejde med kode, uanset om det er AI eller noget mere jordnært, såsom GUI eller backend-software.