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.
Whether you’re using REST, SOAP, cURL, or various programming languages like Python, JavaScript, PHP, and more, our API is designed to integrate seamlessly into your projects.

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:

- apikey:Votre clé API unique.

- 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:Le message à envoyer (Plusieurs lignes possibles).

- 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 fichier. Le fichier doit être accessible au public sans authentification.
Prise en charge : 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:doit avoir la valeur Oui -> Obligatoire pour spécifier qu'un seul message WhatsApp doit être envoyé

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: Use underscores → _text_
Audacieux: Use asterisks → *text*
Barré : Use tildes → ~text~
Monospace : Use backticks → ```text```

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:

- guid: (obligatoire) 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:

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

- apikey (required): La clé API que vous possédez ou que vous recevrez.

- before (optional): Transmettez l'horodatage en tant que paramètre et affichez les enregistrements sous cet horodatage.

- date (optional): (aaaa-mm-jj) obtenir tous les enregistrements en fonction de la date.

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

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 »