Dev DOC WhatsApp - SMSMobileAPI

WhatsApp-Dokumentation

Diese Dokumentation bezieht sich speziell auf das Senden und Empfangen von WhatsApp-Nachrichten.

Klicken Sie hier, um mehr zu erfahren über alle Funktionen, die unsere WhatsApp-Integration bietet.

Bei SMSmobileAPI sind wir bestrebt, unsere API so kompatibel wie möglich mit jeder Architektur oder Plattform zu machen.
Egal, ob Sie REST, SOAP, cURL oder verschiedene Programmiersprachen wie Python, JavaScript, PHP und mehr verwenden, unsere API ist für die nahtlose Integration in Ihre Projekte konzipiert.

Wir haben auch gebrauchsfertige Plugins für E-Commerce-Lösungen und -Software. Klicken Sie hier, um sie zu entdecken.

API REST

cURL

JavaScript

Python

Node.js

Rubin

WSDL

WhatsApp-API senden

Dieser API-Endpunkt wird zum Senden von WhatsApp-Nachrichten verwendet.

Endpunkt:

GET POST https://api.smsmobileapi.com/sendsms

Parameter:

Parameter	Beschreibung
apikey	Erforderlich Ihr einzigartiger API-Schlüssel.
recipients	Erforderlich Die Telefonnummer des Empfängers (Die Nummer muss auf WhatsApp verfügbar sein). Geben Sie die Telefonnummer beginnend mit der Landesvorwahl (ohne „+“ und ohne „00“) ein, direkt gefolgt vom Rest Ihrer Nummer. Beispiel: 191728660
message	Erforderlich Die zu sendende Nachricht (mehrere Zeilen möglich).
waonly	Erforderlich Muss den Wert haben Ja → Erforderlich, um anzugeben, dass nur eine WhatsApp-Nachricht gesendet werden soll.
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ützte Formate: Unterlagen: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz Bilder: jpg, jpeg, png
url_media_shorted	Wenn der Wert Ja, und [pdf_with_image=yes] gesetzt ist, erfolgt die Anzeige des Downloadlinks für das PDF über eine Kurz-URL.
pdf_with_image	Wenn der Wert Ja, wird zusätzlich zur Nachricht eine Bildvorschau der PDF-Datei angezeigt (nur wenn es sich bei der Datei um eine PDF-Datei handelt).
encrypt_message	Ja = Die Nachricht wird beim Lesen durch den Empfänger verschlüsselt. Der Empfänger muss einen eindeutigen Schlüssel eingeben, um die Nachricht zu entschlüsseln. Erfahren Sie mehr über die Nachrichtenverschlüsselung

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: Unterstriche verwenden → _Text_
Deutlich: Verwenden Sie Sternchen → *Text*
Durchgestrichen: Tilden verwenden → ~Text~
Monospace: Backticks verwenden → ```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:

Parameter	Beschreibung
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:

Parameter	Beschreibung
apikey (required)	Erforderlich 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:

Parameter	Beschreibung
apikey	Erforderlich Der API-Schlüssel, den Sie haben oder erhalten werden.
before	Übergeben Sie den Zeitstempel als Parameter und zeigen Sie die Datensätze unterhalb dieses Zeitstempels an.
date	(JJJJ-MM-TT) Alle Datensätze basierend auf dem Datum abrufen.
message_type	Leer lassen, um alles anzuzeigen (Text- und Audionachrichten) Verwenden `Text` um nur Textnachrichten anzuzeigen Verwenden `Audio-` um nur in Text umgewandelte Audionachrichten anzuzeigen

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.

WhatsApp-Nachricht senden

WSDL-URL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Parameter:

- recipients: Die Handynummer des Empfängers.

- message: Die zu sendende Nachricht.

- apikey: Der API-Schlüssel, den Sie haben oder erhalten werden.

- waonly: muss den Wert haben Ja -> Erforderlich, um anzugeben, dass nur eine WhatsApp-Nachricht gesendet werden soll.

Beispiel


                require_once "lib/nusoap.php";

                

                $client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

                $error  = $client->getError();

                

                $result = $client->call("sendSms", array("waonly" =>"yes","recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

                

                print_r($result);

WhatsApp senden

Grundlegender cURL-Befehl

Um eine WhatsApp-Nachricht über die SMSmobileAPI zu versenden, können Sie folgenden cURL-Befehl verwenden:


        curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

cURL-Beispiel in PHP

Wenn Sie PHP verwenden, können Sie mit cURL wie folgt eine WhatsApp-Nachricht senden:


        <?php

        

        $url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'


        );

        

        $options = array(

            CURLOPT_URL => $url,

            CURLOPT_POST => true,

            CURLOPT_POSTFIELDS => http_build_query($data),

            CURLOPT_RETURNTRANSFER => true,

        );

        

        $ch = curl_init();

        curl_setopt_array($ch, $options);

        $response = curl_exec($ch);

        curl_close($ch);

        

        echo $response;

        

        ?>

Dieses PHP-Beispiel zeigt, wie mit cURL eine POST-Anfrage an die SMSmobileAPI gesendet wird und dabei die erforderlichen Parameter als assoziatives Array übergeben werden.

WhatsApp senden

Nutzen Sie unser offizielles Python-Modul: https://smsmobileapi.com/python/
oder verwenden Sie die manuelle Methode ...

Verwenden der `requests`-Bibliothek

Die Bibliothek „requests“ ist eine beliebte und einfache HTTP-Bibliothek für Python. So können Sie sie verwenden, um eine WhatsApp-Nachricht über die SMSmobileAPI zu senden:


        import requests



        url = "https://api.smsmobileapi.com/sendsms/waonly=yes"



        payload = {

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        }



        response = requests.post(url, data=payload)



        print(response.text)

Dieses Beispiel demonstriert eine einfache POST-Anfrage an die SMSmobileAPI, die eine WhatsApp-Nachricht an eine bestimmte Telefonnummer sendet.

Verwenden der `http.client`-Bibliothek

Die Bibliothek „http.client“ ist in der Standardbibliothek von Python enthalten und kann auch zur Interaktion mit Ihrer API verwendet werden:


        import http.client

        import urllib.parse



        conn = http.client.HTTPSConnection("api.smsmobileapi.com")



        params = urllib.parse.urlencode({

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        })



        headers = { "Content-type": "application/x-www-form-urlencoded" }



        conn.request("POST", "/sendsms/?waonly=yes", params, headers)

        response = conn.getresponse()

        data = response.read()



        print(data.decode("utf-8"))

        conn.close()

Dieses Beispiel zeigt, wie man mit der Bibliothek `http.client` eine POST-Anfrage an die API sendet. Die Parameter werden URL-codiert und mit den entsprechenden Headern gesendet.

WhatsApp senden

Verwenden der „Fetch“-API

Die `fetch`-API ist eine moderne und vielseitige Möglichkeit, HTTP-Anfragen in JavaScript zu stellen. So können Sie damit eine WhatsApp-Nachricht über die SMSmobileAPI senden:


        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = {

            recipients: "PHONE_NUMBER",

            message: "YOUR_MESSAGE",

            apikey: "YOUR_API_KEY"

        };



        fetch(url, {

            method: "POST",

            headers: {

                "Content-Type": "application/x-www-form-urlencoded"

            },

            body: new URLSearchParams(data)

        })

        .then(response => response.text())

        .then(result => console.log(result))

        .catch(error => console.error("Error:", error));

Dieses Beispiel zeigt, wie eine POST-Anfrage mit der „fetch“-API gesendet wird, die von den meisten modernen Browsern unterstützt wird.

Verwenden von „XMLHttpRequest“

Wenn Sie ältere Browser unterstützen müssen, können Sie das Objekt „XMLHttpRequest“ verwenden:


        const xhr = new XMLHttpRequest();

        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";



        xhr.open("POST", url, true);

        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");



        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 && xhr.status === 200) {

                console.log(xhr.responseText);

            }

        };



        xhr.send(data);

Dieses Beispiel zeigt, wie man „XMLHttpRequest“ zum Senden einer POST-Anfrage verwendet und so Kompatibilität mit älteren Browsern gewährleistet, die „fetch“ möglicherweise nicht unterstützen.

WhatsApp senden

Verwenden der `axios`-Bibliothek

Die `axios`-Bibliothek ist ein beliebter HTTP-Client für Node.js. So können Sie damit eine WhatsApp-Nachricht über die SMSmobileAPI senden:


        const axios = require('axios');



        const url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        const data = {

            recipients: 'PHONE_NUMBER',

            message: 'YOUR_MESSAGE',

            apikey: 'YOUR_API_KEY'

        };



        axios.post(url, data)

        .then(response => {

            console.log(response.data);

        })

        .catch(error => {

            console.error('Error:', error);

        });

Dieses Beispiel zeigt, wie Sie mit „axios“ in Node.js eine POST-Anfrage senden, um mit der SMSmobileAPI zu interagieren.

WhatsApp senden

Verwenden der `Net::HTTP`-Bibliothek

Sie können die Bibliothek „Net::HTTP“ in Ruby verwenden, um eine WhatsApp-Nachricht über die SMSmobileAPI zu senden:


        require 'net/http'

        require 'uri'



        uri = URI.parse("https://api.smsmobileapi.com/sendsms/?waonly=yes")

        request = Net::HTTP::Post.new(uri)

        request.set_form_data(

            "recipients" => "PHONE_NUMBER",

            "message" => "YOUR_MESSAGE",

            "apikey" => "YOUR_API_KEY"

        )



        req_options = {

            use_ssl: uri.scheme == "https",

        }



        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

            http.request(request)

        end



        puts response.body

Dieses Beispiel zeigt, wie eine POST-Anfrage mit „Net::HTTP“ in Ruby an die SMSmobileAPI gesendet wird.

Es ist auch möglich, eine WhatsApp-Nachricht und eine SMS gleichzeitig senden.

Wenn Sie Fragen oder Anregungen haben oder Hilfe benötigen, steht Ihnen unser Team gerne zur Verfügung.
Kontaktieren Sie uns gerne unter api@smsmobileapi.com

SMS-Funktionen

WhatsApp-Funktionen

Allgemeine Plugins

Online-Shop-Plugins

API und Entwicklerdokumente

Tools & Änderungsprotokoll

WhatsApp-Dokumentation

WhatsApp senden

Nachricht erneut senden

Synchronisation

Nachrichten abrufen

Authentifizierung

WhatsApp-API senden

Endpunkt:

Parameter:

Beispiel ohne Medien:

Beispiel mit Medien:

Text in WhatsApp formatieren:

Nicht gesendete WhatsApp-Nachrichten erneut senden

Endpunkt:

Parameter:

Beispiel:

Synchronisierung zum Abrufen von Nachrichten

Endpunkt:

Parameter:

Beispiel:

Antwort :

WhatsApp-Nachricht abrufen

Endpunkt:

Parameter:

Beispiel:

Antwort :

Authentifizierung

1. API-Schlüsselauthentifizierung

2. OAuth2-Authentifizierung

Abrufen eines Zugriffstokens

Verwenden des Zugriffstokens:

Which Method Should You Use?

WhatsApp-Nachricht senden

WSDL-URL

Parameter:

Beispiel

WhatsApp senden

Grundlegender cURL-Befehl

cURL-Beispiel in PHP

WhatsApp senden

Verwenden der `requests`-Bibliothek

Verwenden der `http.client`-Bibliothek

WhatsApp senden

Verwenden der „Fetch“-API

Verwenden von „XMLHttpRequest“

WhatsApp senden

Verwenden der `axios`-Bibliothek

WhatsApp senden

Verwenden der `Net::HTTP`-Bibliothek