Dev DOC WhatsApp - SMSMobieleAPI

WhatsApp-documentatie

Deze documentatie is specifiek voor het verzenden en ontvangen van WhatsApp-berichten.

Klik hier om meer te weten te komen over alle functies die onze WhatsApp-integratie biedt.

Bij SMSmobileAPI streven we ernaar om onze API zo compatibel mogelijk te maken met elke architectuur of elk platform.
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.

Wij hebben ook kant-en-klare plugins voor e-commerce oplossingen en software. Klik hier om ze te ontdekken.

API-REST

cURL

Javascript-functie

Python

Node.js

Robijn

WSDL

WhatsApp API verzenden

Dit API-eindpunt wordt gebruikt om WhatsApp-berichten te verzenden.

Eindpunt:

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

Parameters:

- apikey: Uw unieke API-sleutel.

- 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: Het te verzenden bericht (meerdere regels mogelijk).

- url_media: De directe URL van het mediabestand dat u via WhatsApp wilt verzenden. Moet beginnen met https:// en wijs naar een geldige PDF, dokter of afbeelding bestand. Het bestand moet openbaar toegankelijk zijn zonder authenticatie.
Ondersteund: 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: moet de waarde hebben Ja -> Vereist om aan te geven dat er slechts één WhatsApp-bericht mag worden verzonden

Voorbeeld zonder media:


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

Voorbeeld met media:


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

Tekst opmaken in WhatsApp:

Cursief: Use underscores → _text_
Vetgedrukt: Use asterisks → *text*
Doorhalen: Use tildes → ~text~
Monoruimte: Use backticks → ```text```

Bijvoorbeeld: _Hallo_ wereld, Hoe *gaat* het ~vandaag~ met u van ```SMSMobileAPI```

Een niet-verzonden WhatsApp-bericht opnieuw verzenden

Dit API-eindpunt wordt gebruikt om een niet-verzonden bericht opnieuw te verzenden (alleen als het bericht een foutstatus heeft)

Eindpunt:

KRIJGEN NA https://api.smsmobileapi.com/resendwa/

Parameter:

- guid: (verplicht) GUID van het bericht dat opnieuw moet worden verzonden.

Voorbeeld:


        KRIJG https://api.smsmobileapi.com/resendwa/?apikey=UW_API_SLEUTEL&guid=GUID_VAN_HET_BERICHT

Synchronisatie om bericht op te halen

Dit API-eindpunt wordt gebruikt om een verzoek te verzenden om WhatsApp-berichten te synchroniseren en op te halen.
Deze stap is verplicht en moet worden uitgevoerd voordat het eindpunt wordt aangeroepen dat de berichten ophaalt.

Waarschuwing: Synchronisatie is strikt alleen vereist voor de functie voor het ophalen van berichten. Start geen synchronisatie om een bericht te verzenden.

Eindpunt:

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

Parameter:

- apikey (required): De API-sleutel die u heeft of zult ontvangen.

Voorbeeld:


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

Antwoord :



{


 "fout": "0",

   "berichten": "gesynchroniseerd",

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

  "verloopt_op_unix": "1741692420",


 

}

WhatsApp-bericht ophalen

Dit API-eindpunt wordt gebruikt om ontvangen WhatsApp-berichten op te halen.

Eindpunt:

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

Parameter:

- apikey (required): De API-sleutel die u heeft of zult ontvangen.

- before (optional): Geef het tijdstempel door als parameter en geef de records onder dit tijdstempel weer.

- date (optional): (jjjj-mm-dd) haalt alle records op op basis van de datum.

Voorbeeld:


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

Antwoord :



{


  "datum": "2025-03-11",

  "uur": "12:27:00",

  "tijdstempel": "1741692420",

  "nummer": "19176728660",

  "contact": "Smsmobiel",

  "message": "Kunt u mij vertellen wanneer ik mijn bestelling ontvang?",

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

  
  "meer": {

    "automatisch_antwoord": "1",

    "transfert_to_email": "1",

    "chatgpt_antwoord": "1"

	
  },


  "chatgpt": {

    "prompt_tokens": "900",

    "voltooiingstokens": "10",

    "totaal_tokens": "910",

    "totale_tokenskosten": "0,182"

	 "response": "Uw bestelling #576 wordt morgen verzonden."

	
  }

    
  
}

Authenticatie

De SMSMobile API ondersteunt twee authenticatiemethoden: met een eenvoudige API-sleutel of met het OAuth2-protocol met een client-ID en clientgeheim.

1. API-sleutelverificatie

Om WhatsApp-berichten via onze API te versturen of op te halen, is authenticatie vereist met behulp van een API-sleutel. Dit zorgt voor veilige en geautoriseerde toegang tot de berichtenservice. Voeg eenvoudig uw API-sleutel toe aan het verzoek om te authenticeren en begin naadloos met het versturen van berichten.

2. OAuth2-authenticatie

OAuth2 biedt een veiligere en schaalbare authenticatiemethode.
U moet een client-ID en clientgeheim gebruiken om een toegangstoken te verkrijgen, die vervolgens moet worden opgenomen in uw API-aanvragen met behulp van de Autorisatie koptekst.

De client_id en client_secret zijn beschikbaar in uw dashboard.

Een toegangstoken verkrijgen

Om een toegangstoken te verkrijgen, stuurt u een POST-aanvraag naar het tokeneindpunt met uw client-ID en clientgeheim.


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"

