Dev DOC WhatsApp - SMSMobileAPI

WhatsApp dokumentation

Denne dokumentation er specifik for afsendelse og modtagelse af WhatsApp-beskeder.

Klik her for at lære mere om alle de funktioner, vores WhatsApp-integration tilbyder.

Hos SMSmobileAPI stræber vi efter at gøre vores API så kompatibel som muligt med enhver arkitektur eller platform.
Uanset om du bruger REST, SOAP, cURL eller forskellige programmeringssprog som Python, JavaScript, PHP og mere, er vores API designet til at integreres problemfrit i dine projekter.

Vi har også klar-til-brug plugins til e-handelsløsninger og software. Klik her for at opdage dem.

API REST

cURL

JavaScript

Python

Node.js

Rubin

WSDL

Send WhatsApp API

Dette API-slutpunkt bruges til at sende WhatsApp-beskeder.

Slutpunkt:

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

Parametre:

- apikey: Din unikke API-nøgle.

- recipients: Modtagerens telefonnummer (Nummeret skal være tilgængeligt på WhatsApp). Indtast telefonnummeret, der starter med landekoden (uden '+' og uden '00'), efterfulgt direkte af resten af dit nummer. Eksempel 191728660

- message: Beskeden der skal sendes (flere linjer muligt).

- url_media: Den direkte URL på den mediefil, du vil sende via WhatsApp. Skal starte med https:// og pege på en gyldig PDF, dok eller billede fil. Filen skal være offentlig tilgængelig uden godkendelse.
Understøttet: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz
jpg, jpeg, png

- waonly: skal have værdien ja -> Påkrævet for at angive, at der kun skal sendes én WhatsApp-besked

- pdf_with_image->Hvis værdien er "ja", så vil en forhåndsvisning af PDF'en blive vist sammen med beskeden (kun hvis det er en PDF).

Eksempel uden medier:


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

Eksempel med medier:


        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 tekst i WhatsApp:

Kursiv: Brug understregninger → _tekst_
Dristig: Brug stjerner → *tekst*
Gennemstregning: Brug tildes → ~tekst~
Monospace: Brug backticks → ```tekst```

For eksempel: _Hej_ verden, hvordan *er* du ~i dag~ fra ```SMSMobileAPI```

Send en usendt WhatsApp-besked igen

Dette API-slutpunkt bruges til at gensende en ikke-sendt meddelelse (kun hvis meddelelsen har en fejlstatus)

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/resendwa/

Parameter:

- guid: (påkrævet) GUID for den besked, der skal sendes igen.

Eksempel:


        FÅ https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

Synkronisering for at hente besked

Dette API-slutpunkt bruges til at sende en anmodning om at synkronisere og hente WhatsApp-beskeder.
Dette trin er obligatorisk og skal udføres, før du kalder det slutpunkt, der henter meddelelserne.

Advarsel: Synkronisering er strengt taget kun påkrævet for meddelelseshentningsfunktionen. Start ikke en synkronisering for at sende en besked.

Slutpunkt:

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

Parameter:

- apikey (required): API-nøglen du har eller vil modtage.

Eksempel:


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

Svar:



{


 "error": "0",

   "messages": "synkroniseret",

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

  "expire_at_unix": "1741692420",


 

}

Hent WhatsApp-besked

Dette API-slutpunkt bruges til at hente WhatsApp-beskeder modtaget.

Slutpunkt:

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

Parameter:

- apikey (required): API-nøglen du har eller vil modtage.

- before (optional): Send tidsstemplet som en parameter, og vis posterne under dette tidsstempel.

- date (optional): (åååå-mm-dd) få alle poster baseret på datoen.

- message_type (optional):

Lad stå tomt for at se alle (tekst- og audi-beskeder)
brug 'tekst' for kun at se tekstbeskeder
brug 'lyd' for kun at se lydbeskeder konverteret til tekst

Eksempel:


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

Svar:



{


  "dato": "2025-03-11",

  "hour": "12:27:00",

  "timestamp": "1741692420",

  "nummer": "19176728660",

  "contact": "Smsmobileapi",

  "message": "Kan du fortælle mig, hvornår jeg modtager min ordre?",

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

  
  "mere": {

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

	 "response": "Din ordre #576 vil blive afsendt i morgen."

	
  }

    
  
}

Autentificering

SMSMobile API understøtter to godkendelsesmetoder: Brug af en simpel API-nøgle eller OAuth2-protokollen med et klient-id og klienthemmelighed.

1. API-nøglegodkendelse

For at sende eller hente WhatsApp-beskeder via vores API kræves godkendelse ved hjælp af en API-nøgle. Dette sikrer sikker og autoriseret adgang til beskedtjenesten. Du skal blot inkludere din API-nøgle i anmodningen om at godkende og begynde at sende meddelelser problemfrit.

2. OAuth2-godkendelse

OAuth2 giver en mere sikker og skalerbar godkendelsesmetode.
Du skal bruge et klient-id og klienthemmelighed for at få et adgangstoken, som derefter skal inkluderes i dine API-anmodninger ved hjælp af Bemyndigelse overskrift.

