SMS dokumentation

Send SMS

Slutpunkt: 

Parametre:

Eksempel:

Gensend en ikke-sendt SMS

Dette API-slutpunkt bruges til at gensende en usendt SMS (kun hvis beskeden har en fejlstatus).

Slutpunkt:

Parameter: 

Eksempel: 

Log over SMS sendt fra API'et

Dette API-slutpunkt bruges til at hente loggen over SMS-beskeder sendt via API'et.

Slutpunkt: 

Parameter:

Eksempel:

Liste over sendte SMS'er fra mobil

Dette API-slutpunkt bruges til at liste SMS-beskeder sendt fra din mobilenhed og synkroniseret med din SMSMobileAPI-konto.

Vigtig: Denne funktion er tilgængelig fra Android-versionen 4.1.20.

Vigtig: Denne funktion er ikke aktiveret som standard i Android-appen.

Privatliv: Alle synkroniserede oplysninger er anonymiserede, fortrolige og håndteres sikkert.

Historikgrænse: Denne API returnerer altid data fra den sidste 7 dage kun.

Note: Hvis du sender SMS ved hjælp af standard API-slutpunktet https://api.smsmobileapi.com/sendsms/Disse SMS'er kan også vises i denne liste, fordi de fysisk sendes fra din mobilenhed.

Slutpunkt:

Parametre: 

Returnerede felter: 

Eksempel: 

Eksempel med filtre:

Eksempel med foruddefineret periode:

SMS modtaget

Dette API-slutpunkt bruges til at hente SMS-beskeder modtaget på smartphonen. 

Slutpunkt:

Parameter: 

Eksempel:

Markér modtagede SMS-beskeder som læst

Dette API-slutpunkt bruges til at markere en modtaget SMS-besked som læst i Kun API-status.
Dette ændrer ikke læsestatussen på smartphonen.  

Slutpunkt:

Parameter: 

Eksempel:

Opdater SMS-alias

Dette API-slutpunkt bruges til at opdatere aliaset for en modtaget SMS ved hjælp af dets GUID.

Note: De alias Parameteren kan være tom. I så fald vil aliasset blive slettet.

Slutpunkt:

Parametre: 

Eksempel: 

Eksempel på at slette aliaset:

Slet SMS

Dette API-slutpunkt bruges til at slette SMS-beskeder fra serverloggen for SMS Mobile API.

Slutpunkt: 

Parameter:

Eksempel:

Bemærk: Slettede SMS'er er kun dem, der er gemt i serverlogfiler. SMS'er på enheden slettes ikke.

Liste over SMS-samtaler

Dette API-slutpunkt bruges til at liste SMS-samtaler, der er knyttet til din konto.

Hver samtale er grupperet efter telefonnummer og indeholder de relaterede indgående og udgående SMS-beskeder.

Note: Samtalens udgangspunkt er defineret af origineConversation parameter:

• receivedsamtaler registreres først fra modtagne SMS'er i logsmsreceive
• sentsamtaler registreres først fra sendte SMS'er i logsmssent

Note: Hvis numero ikke angivet, returnerer API'en kun de seneste samtaler. Som standard er den sidste 20 samtaler returneres.

Note: For udgående SMS, hvis timearea_of_message er tilgængelig (eksempel: UTC+02), konverteres den viste dato automatisk ved hjælp af denne værdi. Denne konverterede dato bruges også til sortering.

Note: Hvis resume=1, returneres kun de seneste beskeder fra hver samtale. Brug resume_line_how for at definere, hvor mange seneste beskeder der skal inkluderes.

Slutpunkt:

Parametre: 

Adfærdsdetaljer: 

Eksempel 1 - Liste over de seneste samtaler fra modtagne SMS'er: 

Eksempel 2 - Liste over de seneste samtaler fra sendte SMS'er:

Eksempel 3 - Filtrer ét specifikt telefonnummer:

Eksempel 4 - Filtrer efter datointerval:

Eksempel 5 - Genoptag tilstand med de sidste 3 beskeder pr. samtale:

Eksempel på vellykket svar: 