Het toegangstoken gebruiken:

Zodra u het toegangstoken hebt, voegt u het toe aan de Autorisatie header van uw API-verzoeken:


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-bericht verzenden

WSDL-URL

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

Parameters:

- recipients: Het mobiele nummer van de ontvanger.

- message: Het bericht om te verzenden.

- apikey: De API-sleutel die u heeft of zult ontvangen.

- waonly: moet de waarde hebben Ja -> Vereist om aan te geven dat er slechts één WhatsApp-bericht mag worden verzonden.

Voorbeeld


                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 verzenden

Basis cURL-opdracht

U kunt de volgende cURL-opdracht gebruiken om een WhatsApp-bericht te verzenden via de 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-voorbeeld in PHP

Als je PHP gebruikt, kun je als volgt een WhatsApp-bericht versturen met 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;

        

        ?>

Dit PHP-voorbeeld laat zien hoe u een POST-verzoek met behulp van cURL naar de SMSmobileAPI kunt verzenden, waarbij de benodigde parameters als een associatieve array worden doorgegeven.

WhatsApp verzenden

Gebruik onze officiële Python-module: https://smsmobileapi.com/python/
of gebruik de handmatige manier ...

De bibliotheek `aanvragen` gebruiken

De `requests`-bibliotheek is een populaire en eenvoudige HTTP-bibliotheek voor Python. Zo kunt u deze gebruiken om een WhatsApp-bericht te versturen via de 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)

Dit voorbeeld toont een eenvoudig POST-verzoek aan de SMSmobileAPI, waarmee een WhatsApp-bericht naar een specifiek telefoonnummer wordt verzonden.

De `http.client`-bibliotheek gebruiken

De `http.client`-bibliotheek is opgenomen in de standaardbibliotheek van Python en kan ook worden gebruikt om te communiceren met uw 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()

Dit voorbeeld laat zien hoe u de bibliotheek `http.client` gebruikt om een POST-verzoek naar de API te sturen. De parameters zijn URL-gecodeerd en worden verzonden met de juiste headers.

WhatsApp verzenden

De `fetch` API gebruiken

De `fetch` API is een moderne en veelzijdige manier om HTTP-verzoeken in JavaScript te maken. Zo kun je het gebruiken om een WhatsApp-bericht te versturen via de 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));

Dit voorbeeld laat zien hoe u een POST-verzoek verzendt met behulp van de `fetch`-API, die door de meeste moderne browsers wordt ondersteund.

`XMLHttpRequest` gebruiken

Als u oudere browsers moet ondersteunen, kunt u het object `XMLHttpRequest` gebruiken:


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

Dit voorbeeld laat zien hoe u `XMLHttpRequest` kunt gebruiken om een POST-verzoek te verzenden. Dit zorgt voor compatibiliteit met oudere browsers die `fetch` mogelijk niet ondersteunen.

WhatsApp verzenden

De `axios`-bibliotheek gebruiken

De `axios`-bibliotheek is een populaire HTTP-client voor Node.js. Zo kunt u het gebruiken om een WhatsApp-bericht te versturen via de 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);

        });

Dit voorbeeld laat zien hoe u een POST-verzoek kunt verzenden met behulp van `axios` in Node.js om te communiceren met de SMSmobileAPI.

WhatsApp verzenden

De `Net::HTTP`-bibliotheek gebruiken

U kunt de bibliotheek `Net::HTTP` in Ruby gebruiken om een WhatsApp-bericht te versturen via de 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

Dit voorbeeld laat zien hoe u een POST-verzoek met behulp van `Net::HTTP` in Ruby naar de SMSmobileAPI kunt verzenden.

Het is ook mogelijk om stuur tegelijkertijd een WhatsApp-bericht en een sms.

Als u vragen, suggesties of hulp nodig hebt, staat ons team voor u klaar.
Neem gerust contact met ons op via api@smsmobileapi.com

WhatsApp-documentatie

WhatsApp verzenden

Bericht opnieuw verzenden

Synchronisatie

Berichten ophalen

Authenticatie

WhatsApp API verzenden

Eindpunt:

Parameters:

Voorbeeld zonder media:

Voorbeeld met media:

Tekst opmaken in WhatsApp:

Een niet-verzonden WhatsApp-bericht opnieuw verzenden

Eindpunt:

Parameter:

Voorbeeld:

Synchronisatie om bericht op te halen

Eindpunt:

Parameter:

Voorbeeld:

Antwoord :

WhatsApp-bericht ophalen

Eindpunt:

Parameter:

Voorbeeld:

Antwoord :

Authenticatie

1. API-sleutelverificatie

2. OAuth2-authenticatie

Een toegangstoken verkrijgen

Het toegangstoken gebruiken:

Which Method Should You Use?

WhatsApp-bericht verzenden

WSDL-URL

Parameters:

Voorbeeld

WhatsApp verzenden

Basis cURL-opdracht

cURL-voorbeeld in PHP

WhatsApp verzenden

De bibliotheek `aanvragen` gebruiken

De `http.client`-bibliotheek gebruiken

WhatsApp verzenden

De `fetch` API gebruiken

`XMLHttpRequest` gebruiken

WhatsApp verzenden

De `axios`-bibliotheek gebruiken

WhatsApp verzenden

De `Net::HTTP`-bibliotheek gebruiken