WhatsApp senden
Nachricht erneut senden
Synchronisation
Nachrichten abrufen
Authentifizierung
|
WhatsApp-API senden
Dieser API-Endpunkt wird zum Senden von WhatsApp-Nachrichten verwendet.
Endpunkt:
GET POST https://api.smsmobileapi.com/sendsms
Parameter:
- apikey: Ihr eindeutiger API-Schlüssel.
- recipients: The recipient's phone number (The number must be available on WhatsApp). Enter the phone number starting with the country code (without ‘+’ and without ‘00’),
followed directly by the rest of your number.
Exemple 191728660
- message: Die zu sendende Nachricht (mehrere Zeilen möglich).
- url_media: Die direkte URL der Mediendatei, die Sie über WhatsApp senden möchten. Muss beginnen mit https://
und verweisen auf eine gültige PDF, Dokument oder Bild Datei. Die Datei muss ohne Authentifizierung öffentlich zugänglich sein. Unterstützt: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz
jpg, jpeg, png, gif, bmp, tiff, svg, webp, ico, heic, jfif
- waonly: muss den Wert haben Ja -> Erforderlich, um anzugeben, dass nur eine WhatsApp-Nachricht gesendet werden soll
Beispiel ohne Medien:
GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=191728660&message=Hello%20World
Beispiel mit Medien:
GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=191728660&message=Hello%20World&url_media=https://smsmobileapi.com/logo.png
Text in WhatsApp formatieren:
-
Kursiv: Use underscores → _text_
-
Deutlich: Use asterisks → *text*
-
Durchgestrichen: Use tildes → ~text~
-
Monospace: Use backticks → ```text```
Zum Beispiel: _Hallo_ Welt, wie *geht* es dir ~heute~ von ```SMSMobileAPI```
Nicht gesendete WhatsApp-Nachrichten erneut senden
Dieser API-Endpunkt wird verwendet, um eine nicht gesendete Nachricht erneut zu senden (nur wenn die Nachricht einen Fehlerstatus aufweist).
Endpunkt:
ERHALTEN POST https://api.smsmobileapi.com/resendwa/
Parameter:
- guid: (erforderlich) GUID der erneut zu sendenden Nachricht.
Beispiel:
Holen Sie sich https://api.smsmobileapi.com/resendwa/?apikey=IHR_API_SCHLÜSSEL&guid=GUID_DER_NACHRICHT
Synchronisierung zum Abrufen von Nachrichten
Dieser API-Endpunkt wird verwendet, um eine Anfrage zum Synchronisieren und Abrufen von WhatsApp-Nachrichten zu senden.
Dieser Schritt ist obligatorisch und muss vor dem Aufruf des Endpunkts ausgeführt werden, der die Nachrichten abruft.
Warnung: Die Synchronisierung ist ausschließlich für den Nachrichtenabruf erforderlich. Starten Sie keine Synchronisierung, um eine Nachricht zu senden.
Endpunkt:
GET https://api.smsmobileapi.com/getwa/synchronisation/
Parameter:
- apikey (required): Der API-Schlüssel, den Sie haben oder erhalten werden.
Beispiel:
GET https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY
Antwort :
{
"Fehler": "0",
"messages": "synchronisiert",
"expire_at": "11.03.2025 12:27:00",
"expire_at_unix": "1741692420",
}
WhatsApp-Nachricht abrufen
Dieser API-Endpunkt wird zum Abrufen empfangener WhatsApp-Nachrichten verwendet.
Endpunkt:
GET https://api.smsmobileapi.com/getwa
Parameter:
- apikey (required): Der API-Schlüssel, den Sie haben oder erhalten werden.
- before (optional): Übergeben Sie den Zeitstempel als Parameter und zeigen Sie die Datensätze unterhalb dieses Zeitstempels an.
- date (optional): (JJJJ-MM-TT) Alle Datensätze basierend auf dem Datum abrufen.
Beispiel:
GET https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY
Antwort :
{
"Datum": "11.03.2025",
"Stunde": "12:27:00",
"Zeitstempel": "1741692420",
"Nummer": "19176728660",
"Kontakt": "Smsmobileapi",
"message": "Können Sie mir sagen, wann ich meine Bestellung erhalte?",
"guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c",
"mehr": {
"auto_reply": "1",
"transfert_to_email": "1",
"chatgpt_reply": "1"
},
"chatgpt": {
"prompt_tokens": "900",
"completion_tokens": "10",
"total_tokens": "910",
"total_tokens_cost": "0,182"
"response": "Ihre Bestellung #576 wird morgen versendet."
}
}
Authentifizierung
Die SMSMobile-API unterstützt zwei Authentifizierungsmethoden: die Verwendung eines einfachen API-Schlüssels oder des OAuth2-Protokolls mit einer Client-ID und einem Client-Geheimnis.
1. API-Schlüsselauthentifizierung
Um WhatsApp-Nachrichten über unsere API zu senden oder abzurufen, ist eine Authentifizierung mit einem API-Schlüssel erforderlich. Dies gewährleistet einen sicheren und autorisierten Zugriff auf den Nachrichtendienst. Fügen Sie zur Authentifizierung einfach Ihren API-Schlüssel in die Anfrage ein und beginnen Sie nahtlos mit dem Nachrichtenversand.
2. OAuth2-Authentifizierung
OAuth2 bietet eine sicherere und skalierbarere Authentifizierungsmethode.
Sie müssen eine Client-ID und ein Client-Geheimnis verwenden, um ein Zugriffstoken zu erhalten, das dann in Ihre API-Anfragen aufgenommen werden sollte, indem Sie Genehmigung Kopfzeile.
Die Client-ID und das Client-Geheimnis sind in Ihrem Dashboard verfügbar.
Abrufen eines Zugriffstokens
Um ein Zugriffstoken zu erhalten, senden Sie eine POST-Anfrage mit Ihrer Client-ID und Ihrem Client-Geheimnis an den Token-Endpunkt.
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=1ab0ex4b4c1ef2c800690d" \
-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"
Verwenden des Zugriffstokens:
Sobald Sie den Zugriffstoken haben, fügen Sie ihn in die Genehmigung Header Ihrer API-Anfragen:
curl -X POST https://api.smsmobileapi.com/sendsms?waonly=yes \
-H "Authorization: Bearer abc123xyz456" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "recipients=+1234567890" \
-d "message=Hello"
Which Method Should You Use?
- Use API Key Authentication for quick and straightforward integrations.
- Use OAuth2 Authentication for enhanced security and scalability in your integrations.
|