Document de développement WhatsApp

Documentation WhatsApp

Cette documentation est spécifique à l'envoi et à la réception de messages WhatsApp.

Cliquez ici pour en savoir plus à propos de toutes les fonctionnalités offertes par notre intégration WhatsApp.

Chez SMSmobileAPI, nous nous efforçons de rendre notre API aussi compatible que possible avec n'importe quelle architecture ou plate-forme.
Que vous utilisiez REST, SOAP, cURL ou divers langages de programmation comme Python, JavaScript, PHP, etc., notre API est conçue pour s'intégrer de manière transparente à vos projets.

Nous disposons également de plugins prêts à l'emploi pour les solutions et logiciels de commerce électronique. Cliquez ici pour les découvrir.

API REST

cURL

JavaScript

Python

Node.js

Rubis

WSDL

Authentification

CLÉ API
OAuth2

Envoyer l'API WhatsApp

Ce point de terminaison API est utilisé pour envoyer des messages WhatsApp.

Point final :

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

Paramètres:

Paramètre	Description
apikey	Requis Votre clé API unique.
recipients	Requis Le numéro de téléphone du destinataire (le numéro doit être disponible sur WhatsApp). Saisissez le numéro de téléphone commençant par l'indicatif du pays (sans « + » et sans « 00 »), suivi directement du reste de votre numéro. Exemple: 191728660
message	Requis Le message à envoyer (Plusieurs lignes possibles).
waonly	Requis Doit avoir la valeur Oui → Obligatoire pour spécifier qu'un seul message WhatsApp doit être envoyé.
url_media	L'URL directe du fichier multimédia que vous souhaitez envoyer via WhatsApp. Doit commencer par https:// et pointer vers un valide PDF, doc ou image déposer. Le fichier doit être accessible au public sans authentification. Formats pris en charge : Documents: PDF, XML, Doc, DocX, Odt, Rtf, Txt, Texas Instruments, XLS, XLSX, CSV, Ods, Ppt, PptX, Odp, Zip, Rar, 7Z, Tar, Gz Images: jpg, jpeg, png
url_media_shorted	Si la valeur est Oui, et [pdf_with_image=yes] est défini, l'affichage du lien de téléchargement du PDF passe par une URL courte.
pdf_with_image	Si la valeur est Oui, un aperçu de l'image du PDF sera affiché pour accompagner le message (uniquement si le fichier est un PDF).
encrypt_message	Oui = Le message sera crypté lors de sa lecture par le destinataire. Le destinataire devra saisir une clé unique pour décrypter le message. En savoir plus sur le cryptage des messages

Exemple sans média :


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

Exemple avec média :


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

Formater le texte dans WhatsApp :

Italique: Utiliser des traits de soulignement → _texte_
Audacieux: Utiliser des astérisques → *texte*
Barré : Utiliser les tildes → ~texte~
Monospace : Utiliser les guillemets inversés → ```texte```

Par exemple : _Bonjour_ le monde, comment allez-vous ~aujourd'hui~ depuis ```SMSMobileAPI```

Renvoyer un message WhatsApp non envoyé

Ce point de terminaison d'API est utilisé pour renvoyer un message non envoyé (uniquement si le message a un statut d'erreur)

Point final :

OBTENIR POSTE https://api.smsmobileapi.com/resendwa/

Paramètre:

Paramètre	Description
guid	Requis GUID du message à renvoyer.

Exemple:


        OBTENEZ https://api.smsmobileapi.com/resendwa/?apikey=VOTRE_CLÉ_API&guid=GUID_DU_MESSAGE

Synchronisation pour récupérer le message

Ce point de terminaison API est utilisé pour envoyer une demande de synchronisation et de récupération des messages WhatsApp.
Cette étape est obligatoire et doit être exécutée avant d'appeler le point de terminaison qui récupère les messages.

Avertissement: La synchronisation est strictement requise uniquement pour la récupération des messages. Ne lancez pas de synchronisation pour envoyer un message.

Point final :

GET https://api.smsmobileapi.com/getwa/synchronisation/

Paramètre:

Paramètre	Description
apikey (required)	Requis La clé API que vous possédez ou que vous recevrez.

Exemple:


        GET https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY

Répondre :



{


 "erreur": "0",

   "messages": "synchronisé",

  "expire_at ": "2025-03-11 12:27:00",

  "expire_at_unix": "1741692420",


 

}

Récupérer le message WhatsApp

Ce point de terminaison API est utilisé pour récupérer les messages WhatsApp reçus.

Point final :

GET https://api.smsmobileapi.com/getwa

Paramètre:

Paramètre	Description
apikey	Requis La clé API que vous possédez ou que vous recevrez.
before	Transmettez l'horodatage en tant que paramètre et affichez les enregistrements sous cet horodatage.
date	(aaaa-mm-jj) Obtenez tous les enregistrements en fonction de la date.
message_type	Laissez vide pour tout voir (messages texte et audio) Utiliser `texte` pour voir uniquement les messages texte Utiliser `audio` pour voir uniquement les messages audio convertis en texte

Exemple:


        GET https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY

Répondre :



{


  "date": "2025-03-11",

  "heure": "12:27:00",

  "horodatage": "1741692420",

  "numéro": "19176728660",

  "contact": "Smsmobileapi",

  "message": "Pouvez-vous me dire quand je recevrai ma commande ?",

  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c",

  
  "plus": {

    "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"

	 "réponse" : « Votre commande #576 sera expédiée demain. »

	
  }

    
  
}

Authentification

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 envoyer ou récupérer des messages WhatsApp via notre API, une authentification à l'aide d'une clé API est requise. Cela garantit un accès sécurisé et autorisé au service de messagerie. Il vous suffit d'inclure votre clé API dans la requête pour vous authentifier et commencer à envoyer des messages en toute simplicité.

2. Authentification OAuth2

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.

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

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.

Il est également possible de envoyer un message WhatsApp et un SMS simultanément.

Si vous avez des questions, des suggestions ou besoin d'aide, notre équipe est là pour vous aider.
N'hésitez pas à nous contacter à api@smsmobileapi.com

Fonctionnalités SMS

Fonctionnalités de WhatsApp

Plugins généraux

Plugins de boutique en ligne

API et documentation du développeur

Journal des outils et des modifications

Documentation WhatsApp

Envoyer WhatsApp

Renvoyer le message

Synchronisation

Récupérer des messages

Authentification

Envoyer l'API WhatsApp

Point final :

Paramètres:

Exemple sans média :

Exemple avec média :

Formater le texte dans WhatsApp :

Renvoyer un message WhatsApp non envoyé

Point final :

Paramètre:

Exemple:

Synchronisation pour récupérer le message

Point final :

Paramètre:

Exemple:

Répondre :

Récupérer le message WhatsApp

Point final :

Paramètre:

Exemple:

Répondre :

Authentification

1. Authentification par clé API

2. Authentification OAuth2

Obtention d'un jeton d'accès

Utilisation du jeton d’accès :

Which Method Should You Use?

Envoyer un message WhatsApp

URL WSDL

Paramètres:

Exemple

Envoyer WhatsApp

Commande cURL de base

Exemple de cURL en PHP

Envoyer WhatsApp

Utilisation de la bibliothèque « requests »

Utilisation de la bibliothèque « http.client »

Envoyer WhatsApp

Utilisation de l'API « fetch »

Utilisation de `XMLHttpRequest`

Envoyer WhatsApp

Utilisation de la bibliothèque `axios`

Envoyer WhatsApp

Utilisation de la bibliothèque « Net::HTTP »