Dev DOC WhatsApp - SMSMobileAPI

WhatsApp-dokumentation

Denna dokumentation är specifik för att skicka och ta emot WhatsApp-meddelanden.

Klicka här för att lära dig mer om alla funktioner som vår WhatsApp-integration erbjuder.

På SMSmobileAPI strävar vi efter att göra vårt API så kompatibelt som möjligt med vilken arkitektur eller plattform som helst.
Oavsett om du använder REST, SOAP, cURL eller olika programmeringsspråk som Python, JavaScript, PHP och mer, är vårt API utformat för att integreras sömlöst i dina projekt.

Vi har även färdiga plugins för e-handelslösningar och mjukvara. Klicka här för att upptäcka dem.

API REST

cURL

JavaScript

Pytonorm

Node.js

Rubin

WSDL

Skicka WhatsApp API

Denna API-slutpunkt används för att skicka WhatsApp-meddelanden.

Slutpunkt:

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

Parametrar:

- apikey: Din unika API-nyckel.

- recipients: Mottagarens telefonnummer (Numret måste vara tillgängligt på WhatsApp). Ange telefonnumret som börjar med landskoden (utan '+' och utan '00'), följt direkt av resten av ditt nummer. Exempel 191728660

- message: Meddelandet som ska skickas (flera rader möjliga).

- url_media: Den direkta URL:en till mediafilen du vill skicka via WhatsApp. Måste börja med https:// och peka på en giltig PDF, doc eller bild fil. Filen måste vara allmänt tillgänglig utan autentisering.
Stöds: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz
jpg, jpeg, png

- waonly: måste ha värdet ja -> Krävs för att ange att endast ett WhatsApp-meddelande ska skickas

- pdf_with_image- >Om värdet är "ja", kommer en bildförhandsvisning av PDF:en att visas tillsammans med meddelandet (endast om det är en PDF).

- url_media_shorted- >Om värdet är "ja", i fallet med en PDF med villkoret [pdf_with_image=yes], går visningen av nedladdningslänken för PDF:en genom en kort URL

Exempel utan media:


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

Exempel med 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

Formatera text i WhatsApp:

Kursiv: Använd understreck → _text_
Djärv: Använd asterisker → *text*
Genomstruken: Använd tildes → ~text~
Monospace: Använd backticks → ```text```

Till exempel: _Hej_ världen, hur *är* du ~idag~ från ```SMSMobileAPI```

Skicka om ett osänt WhatsApp-meddelande

Denna API-slutpunkt används för att skicka om ett osänt meddelande (endast om meddelandet har en felstatus)

Slutpunkt:

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

Parameter:

- guid: (obligatoriskt) GUID för meddelandet som ska skickas igen.

Exempel:


        Hämta https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

Synkronisering för att hämta meddelande

Denna API-slutpunkt används för att skicka en begäran om att synkronisera och hämta WhatsApp-meddelanden.
Detta steg är obligatoriskt och måste utföras innan du anropar slutpunkten som hämtar meddelandena.

Varning: Synkronisering krävs strikt endast för funktionen för meddelandehämtning. Starta inte en synkronisering för att skicka ett meddelande.

Slutpunkt:

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

Parameter:

- apikey (required): API-nyckeln du har eller kommer att få.

Exempel:


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

Svara:



{


 "error": "0",

   "meddelanden": "synkroniserad",

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

  "expire_at_unix": "1741692420",


 

}

Hämta WhatsApp-meddelande

Denna API-slutpunkt används för att hämta WhatsApp-meddelanden som tagits emot.

Slutpunkt:

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

Parameter:

- apikey (required): API-nyckeln du har eller kommer att få.

- before (optional): Skicka tidsstämpeln som en parameter och visa posterna under denna tidsstämpel.

- date (optional): (åååå-mm-dd) få alla poster baserat på datumet.

- message_type (optional):

Lämna tomt för att se alla (text- och ljudmeddelanden)
använd "text" för att bara se textmeddelanden
använd "ljud" för att bara se ljudmeddelanden konverterade till text

Exempel:


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

Svara:



{


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

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

  "timestamp": "1741692420",

  "nummer": "19176728660",

  "contact": "Smsmobileapi",

  "message": "Kan du berätta för mig när jag får min beställning?",

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

  
  "mer": {

    "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 beställning #576 kommer att skickas imorgon."

	
  }

    
  
}

Autentisering

SMSMobile API stöder två autentiseringsmetoder: att använda en enkel API-nyckel eller OAuth2-protokollet med ett klient-ID och klienthemlighet.

1. API-nyckelautentisering

För att skicka eller hämta WhatsApp-meddelanden via vårt API krävs autentisering med en API-nyckel. Detta säkerställer säker och auktoriserad åtkomst till meddelandetjänsten. Inkludera helt enkelt din API-nyckel i begäran för att autentisera och börja skicka meddelanden sömlöst.

2. OAuth2-autentisering

OAuth2 ger en säkrare och skalbarare autentiseringsmetod.
Du måste använda ett klient-ID och klienthemlighet för att få en åtkomsttoken, som sedan ska inkluderas i dina API-förfrågningar med hjälp av Tillstånd rubrik.