{ "success": true, "origineConversation": "modtaget", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "indgående", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Hej, jeg vil gerne have mere information.", "status": "modtaget", "mobile_sid": "device_sid_1" }, { "direction": "udgående", "message_id": "msg_1002", "date": "2026-03-13 "10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Selvfølgelig, hvad vil du gerne vide?", "status": "sendt", "mobile_sid": "device_sid_2" } ] } ] }

Svarfelter:

Eksempel på fejl:

{ "success": false, "error": "Mangler obligatorisk parameter: apikey" }

Noter:

Gateway – Liste over tilsluttede mobiltelefoner

Liste over mobiltelefoner, der er forbundet til din SMS Gateway.

Slutpunkt:

Parametre:

Eksempel:

Gateway – Opdater en mobil etiket

Opdater etiketten (nom_reference) for en tilsluttet mobil.

Slutpunkt:

Parametre:

Eksempel:

Vigtig: etiket er påkrævet, men kan være tomt (etiket=).

Gateway – Slet en tilsluttet mobil

Fjern en tilsluttet mobil fra din gateway (sletter alle historikrækker for dette SID).

Slutpunkt:

Parametre:

Eksempel:

Webhook – SMS modtaget

Dette webhook-system sender en POST-anmodning til den konfigurerede URL, hver gang der modtages en SMS. Systemet sikrer opdateringer i realtid ved at levere SMS-detaljerne til den angivne webhook-URL.

Sådan konfigurerer du Webhook i Dashboard

Følg disse trin for at konfigurere din webhook-URL i betjeningspanelet:

1. Log ind på din konto på SMS Mobile API Dashboard.
2. Naviger til Webhook-indstillinger afsnit.
3. Indtast din webhook-URL (f.eks. https://example.com/webhook-endpoint).
4. Klik på Gem Webhook knap. 
5. Når det er gemt, begynder systemet at sende SMS-detaljer til den konfigurerede URL.

Webhook nyttelast

Når en SMS modtages, sender systemet følgende JSON-nyttelast til din webhook-URL:

{ "dato": "2025-01-20", "time": "10:15:00", "time_received": "2025-01-20 10:14:50", "besked": "Hej, dette er en test.", "nummer": "+123456789", "guid": "abcde12345" }

Nyttelastfelter:

• dato: Dato, hvor SMS'en blev tilføjet (ÅÅÅÅ-MM-DD).
• time: Time, hvor SMS'en blev tilføjet (TT:mm:ss).
• tid_modtaget: Tidspunkt, hvor SMS'en blev modtaget.
• besked: Indholdet af SMS'en. 
• antal: Afsenderens telefonnummer.
• guide: Unik identifikator for SMS'en.

Eksempel Webhook Endpoint

Din server bør være klar til at håndtere indgående POST-anmodninger. Nedenfor er et eksempel på et PHP-script til at behandle webhook-nyttelasten:

Test af Webhook

For at teste din webhook-konfiguration skal du bruge værktøjer som:

• Webhook.site
• RequestBin

Fejlfinding

• Sørg for, at webhook-URL'en er korrekt og offentligt tilgængelig.
• Bekræft, at din server returnerer en HTTP 200-statuskode for vellykkede anmodninger.
• Tjek dine serverlogfiler for eventuelle fejl under behandling af nyttelasten.

Beriget SMS

Autentificering

SMSMobile API understøtter to godkendelsesmetoder: Brug af en simpel API-nøgle eller OAuth2-protokollen med et klient-id og klienthemmelighed.

1. API-nøglegodkendelse

 Denne metode kræver en API-nøgle, der kan inkluderes som en parameter i enten en GET- eller POST-anmodning.

2. OAuth2-godkendelse

OAuth2 tilbyder en mere sikker godkendelsesmetode.
Brug et klient-ID og en klienthemmelighed til at hente et adgangstoken, og inkluder det derefter i Bemyndigelse overskrift.

Client_id og client_secret er tilgængelige i dit dashboard.
Download mobilappen nu eller få adgang til dit dashboard.

Få et adgangstoken

Brug af adgangstoken:

Hvilken metode skal du bruge?

- Brug API-nøglegodkendelse til hurtige og ligetil integrationer.

- Brug OAuth2-godkendelse for forbedret sikkerhed og skalerbarhed.