SMS-documentatie

SMS verzenden

Eindpunt: 

Parameters:

Voorbeeldverzoek:

Voorbeeld van een JSON-antwoord:

{ "result": { "error": 0, "sent": "1", "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "note": "sent by mobile", "datetime": "2026-03-20T21:07:44Z", "datetimeLocal": "2026-03-20T22:07:44+01:00", "port": null, "iac_control": "1", "iac_authorized": "1", "send_with_whatsapp": "0", "encrypted": { "status": "0" }, "trial_account": { "status": "0", "sms_sent": 0 } } }

Toelichting op het antwoord:

Een niet-verzonden sms opnieuw verzenden

Met dit eindpunt kunt u een eerder niet-verzonden sms-bericht opnieuw verzenden, maar alleen als het bericht momenteel een foutstatus heeft.

Eindpunt:

Parameters: 

Voorbeeldverzoek: 

Voorbeeld van een JSON-antwoord:

{ "result": { "error": "0", "sms": "succesvol opnieuw verzonden", "attempt": 1 } }

Toelichting op het antwoord:

Logboek van SMS verzonden via de API

Via dit eindpunt kunt u het logboek van sms-berichten opvragen die via de API zijn verzonden.

Eindpunt: 

Parameters:

Voorbeeldverzoek:

Voorbeeld van een JSON-antwoord:

{ "result": { "error": "0", "sms": [ { "sIdentifiantPhone": "abbg00055x5", "port": 0, "date_add": "2026-03-20", "hour_add": "22:07:44", "timestamp": 1774044464, "send_from_mobile": 1, "send_from_mobile_date": "2026-03-20", "send_from_mobile_heure": "22:10:05", "send_from_mobile_timestamp": 1774044605, "recipients": "32495898697", "sms": "test", "error_api": "", "send_from_mobile_erreur": "", "guid_message": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "timearea": "UTC+01", "date_add_server": "2026-03-20", "hour_add_server": "21:07:44", "timestamp_server": 1774040864, "send_from_mobile_date_server": "2026-03-20", "send_from_mobile_heure_server": "21:10:05" } ] } }

Toelichting op het antwoord:

Lijst met verzonden sms-berichten vanaf mobiel

Via dit eindpunt kunt u een lijst bekijken van sms-berichten die vanaf uw mobiele apparaat zijn verzonden en gesynchroniseerd met uw SMSMobileAPI-account.

Belangrijk: Deze functie is beschikbaar vanaf Android-versie 4.1.20.

Belangrijk: Deze functie is niet standaard ingeschakeld in de Android-app.

Privacy: Alle gesynchroniseerde informatie wordt geanonimiseerd, vertrouwelijk en veilig verwerkt.

Geschiedenislimiet: Deze API retourneert alleen gegevens van de laatste 7 dagen.

Opmerking: Als u sms-berichten verzendt via het standaard API-eindpunt https://api.smsmobileapi.com/sendsms/Deze sms-berichten kunnen ook in deze lijst voorkomen omdat ze fysiek vanaf uw mobiele apparaat zijn verzonden.

Eindpunt:

Parameters: 

Geretourneerde velden: 

Voorbeeldverzoek: 

Voorbeeld met filters:

Voorbeeld met een vooraf gedefinieerde periode:

Voorbeeld van een JSON-antwoord:

{ "result": { "error": "0", "count": 200, "limit": 200, "history_limit_days": 7, "sort_by": "mobile_date_ms", "sort_order": "DESC", "sms": [ { "sIdentifiant": "508b004b4aadacc4", "number": "+15551234567", "message": "Hallo, uw afspraak is bevestigd.", "mobile_date_ms": 1774041004692, "mobile_date_formatted": "2026-03-20 22:10:04", "synchro_time": "2026-03-20 21:10:05" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "nummer": "+447700900123", "bericht": "Uw verificatiecode is 482915.", "mobiele_datum_ms": 1774040902284, "mobiele_datum_opmaak": "2026-03-20 22:08:22", "synchronisatietijd": "2026-03-20 21:08:35" }, { "identificatie": "e5b70a8a28b2ec3d", "nummer": "+33198765432", "bericht": "Bedankt voor uw bestelling. Deze wordt nu verwerkt.", "mobiele_datum_ms": 1774026491230, "mobiele_datum_opmaak": "2026-03-20 18:08:11", "synchro_time": "2026-03-20 17:19:19" } ] } }

Toelichting op het antwoord:

SMS ontvangen

Via dit eindpunt kunt u sms-berichten ophalen die op de smartphone zijn ontvangen. 

Eindpunt:

Parameters: 

Voorbeeldverzoek:

Voorbeeld van een JSON-antwoord:

{ "result": { "error": "", "sms": [ { "id": 466340, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320222332804", "indice": "27593", "message": "Hallo, uw pakket is bezorgd.", "number": "+15551234567", "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466341, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320221005892", "indice": "27591", "message": "Uw afspraak is bevestigd voor morgen.", "number": "+447700900123", "guid": "BF3B38D7-8401-4A8C-8BA6-D8D58ACBB23E", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466324, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:08:24", "timestamp_unix": 1774040904, "time_received": "20260320220822763", "indice": "27590", "message": "Bel ons terug wanneer we beschikbaar zijn.", "number": "+33198765432", "guid": "08C88E20-9B98-453F-B361-9BB06D3275D6", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466156, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "19:05:22", "timestamp_unix": 1774033522, "time_received": "20260320200026246", "indice": "27588", "message": "Herinnering: uw accountbeoordeling is in behandeling.", "number": "10001", "guid": "551B2CF4-9330-4DD2-B2BA-5A4026EEEB15", "alias": null, "apikey": "YOUR_API_KEY_HASH" } ] } }

Toelichting op het antwoord:

Markeer ontvangen SMS-berichten als gelezen

Dit API-eindpunt wordt gebruikt om een ontvangen sms-bericht als gelezen te markeren. Alleen API-status.
Dit verandert de leesstatus op de smartphone niet.  

Eindpunt:

Parameter: 

Voorbeeld:

SMS-alias bijwerken

Dit API-eindpunt wordt gebruikt om de alias van een ontvangen sms-bericht bij te werken met behulp van de GUID.

Opmerking: De alias De parameter kan leeg zijn. In dat geval wordt de alias verwijderd.

Eindpunt:

Parameters: 

Voorbeeld: 

Voorbeeld om de alias te wissen:

SMS verwijderen

Met dit eindpunt kunt u sms-berichten verwijderen uit het logboek van de SMSMobileAPI-server.

Eindpunt: 

Parameters:

Voorbeeldverzoek:

Voorbeeld van een JSON-antwoord:

{ "result": { "error": null, "count_delete": 1 } }

Toelichting op het antwoord:

Let op: alleen sms-berichten die in de serverlogboeken van SMSMobileAPI zijn opgeslagen, worden verwijderd. Sms-berichten die al op het mobiele apparaat zijn opgeslagen, worden niet verwijderd.

Lijst met sms-gesprekken

Dit API-eindpunt wordt gebruikt om sms-gesprekken weer te geven die aan uw account zijn gekoppeld.

Elk gesprek is gegroepeerd op telefoonnummer en bevat de bijbehorende inkomende en uitgaande sms-berichten.

Opmerking: Het uitgangspunt van het gesprek wordt bepaald door de origineConversation parameter:

• receivedGesprekken worden eerst gedetecteerd aan de hand van ontvangen sms-berichten. logsmsreceive
• sentGesprekken worden eerst gedetecteerd aan de hand van verzonden sms-berichten. logsmssent

Opmerking: Als numero Als deze optie niet wordt opgegeven, retourneert de API alleen de meest recente gesprekken. Standaard wordt het laatste gesprek geretourneerd. 20 Gesprekken worden beantwoord.

Opmerking: Voor uitgaande sms-berichten, indien timearea_of_message is beschikbaar (voorbeeld: UTC+02), wordt de weergegeven datum automatisch geconverteerd met behulp van deze waarde. Deze geconverteerde datum wordt ook gebruikt voor sortering.

Opmerking: Als resume=1Alleen de meest recente berichten van elk gesprek worden weergegeven. Gebruik resume_line_how om te bepalen hoeveel recente berichten moeten worden opgenomen.

Eindpunt:

Parameters: 

Details over het gedrag: 

Voorbeeld 1 - Lijst met de meest recente gesprekken uit ontvangen sms-berichten: 

Voorbeeld 2 - Lijst met de meest recente gesprekken van verzonden sms-berichten:

Voorbeeld 3 - Filter één specifiek telefoonnummer:

Voorbeeld 4 - Filteren op datumbereik:

Voorbeeld 5 - Hervatmodus met de laatste 3 berichten per gesprek:

Voorbeeld van een succesvol antwoord: 

{ "success": true, "originConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Hallo, ik wil graag meer informatie.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Natuurlijk, wat wilt u weten?", "status": "sent", "mobile_sid": "device_sid_2" } ] } ] }