Client_id och client_secret är tillgängliga i din instrumentpanel.

Skaffa en åtkomsttoken

För att få en åtkomsttoken, skicka en POST-begäran till tokenslutpunkten med ditt klient-ID och klienthemlighet.


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"

Använda åtkomsttoken:

När du har tillgångstoken, inkludera den i Tillstånd rubriken för dina API-förfrågningar:


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.

Skicka WhatsApp-meddelande

WSDL URL

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

Parametrar:

- recipients: Mottagarens mobilnummer.

- message: Meddelandet att skicka.

- apikey: API-nyckeln du har eller kommer att få.

- waonly: måste ha värdet ja -> Krävs för att ange att endast ett WhatsApp-meddelande ska skickas.

Exempel


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

Skicka WhatsApp

Grundläggande cURL-kommando

Du kan använda följande cURL-kommando för att skicka ett WhatsApp-meddelande 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-exempel i PHP

Om du använder PHP, så här kan du skicka ett WhatsApp-meddelande med 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;

        

        ?>

Det här PHP-exemplet visar hur man skickar en POST-begäran med hjälp av cURL till SMSmobileAPI, och skickar de nödvändiga parametrarna som en associativ array.

Skicka WhatsApp

Använd vår officiella Python-modul: https://smsmobileapi.com/python/
eller använd det manuella sättet...

Använda `requests`-biblioteket

Biblioteket `requests` är ett populärt och enkelt HTTP-bibliotek för Python. Så här kan du använda den för att skicka ett WhatsApp-meddelande 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)

Det här exemplet visar en enkel POST-förfrågan till SMSmobileAPI, som skickar ett WhatsApp-meddelande till ett specifikt telefonnummer.

Använda `http.client`-biblioteket

`http.client`-biblioteket ingår i Pythons standardbibliotek och kan också användas för att interagera med ditt 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()

Det här exemplet visar hur du använder `http.client`-biblioteket för att skicka en POST-begäran till API:et. Parametrarna är URL-kodade och skickas med lämpliga rubriker.

Skicka WhatsApp

Använder "fetch" API

`fetch` API är ett modernt och mångsidigt sätt att göra HTTP-förfrågningar i JavaScript. Så här kan du använda den för att skicka ett WhatsApp-meddelande 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));

Det här exemplet visar hur man skickar en POST-förfrågan med hjälp av "fetch" API, som stöds i de flesta moderna webbläsare.

Använder `XMLHttpRequest`

Om du behöver stödja äldre webbläsare kan du använda 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);

Det här exemplet visar hur du använder `XMLHttpRequest` för att skicka en POST-begäran, vilket ger kompatibilitet med äldre webbläsare som kanske inte stöder `fetch`.

Skicka WhatsApp

Använda `axios`-biblioteket

`axios`-biblioteket är en populär HTTP-klient för Node.js. Så här kan du använda den för att skicka ett WhatsApp-meddelande 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);

        });

Det här exemplet visar hur man skickar en POST-förfrågan med hjälp av `axios` i Node.js för att interagera med SMSmobileAPI.

Skicka WhatsApp

Använda `Net::HTTP`-biblioteket

Du kan använda `Net::HTTP`-biblioteket i Ruby för att skicka ett WhatsApp-meddelande 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

Det här exemplet visar hur man skickar en POST-förfrågan med `Net::HTTP` i Ruby till SMSmobileAPI.

Det är också möjligt att skicka ett WhatsApp-meddelande och ett SMS samtidigt.

Om du har några frågor, förslag eller behöver hjälp finns vårt team här för att hjälpa dig.
Kontakta oss gärna på api@smsmobileapi.com

SMS-funktioner

WhatsApp-funktioner

Allmänna plugins

Onlinebutikens plugins

API- och utvecklardokument

Verktyg & Ändringslogg

WhatsApp-dokumentation

Skicka WhatsApp

Skicka meddelande igen

Synkronisering

Hämta meddelanden

Autentisering

Skicka WhatsApp API

Slutpunkt:

Parametrar:

Exempel utan media:

Exempel med media:

Formatera text i WhatsApp:

Skicka om ett osänt WhatsApp-meddelande

Slutpunkt:

Parameter:

Exempel:

Synkronisering för att hämta meddelande

Slutpunkt:

Parameter:

Exempel:

Svara:

Hämta WhatsApp-meddelande

Slutpunkt:

Parameter:

Exempel:

Svara:

Autentisering

1. API-nyckelautentisering

2. OAuth2-autentisering

Skaffa en åtkomsttoken

Använda åtkomsttoken:

Which Method Should You Use?

Skicka WhatsApp-meddelande

WSDL URL

Parametrar:

Exempel

Skicka WhatsApp

Grundläggande cURL-kommando

cURL-exempel i PHP

Skicka WhatsApp

Använda `requests`-biblioteket

Använda `http.client`-biblioteket

Skicka WhatsApp

Använder "fetch" API

Använder `XMLHttpRequest`

Skicka WhatsApp

Använda `axios`-biblioteket

Skicka WhatsApp

Använda `Net::HTTP`-biblioteket