Hier beginnen
Ihre erste Anfrage in vier Schritten
Verbinden und aktivieren Sie WhatsApp für ein unterstütztes Mobilgerät.
Bestätigen Sie den Empfänger mit dem Nummernprüfendpunkt.
Senden Sie mit waonly=yes.
Bei eingehenden Nachrichten aktivieren Sie das Abrufen, synchronisieren und rufen dann /getwa auf.
Offizielle mobile Anwendung
Die sichere Brücke zwischen Ihrem Telefon, Dashboard und API.
SMS- und Anrufvorgänge werden über die offizielle SMSMobileAPI-App abgewickelt, die auf Ihrem angeschlossenen Telefon installiert ist. Die App koppelt das Gerät sicher mit Ihrem Konto, synchronisiert autorisierte Ereignisse und verbindet das Mobilfunknetz mit dem Dashboard und REST API.
- Signierte Releases, die über die offiziellen Google Play- und Apple App Store-Listen verteilt werden
- Google und Apple Plattform Überprüfung, Signierung und Verteilungskontrollen
- Sichere Gerätepaarung, HTTPS-Transport und authentifizierter API-Zugang
- Nur die Berechtigungen, die für die von Ihnen aktivierten mobilen Funktionen erforderlich sind
Authentifizierung
Bewahren Sie Ihre Anmeldeinformationen auf Ihrem Server auf
Verwenden Sie apikey für direkte Integrationen. OAuth2 Client-Anmeldeinformationen sind für serverseitige Anwendungen verfügbar; fordern Sie ein Token an und senden Sie es als Autorisierung: Bearer ACCESS TOKEN.
POST
Senden Sie eine WhatsApp Nachricht
https://api.smsmobileapi.com/sendsmsSendet einen WhatsApp-Text oder unterstützte Medien durch die angeschlossene Umgebung.
Verwenden Sie es für einzelne Empfänger oder eine Dashboard-Kontaktgruppe.
Parameter
| Name | Typ | Anforderungen | Beschreibung |
|---|---|---|---|
apikey |
Zeichenkette | Erforderlich | Ihr API-Schlüssel; Weglassen bei Verwendung eines Bearer-Tokens. |
recipients |
Telefon | Erforderlich | Ländervorwahl plus Nummer, ohne + oder 00. |
message |
Zeichenkette | Erforderlich | Textkörper; mehrere Zeilen werden unterstützt. |
waonly |
Ja | Erforderlich | Muss ja sein, um die Lieferung nur von WhatsApp anzufordern. |
url_media |
HTTPS URL | Fakultativ | Öffentliche PDF, Dokument, Archiv oder JPG / PNG URL. |
url_media_shorted |
Ja | Fakultativ | Verwenden Sie eine verkürzte Download-URL mit PDF-Vorschaumodus. |
pdf_with_image |
Ja | Fakultativ | Fügen Sie eine Bildvorschau für ein PDF hinzu. |
encrypt_message |
Ja | Fakultativ | Erfordern Sie eine empfängerseitige Entschlüsselung. |
contactGroup |
LEITLINIE | Fakultativ | Senden Sie an jeden Kontakt in einer Dashboard-Gruppe. |
Anfordern Beispiel
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."Beispielantwort
{
"result": {
"error": 0,
"sent": "1",
"id": "MESSAGE_GUID",
"send_with_whatsapp": "1"
}
}Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.
Schlüssel verbinden ↑- Unterstützte Medien-URLs müssen öffentliche HTTPS-Ressourcen sein.
- Formatierung von WhatsApp: * fett *, italic , ~strikethrough~ und Triple-Backtick-Monospace.
POST
Senden Sie eine nicht gesendete WhatsApp-Nachricht erneut
https://api.smsmobileapi.com/resendwa/Retriet eine WhatsApp-Nachricht, die derzeit einen Fehlerstatus hat.
Verwenden Sie es nach der Diagnose eines fehlgeschlagenen WhatsApp-Logeintrags.
Parameter
| Name | Typ | Anforderungen | Beschreibung |
|---|---|---|---|
apikey |
Zeichenkette | Erforderlich | Ihr API-Schlüssel. |
guid |
Zeichenkette | Erforderlich | GUID der fehlgeschlagenen Nachricht. |
Anfordern Beispiel
curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.
Schlüssel verbinden ↑- Nur fehlgeschlagene Nachrichten sind zum erneuten Senden berechtigt.
ERHALTEN
Aktivieren Sie Inbound Retrieval
https://api.smsmobileapi.com/getwa/active/Aktiviert, deaktiviert oder schaltet WhatsApp Nachrichtenabruf.
Rufen Sie es einmal auf, bevor Sie die eingehende WhatsApp-Synchronisation verwenden.
Parameter
| Name | Typ | Anforderungen | Beschreibung |
|---|---|---|---|
apikey |
Zeichenkette | Erforderlich | Ihr API-Schlüssel. |
statut |
0 | 1 | x | Fakultativ | 1 aktiviert, 0 deaktiviert, x oder Auslassen schaltet den aktuellen Zustand um. |
Anfordern Beispiel
curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"Beispielantwort
{
"success": true,
"read_message_active": 1,
"status_note": "Activated"
}Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.
Schlüssel verbinden ↑- Inbound Retrieval ist standardmäßig für die Privatsphäre deaktiviert.
ERHALTEN
Synchronisieren eingehender Nachrichten
https://api.smsmobileapi.com/getwa/synchronisation/Fordert eine neue WhatsApp-Synchronisation vor dem Abruf an.
Rufen Sie es unmittelbar vor /getwa auf, wenn Ihre Anwendung aktuelle eingehende Daten benötigt.
Parameter
| Name | Typ | Anforderungen | Beschreibung |
|---|---|---|---|
apikey |
Zeichenkette | Erforderlich | Ihr API-Schlüssel. |
Anfordern Beispiel
curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"Beispielantwort
{
"error": "0",
"messages": "synchronized",
"expire_at": "2026-03-11 12:27:00",
"expire_at_unix": "1773232020"
}Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.
Schlüssel verbinden ↑- Synchronisation ist nur für den Empfang von Nachrichten. Rufen Sie es nicht an, bevor Sie es senden.
ERHALTEN
WhatsApp Nachrichten abrufen
https://api.smsmobileapi.com/getwaGibt synchronisierte eingehende WhatsApp-Nachrichten zurück.
Verwenden Sie es nach dem Aktivieren und Synchronisieren des Inbound-Retrievals.
Parameter
| Name | Typ | Anforderungen | Beschreibung |
|---|---|---|---|
apikey |
Zeichenkette | Erforderlich | Ihr API-Schlüssel. |
before |
Unix Zeitstempel | Fakultativ | Geben Sie Datensätze vor diesem Zeitstempel zurück. |
date |
JJJJ-MM-TT | Fakultativ | Retournieren Sie Datensätze für ein Datum. |
message_type |
text | Audio | Fakultativ | Textnachrichten oder Audionachrichten, die in Text konvertiert wurden, filtern; bei beiden weglassen. |
Anfordern Beispiel
curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"Beispielantwort
{
"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"
}Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.
Schlüssel verbinden ↑
ERHALTEN
Überprüfen Sie eine WhatsApp-Nummer
https://api.smsmobileapi.com/whatsapp/checknumber/Prüft, ob eine Telefonnummer auf WhatsApp verfügbar ist.
Verwenden Sie es vor dem Senden, um vermeidbare Fehler zu reduzieren.
Parameter
| Name | Typ | Anforderungen | Beschreibung |
|---|---|---|---|
apikey |
Zeichenkette | Erforderlich | Ihr API-Schlüssel. |
recipients |
Telefon | Erforderlich | Ländervorwahl plus Nummer, ohne + oder 00. |
Anfordern Beispiel
curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"Beispielantwort
{
"contact_found_on_whatsapp": "yes",
"recipients": "19176728660"
}Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.
Schlüssel verbinden ↑
STRASSE
Erstellen Sie ein OAuth2-Zugriffstoken
https://api.smsmobileapi.com/oauth2/tokenTauscht Client-Anmeldeinformationen für ein Bearer-Token aus.
Verwenden Sie es für Server-zu-Server-Integrationen, bei denen kurzlebige Anmeldeinformationen bevorzugt werden.
Parameter
| Name | Typ | Anforderungen | Beschreibung |
|---|---|---|---|
grant_type |
Zeichenkette | Erforderlich | Es muss client credentials sein. |
client_id |
Zeichenkette | Erforderlich | Client-ID aus dem Dashboard. |
client_secret |
Zeichenkette | Erforderlich | Client Secret aus dem Dashboard. |
Anfordern Beispiel
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"Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.
Schlüssel verbinden ↑- Halten Sie den Client auf Ihrem Server geheim. Fügen Sie es niemals in den mobilen oder Browsercode ein.
Fehlerbehebung
Fehler und sichere Versuche
Lesen Sie den HTTP-Status und das JSON-Fehlerfeld, bevor Sie es erneut versuchen. Versuchen Sie keine Validierungs- oder Authentifizierungsfehler erneut, ohne die Anforderung zuerst zu korrigieren.
| HTTP | Code | Was zu tun ist |
|---|---|---|
| 400 | missing_parameter | Ein erforderlicher Parameter ist leer oder fehlt. Überprüfen Sie die Parametertabelle für den Endpunkt. |
| 403 | invalid_apikey | Der API-Schlüssel ist unbekannt, abgelaufen oder nicht für die angeforderte Funktion autorisiert. |
| 429 | too_many_requests | Anfragen kommen zu schnell. Warten Sie, dann versuchen Sie es mit exponentiellem Backoff. |
| 500 | server_error | Der Dienst konnte die Anfrage nicht abschließen. Behalten Sie die Antwort und den Kontakt-Support bei, wenn sie bestehen bleibt. |
Brauchen Sie Hilfe?
Bringen Sie den Anfragekontext mit - nicht Ihre Geheimnisse.
Teilen Sie den Endpunkt, den Zeitstempel, den HTTP-Status und die desinfizierte Antwort. Fügen Sie niemals API-Schlüssel, Token oder private Nachrichteninhalte hinzu.
