Productie-ready mobiele infrastructuurHTTPS API · Android & iOS · Gedocumenteerd einde tot eindeHet platform verkennen
PLATFORMAPI-eerste architectuurBeveiligde apparaat koppelingZichtbaarheid van de leveringMulti-apparaatbesturingVersiede documentatie
Ontwikkelaarshub/WhatsApp-API

WA · 7 gedocumenteerde verrichtingen

WhatsApp API documentatie

WhatsApp berichten en media versturen, fouten opnieuw proberen, binnenkomende berichten synchroniseren en ontvangernummers verifiëren.

Aangesloten telefoons synchroniseren gesprekken en media
REST basis-URLhttps://api.smsmobileapi.com

JSON responsen · HTTPS vereist · UTF-8

Sluit uw API-sleutel aan

Verbind eenmaal, test dan eindpunten over sms, oproepen, meldingen, WhatsApp en e-mail.

Start hier

Uw eerste verzoek in vier stappen

1

Verbind en schakel WhatsApp in voor een ondersteunde mobiele telefoon.

2

Bevestig de ontvanger met het nummercontrole eindpunt.

3

Stuur met alleen maar ja.

4

Voor binnenkomende berichten, activeer ophalen, synchroniseren en bel /getwa.

De veilige SMSMobileAPI mobiele app die een telefoon verbindt met het webdashboard en REST API voor SMS- en oproepoperaties
Versleutelde mobiele-naar-platformverbinding

Officiële mobiele applicatie

De veilige brug tussen uw telefoon, dashboard en API.

SMS- en oproepoperaties gaan door via de officiële SMSMobileAPI-app die op uw aangesloten telefoon is geïnstalleerd. De app koppelt het apparaat veilig met uw account, synchroniseert geautoriseerde evenementen en koppelt het mobiele netwerk aan het dashboard en REST API.

1Mobiele appVergelijkt de telefoon en de SIM 2Versleutelde verwijzingAuthenticeert en beschermt gegevens tijdens de doorvoer 3Dashboard & APIControleert workflows en activiteit
  • Ondertekende releases verspreid via de officiële Google Play en Apple App Store lijsten
  • Google en Apple platform review, ondertekening en distributie controles
  • Veilige apparaat koppeling, HTTPS transport en geauthentiseerde API toegang
  • Alleen de rechten die nodig zijn voor de mobiele functies die u aanroept
Ontvang de officiële SMSMobileAPI-app op Google Play Download de officiële SMSMobileAPI-app in de Apple App Store
Mogelijkheden zijn afhankelijk van de toegangsrechten en achtergrondtoegang die door Android of iOS worden toegestaan.

Authenticatie

Houd referenties op uw server

Gebruik apikey voor directe integraties. OAuth2 client-referenties zijn beschikbaar voor server-side toepassingen; vraag een token aan en stuur het als Authorization: Bearer Access TOKEN.

POST · GET

Een WhatsApp-bericht versturen

#
STOPPLIJThttps://api.smsmobileapi.com/sendsms

Stuurt een WhatsApp tekst of ondersteunde media door de aangesloten omgeving.

Wanneer moet u het gebruiken?

Gebruik het voor individuele ontvangers of een dashboard contactgroep.

Parameters

NaamTypeVereistBeschrijving
apikey tekenreeks Vereist Uw API-sleutel; laat weg wanneer u een Bearer token gebruikt.
recipients telefoon Vereist Landcode plus nummer, zonder + of 00.
message tekenreeks Vereist Tekstteksttekst; meerdere regels worden ondersteund.
waonly Ja Vereist Moet ja zijn om WhatsApp-only levering te vragen.
url_media HTTPS URL Facultatief Publieke PDF, document, archief of JPG/PNG URL.
url_media_shorted Ja Facultatief Gebruik een verkorte download-URL met PDF-voorbeeldmodus.
pdf_with_image Ja Facultatief Een afbeeldingsvoorbeeld voor een PDF toevoegen.
encrypt_message Ja Facultatief Vereiste decodering van de ontvanger.
contactGroup GIDS Facultatief Stuur naar elk contact in een dashboardgroep.

Voorbeeld aanvragen

krul
curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=191728660" \
  --data-urlencode "message=Your order is ready."

Voorbeeldantwoord

JSON
{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "MESSAGE_GUID",
    "send_with_whatsapp": "1"
  }
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑
Goed om te weten
  • Ondersteunde media-URL's moeten publieke HTTPS-bronnen zijn.
  • WhatsApp-opmaak: *bold*, italic , ~strikethrough~ en triple-backtick monospace.
POST · GET

Een niet verzonden WhatsApp-bericht opnieuw verzenden

#
STOPPLIJThttps://api.smsmobileapi.com/resendwa/

Verbreekt een WhatsApp-bericht dat momenteel een foutstatus heeft.

Wanneer moet u het gebruiken?

Gebruik het na het diagnosticeren van een mislukt WhatsApp log item.

Parameters

NaamTypeVereistBeschrijving
apikey tekenreeks Vereist Uw API-sleutel.
guid tekenreeks Vereist GIDS van het mislukte bericht.

Voorbeeld aanvragen

krul
curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑
Goed om te weten
  • Alleen mislukte berichten komen in aanmerking voor herverzending.
KRIJGEN

Activeer inkomende ophalen

#
STOPPLIJThttps://api.smsmobileapi.com/getwa/active/

