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.
Of u nu REST, SOAP, cURL of verschillende programmeertalen zoals Python, JavaScript, PHP en meer gebruikt, onze API is ontworpen om naadloos te integreren in uw projecten.

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: Het telefoonnummer van de ontvanger (Het nummer moet beschikbaar zijn op WhatsApp). Voer het telefoonnummer in, beginnend met de landcode (zonder '+' en zonder '00'), direct gevolgd door de rest van uw nummer. Voorbeeld 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: Gebruik underscores → _text_
Vetgedrukt: Gebruik sterretjes → *tekst*
Doorhalen: Gebruik tildes → ~text~
Monoruimte: Gebruik backticks → ```tekst```

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