Antwoordvelden:

Foutvoorbeeld:

{ "success": false, "error": "Vereiste parameter ontbreekt: apikey" }

Opmerkingen:

Gateway – Lijst met verbonden mobiele apparaten

Lijst met mobiele telefoons die verbonden zijn met uw SMS-gateway.

Eindpunt:

Parameters:

Voorbeeld:

Gateway – Een mobiel label bijwerken

Het label (nom_reference) van een verbonden mobiel apparaat bijwerken.

Eindpunt:

Parameters:

Voorbeeld:

Belangrijk: Een label is verplicht, maar mag leeg zijn. (label=).

Gateway – Verwijder een verbonden mobiel apparaat

Verwijder een verbonden mobiel apparaat van uw gateway (hiermee worden alle geschiedenisregels voor deze SID verwijderd).

Eindpunt:

Parameters:

Voorbeeld:

Webhook – SMS ontvangen

Dit webhooksysteem stuurt een POST-verzoek naar de geconfigureerde URL wanneer er een sms-bericht wordt ontvangen. Het systeem zorgt voor realtime updates door de sms-gegevens naar de opgegeven webhook-URL te sturen.

Hoe u de webhook in het dashboard configureert

Volg deze stappen om uw webhook-URL in het dashboard in te stellen:

1. Meld u aan bij uw account op de SMS Mobiel API Dashboard.
2. Navigeer naar de Webhook-instellingen sectie.
3. Voer uw webhook-URL in (bijv. https://example.com/webhook-endpoint).
4. Klik op de Webhook opslaan knop. 
5. Nadat u de gegevens hebt opgeslagen, stuurt het systeem sms-gegevens naar de geconfigureerde URL.

Webhook-payload

Wanneer een SMS wordt ontvangen, stuurt het systeem de volgende JSON-payload naar uw webhook-URL:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Hallo, dit is een test.", "number": "+123456789", "guid": "abcde12345" }

Payloadvelden:

• datum: Datum waarop het SMS-bericht is toegevoegd (JJJJ-MM-DD).
• uur: Uur waarop het SMS-bericht is toegevoegd (UU:mm:ss).
• tijd_ontvangen: Tijdstip waarop het SMS-bericht is ontvangen.
• bericht: Inhoud van het SMS-bericht. 
• nummer: Telefoonnummer van de afzender.
• gids: Unieke identificatie van het SMS-bericht.

Voorbeeld Webhook-eindpunt

Je server zou klaar moeten zijn om inkomende POST-verzoeken te verwerken. Hieronder staat een voorbeeld van een PHP-script om de webhook-payload te verwerken:

De webhook testen

Om uw webhookconfiguratie te testen, kunt u de volgende hulpmiddelen gebruiken:

• Webhook.site
• RequestBin

Probleemoplossing

• Zorg ervoor dat de webhook-URL correct en openbaar toegankelijk is.
• Controleer of uw server een HTTP 200-statuscode retourneert voor succesvolle verzoeken.
• Controleer de logs van uw server op eventuele fouten bij het verwerken van de payload.

Verrijkte sms

Authenticatie

De SMSMobile API ondersteunt twee authenticatiemethoden: met een eenvoudige API-sleutel of met het OAuth2-protocol met een client-ID en clientgeheim.

1. API-sleutelauthenticatie

 Deze methode vereist een API-sleutel die als parameter kan worden meegestuurd in een GET- of POST-verzoek.

2. OAuth2-authenticatie

OAuth2 biedt een veiligere authenticatiemethode.
Gebruik een client-ID en clientgeheim om een toegangstoken te verkrijgen en voeg dit vervolgens toe aan de Autorisatie koptekst.

De client_id en client_secret zijn beschikbaar in uw dashboard.
Download nu de mobiele app of toegang tot uw dashboard.

Een toegangstoken verkrijgen

Het toegangstoken gebruiken:

Welke methode moet u gebruiken?

- Gebruik API-sleutelauthenticatie voor snelle en eenvoudige integraties.

- Gebruik OAuth2-authenticatie voor verbeterde beveiliging en schaalbaarheid.