Activeert, deactiveert of schakelt WhatsApp berichtophalen in.

Wanneer moet u het gebruiken?

Bel het één keer voordat u WhatsApp-synchronisatie gebruikt.

Parameters

NaamTypeVereistBeschrijving
apikey tekenreeks Vereist Uw API-sleutel.
statut 0 Facultatief 1 activeert, 0 deactiveert, x of weglating schakelt de huidige toestand aan.

Voorbeeld aanvragen

krul
curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"

Voorbeeldantwoord

JSON
{
  "success": true,
  "read_message_active": 1,
  "status_note": "Activated"
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑
Goed om te weten
  • Inkomende opvraging is standaard uitgeschakeld voor privacy.
KRIJGEN

Synchroniseren van binnenkomende berichten

#
STOPPLIJThttps://api.smsmobileapi.com/getwa/synchronisation/

Verzoekt een nieuwe WhatsApp synchronisatie voordat u ze terugvindt.

Wanneer moet u het gebruiken?

Bel het onmiddellijk voor /getwa wanneer uw toepassing actuele inkomende gegevens nodig heeft.

Parameters

NaamTypeVereistBeschrijving
apikey tekenreeks Vereist Uw API-sleutel.

Voorbeeld aanvragen

krul
curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"

Voorbeeldantwoord

JSON
{
  "error": "0",
  "messages": "synchronized",
  "expire_at": "2026-03-11 12:27:00",
  "expire_at_unix": "1773232020"
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑
Goed om te weten
  • Synchronisatie is alleen voor het ontvangen van berichten. Niet bellen voordat je het verstuurt.
KRIJGEN

WhatsApp-berichten ophalen

#
STOPPLIJThttps://api.smsmobileapi.com/getwa

Geeft gesynchroniseerde inkomende WhatsApp-berichten terug.

Wanneer moet u het gebruiken?

Gebruik het na het activeren en synchroniseren van inkomende ophalen.

Parameters

NaamTypeVereistBeschrijving
apikey tekenreeks Vereist Uw API-sleutel.
before Unix-tijdstempel Facultatief Geef records terug voor deze tijdstempel.
date JJJJ-MM-DD Facultatief Geef records terug voor één datum.
message_type tekst Facultatief Filter tekstberichten of audioberichten omgezet in tekst; laat deze weg voor beide.

Voorbeeld aanvragen

krul
curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"

Voorbeeldantwoord

JSON
{
  "date": "2026-03-11",
  "hour": "12:27:00",
  "timestamp": "1773232020",
  "number": "19176728660",
  "contact": "SMSMobileAPI",
  "message": "When will I receive my order?",
  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑
KRIJGEN

Controleer een WhatsApp-nummer

#
STOPPLIJThttps://api.smsmobileapi.com/whatsapp/checknumber/

Controleert of er een telefoonnummer beschikbaar is op WhatsApp.

Wanneer moet u het gebruiken?

Gebruik het voordat u het verstuurt om te voorkomen dat er fouten optreden.

Parameters

NaamTypeVereistBeschrijving
apikey tekenreeks Vereist Uw API-sleutel.
recipients telefoon Vereist Landcode plus nummer, zonder + of 00.

Voorbeeld aanvragen

krul
curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"

Voorbeeldantwoord

JSON
{
  "contact_found_on_whatsapp": "yes",
  "recipients": "19176728660"
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑
NA

Maak een OAuth2-toegangs token

#
STOPPLIJThttps://api.smsmobileapi.com/oauth2/token

Wisselt cliëntgegevens uit voor een Bearer token.

Wanneer moet u het gebruiken?

Gebruik het voor server-naar-server integraties waar korte-levende referenties de voorkeur hebben.

Parameters

NaamTypeVereistBeschrijving
grant_type tekenreeks Vereist Moet client credenties zijn.
client_id tekenreeks Vereist Klant ID van het dashboard.
client_secret tekenreeks Vereist Cliëntgeheim van het dashboard.

Voorbeeld aanvragen

krul
curl -X POST "https://api.smsmobileapi.com/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑
Goed om te weten
  • Houd de client geheim op je server. Neem het nooit op in mobiele of browsercode.

Problemen oplossen

Fouten en veilige herhalingen

Lees de HTTP status en het JSON foutveld voordat u het opnieuw probeert. Probeer geen validatie of authenticatiefouten opnieuw zonder eerst het verzoek te corrigeren.

HTTPRubriekWat te doen?
400missing_parameterEen vereiste parameter is leeg of ontbreekt. Controleer de parametertabel voor het eindpunt.
403invalid_apikeyDe API sleutel is onbekend, verlopen of niet toegestaan voor de gevraagde functie.
429too_many_requestsDe verzoeken komen te snel. Wacht, probeer het dan opnieuw met exponentiële backoff.
500server_errorDe dienst kon het verzoek niet voltooien. Houd de respons en contact ondersteuning als deze aanhoudt.
Regel opnieuw proberenProbeer slechts voorbijgaande 429 en 5xx responsen. Begin na 1 seconde, dan terug naar 2, 4 en 8 seconden.

Hulp nodig?

Breng de context van het verzoek en niet uw geheimen.

Deel het eindpunt, tijdstempel, HTTP status en gesanitiseerde respons. Neem nooit API sleutels, tokens of privé-inhoud van berichten.

Contact API ondersteuning →