Client_id og client_secret er tilgængelige i dit dashboard.

Få et adgangstoken

For at få et adgangstoken skal du sende en POST-anmodning til tokenslutpunktet med dit klient-id og klienthemmelighed.


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"

Brug af adgangstoken:

Når du har adgangstokenet, skal du inkludere det i Bemyndigelse overskriften på dine API-anmodninger:


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.

Send WhatsApp-besked

WSDL URL

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

Parametre:

- recipients: Mobilnummeret på modtageren.

- message: Beskeden der skal sendes.

- apikey: API-nøglen du har eller vil modtage.

- waonly: skal have værdien ja -> Påkrævet for at angive, at der kun skal sendes én WhatsApp-besked.

Eksempel


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

Send WhatsApp

Grundlæggende cURL-kommando

Du kan bruge følgende cURL-kommando til at sende en WhatsApp-besked 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"

cURL-eksempel i PHP

Hvis du bruger PHP, kan du her se, hvordan du kan sende en WhatsApp-besked ved hjælp af 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;

        

        ?>

Dette PHP-eksempel demonstrerer, hvordan man sender en POST-anmodning ved hjælp af cURL til SMSmobileAPI'et, og sender de nødvendige parametre som et associativt array.

Send WhatsApp

Brug vores officielle Python-modul: https://smsmobileapi.com/python/
eller brug den manuelle måde...

Brug af "anmodningsbiblioteket".

Biblioteket `anmodninger` er et populært og enkelt HTTP-bibliotek til Python. Sådan kan du bruge det til at sende en WhatsApp-besked 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)

Dette eksempel viser en simpel POST-anmodning til SMSmobileAPI, der sender en WhatsApp-besked til et specifikt telefonnummer.

Brug af `http.client`-biblioteket

`http.client`-biblioteket er inkluderet i standardbiblioteket for Python og kan også bruges til at interagere med din 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()

Dette eksempel viser, hvordan du bruger `http.client`-biblioteket til at sende en POST-anmodning til API'et. Parametrene er URL-kodede og sendes med de relevante overskrifter.

Send WhatsApp

Brug af 'fetch' API

'Fetch' API er en moderne og alsidig måde at lave HTTP-anmodninger i JavaScript. Sådan kan du bruge det til at sende en WhatsApp-besked 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));

Dette eksempel viser, hvordan man sender en POST-anmodning ved hjælp af 'fetch' API, som understøttes i de fleste moderne browsere.

Brug af `XMLHttpRequest`

Hvis du har brug for at understøtte ældre browsere, kan du bruge objektet `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);

Dette eksempel viser, hvordan du bruger `XMLHttpRequest` til at sende en POST-anmodning, hvilket giver kompatibilitet med ældre browsere, der muligvis ikke understøtter `fetch`.

Send WhatsApp

Brug af `axios`-biblioteket

`axios`-biblioteket er en populær HTTP-klient til Node.js. Sådan kan du bruge det til at sende en WhatsApp-besked 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);

        });

Dette eksempel viser, hvordan man sender en POST-anmodning ved hjælp af `axios` i Node.js for at interagere med SMSmobileAPI.

Send WhatsApp

Brug af `Net::HTTP`-biblioteket

Du kan bruge `Net::HTTP`-biblioteket i Ruby til at sende en WhatsApp-besked 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

Dette eksempel viser, hvordan man sender en POST-anmodning ved hjælp af `Net::HTTP` i Ruby til SMSmobileAPI.

Det er også muligt at sende en WhatsApp-besked og en SMS samtidigt.

Hvis du har spørgsmål, forslag eller har brug for hjælp, er vores team her for at hjælpe.
Du er velkommen til at kontakte os på api@smsmobileapi.com

SMS funktioner

WhatsApp funktioner

Generelle plugins

Online butiks plugins

API og udviklerdokumenter

Værktøjer og ændringer log

WhatsApp dokumentation

Send WhatsApp

Send besked igen

Synkronisering

Hent beskeder

Autentificering

Send WhatsApp API

Slutpunkt:

Parametre:

Eksempel uden medier:

Eksempel med medier:

Formater tekst i WhatsApp:

Send en usendt WhatsApp-besked igen

Slutpunkt:

Parameter:

Eksempel:

Synkronisering for at hente besked

Slutpunkt:

Parameter:

Eksempel:

Svar:

Hent WhatsApp-besked

Slutpunkt:

Parameter:

Eksempel:

Svar:

Autentificering

1. API-nøglegodkendelse

2. OAuth2-godkendelse

Få et adgangstoken

Brug af adgangstoken:

Which Method Should You Use?

Send WhatsApp-besked

WSDL URL

Parametre:

Eksempel

Send WhatsApp

Grundlæggende cURL-kommando

cURL-eksempel i PHP

Send WhatsApp

Brug af "anmodningsbiblioteket".

Brug af `http.client`-biblioteket

Send WhatsApp

Brug af 'fetch' API

Brug af `XMLHttpRequest`

Send WhatsApp

Brug af `axios`-biblioteket

Send WhatsApp

Brug af `Net::HTTP`-biblioteket