Dev DOC WhatsApp - SMSMobileAPI

This documentation is specific to sending a WhatsApp message only. It is also possible to send a WhatsApp message and an SMS simultaneously.

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.

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

API REST

cURL

JavaScript

Python

Node.js

Rubin

WSDL

Send WhatsApp API

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 zum Senden von SMS

Diese Methode erfordert einen API-Schlüssel, der als Parameter in einer GET- oder POST-Anfrage enthalten sein kann. Dies ist eine unkomplizierte Möglichkeit, Ihre API-Anfragen zu authentifizieren.

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

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: The message to send (Multiple lines possible).

- waonly: must have the value yes -> Required to specify that only one WhatsApp message should be sent

Beispiel:

GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEYY&waonly=yes&recipients=191728660&message=Hello%20World

2. OAuth2-Authentifizierung zum Senden von SMS

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 und können nach der Installation der App und der Erstellung eines Kontos auf Ihrem Mobilgerät aufgerufen werden.
Laden Sie jetzt die mobile App herunter oder Greifen Sie auf Ihr Dashboard zu.

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 "Autorisierung: Inhaber abc123xyz456" \
 -H "Inhaltstyp: Anwendung/x-www-form-urlencoded" \
 -d "Empfänger=+1234567890" \
 -d "message=Hallo"

Welche Methode sollten Sie verwenden?

- Verwenden API-Schlüsselauthentifizierung für schnelle und unkomplizierte Integrationen.

- Verwenden OAuth2-Authentifizierung für verbesserte Sicherheit und Skalierbarkeit Ihrer Integrationen.

Weitere Einzelheiten finden Sie in der vollständigen Dokumentation.

Send WhatsApp message

WSDL-URL

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

Parameter:

- recipients: The mobile number of the recipient.

- message: The message to send.

- apikey: The API key you have or will receive.

- waonly: must have the value yes -> Required to specify that only one WhatsApp message should be sent.

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);

Send WhatsApp

Grundlegender cURL-Befehl

You can use the following cURL command to send a WhatsApp message via the SMSmobileAPI:

 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

If you're using PHP, here's how you can send an WhatsApp message using cURL:

 <?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.

Send WhatsApp

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

Verwenden der `requests`-Bibliothek

The `requests` library is a popular and simple HTTP library for Python. Here's how you can use it to send an WhatsApp message via the SMSmobileAPI:

 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)

This example demonstrates a simple POST request to the SMSmobileAPI, sending a WhatsApp message to a specific phone number.

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.

Send WhatsApp

Verwenden der „Fetch“-API

The `fetch` API is a modern and versatile way to make HTTP requests in JavaScript. Here's how you can use it to send a WhatsApp message via the SMSmobileAPI:

 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.

Send WhatsApp

Verwenden der `axios`-Bibliothek

The `axios` library is a popular HTTP client for Node.js. Here's how you can use it to send a WhatsApp message via the SMSmobileAPI:

 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.

Send WhatsApp

Verwenden der `Net::HTTP`-Bibliothek

You can use the `Net::HTTP` library in Ruby to send a WhatsApp message via the SMSmobileAPI:

 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.