Envoyer l'API WhatsApp
L'API SMSMobile prend en charge deux méthodes d'authentification : à l'aide d'une simple clé API ou du protocole OAuth2 avec un ID client et un secret client.
1. Authentification par clé API pour l'envoi de SMS
Cette méthode nécessite une clé API qui peut être incluse comme paramètre dans une requête GET ou POST. Il s'agit d'un moyen simple d'authentifier vos requêtes API.
https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND
Paramètres:
- apikey:Votre clé API unique.
- recipients:Le numéro de téléphone du destinataire (le numéro doit être disponible sur WhatsApp).
- message:Le message à envoyer (Plusieurs lignes possibles).
- waonly:doit avoir la valeur Oui -> Obligatoire pour spécifier qu'un seul message WhatsApp doit être envoyé
Exemple:
GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEYY&waonly=yes&recipients=+1234567890&message=Hello%20World
2. Authentification OAuth2 pour l'envoi de SMS
OAuth2 fournit une méthode d’authentification plus sécurisée et évolutive.
Vous devrez utiliser un identifiant client et un secret client pour obtenir un jeton d'accès, qui doit ensuite être inclus dans vos requêtes API à l'aide de l' Autorisation en-tête.
Le client_id et le client_secret sont disponibles dans votre tableau de bord, accessibles après l'installation de l'application et la création d'un compte sur votre appareil mobile.
Téléchargez l'application mobile maintenant ou
accédez à votre tableau de bord. Obtention d'un jeton d'accès
Pour obtenir un jeton d'accès, envoyez une requête POST au point de terminaison du jeton avec votre ID client et votre secret client.
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"
Utilisation du jeton d’accès :
Une fois que vous avez le jeton d'accès, incluez-le dans le Autorisation en-tête de vos requêtes API :
curl -X POST https://api.smsmobileapi.com/sendsms?waonly=yes \
-H "Autorisation : Porteur abc123xyz456" \
-H "Type de contenu : application/x-www-form-urlencoded" \
-d "destinataires=+1234567890" \
-d "message=Bonjour"
Quelle méthode devriez-vous utiliser ?
- Utiliser Authentification par clé API pour des intégrations rapides et simples.
- Utiliser Authentification OAuth2 pour une sécurité et une évolutivité améliorées dans vos intégrations.
Pour plus de détails, veuillez vous référer à la documentation complète.
Envoyer un message WhatsApp
URL WSDL
https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl
Paramètres:
- recipients: Le numéro de téléphone portable du destinataire.
- message: Le message à envoyer.
- apikey: La clé API que vous possédez ou que vous recevrez.
- waonly: doit avoir la valeur Oui -> Obligatoire pour spécifier qu'un seul message WhatsApp doit être envoyé.
Exemple
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);
Envoyer WhatsApp
Commande cURL de base
Vous pouvez utiliser la commande cURL suivante pour envoyer un message WhatsApp via SMSmobileAPI :
curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \
-d "recipients=PHONE_NUMBER" \
-d "message=YOUR_MESSAGE" \
-d "apikey=YOUR_API_KEY"
Exemple de cURL en PHP
Si vous utilisez PHP, voici comment vous pouvez envoyer un message WhatsApp en utilisant 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;
?>
Cet exemple PHP montre comment envoyer une requête POST en utilisant cURL à SMSmobileAPI, en passant les paramètres nécessaires sous forme de tableau associatif.
Envoyer WhatsApp
Utilisez notre module Python officiel : https://smsmobileapi.com/python/ ou utiliser la méthode manuelle ...
Utilisation de la bibliothèque « requests »
La bibliothèque `requests` est une bibliothèque HTTP populaire et simple pour Python. Voici comment vous pouvez l'utiliser pour envoyer un message WhatsApp via 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)
Cet exemple illustre une simple requête POST envoyée à SMSmobileAPI, envoyant un message WhatsApp à un numéro de téléphone spécifique.
Utilisation de la bibliothèque « http.client »
La bibliothèque `http.client` est incluse dans la bibliothèque standard de Python et peut également être utilisée pour interagir avec votre API :
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()
Cet exemple montre comment utiliser la bibliothèque `http.client` pour envoyer une requête POST à l'API. Les paramètres sont codés en URL et envoyés avec les en-têtes appropriés.
Envoyer WhatsApp
Utilisation de l'API « fetch »
L'API « fetch » est un moyen moderne et polyvalent de réaliser des requêtes HTTP en JavaScript. Voici comment vous pouvez l'utiliser pour envoyer un message WhatsApp via 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));
Cet exemple montre comment envoyer une requête POST à l'aide de l'API « fetch », qui est prise en charge dans la plupart des navigateurs modernes.
Utilisation de `XMLHttpRequest`
Si vous devez prendre en charge des navigateurs plus anciens, vous pouvez utiliser l'objet « XMLHttpRequest » :
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);
Cet exemple montre comment utiliser `XMLHttpRequest` pour envoyer une requête POST, offrant une compatibilité avec les anciens navigateurs qui peuvent ne pas prendre en charge `fetch`.
Envoyer WhatsApp
Utilisation de la bibliothèque `axios`
La bibliothèque « axios » est un client HTTP populaire pour Node.js. Voici comment vous pouvez l'utiliser pour envoyer un message WhatsApp via 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);
});
Cet exemple montre comment envoyer une requête POST à l'aide de « axios » dans Node.js pour interagir avec SMSmobileAPI.
Envoyer WhatsApp
Utilisation de la bibliothèque « Net::HTTP »
Vous pouvez utiliser la bibliothèque `Net::HTTP` dans Ruby pour envoyer un message WhatsApp via 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
Cet exemple montre comment envoyer une requête POST en utilisant `Net::HTTP` dans Ruby à SMSmobileAPI.