Dev DOC WhatsApp - SMSMobileAPI

Τεκμηρίωση WhatsApp

Αυτή η τεκμηρίωση αφορά συγκεκριμένα την αποστολή και λήψη μηνυμάτων WhatsApp.

Κάντε κλικ εδώ για να μάθετε περισσότερα σχετικά με όλες τις δυνατότητες που προσφέρει η ενσωμάτωση WhatsApp.

Στην SMSmobileAPI, προσπαθούμε να κάνουμε το API μας όσο το δυνατόν πιο συμβατό με οποιαδήποτε αρχιτεκτονική ή πλατφόρμα.
Είτε χρησιμοποιείτε REST, SOAP, cURL ή διάφορες γλώσσες προγραμματισμού όπως Python, JavaScript, PHP και άλλες, το API μας έχει σχεδιαστεί για να ενσωματώνεται απρόσκοπτα στα έργα σας.

Έχουμε επίσης έτοιμα προς χρήση πρόσθετα για λύσεις και λογισμικό ηλεκτρονικού εμπορίου. Κάντε κλικ εδώ για να τα ανακαλύψετε.

API REST

cURL

JavaScript

Πύθων

Node.js

Ρουμπίνι

WSDL

Αποστολή WhatsApp API

Αυτό το τελικό σημείο API χρησιμοποιείται για την αποστολή μηνυμάτων WhatsApp.

Τελικό σημείο:

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

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το μοναδικό κλειδί API σας.
recipients	Υποχρεούμαι Ο αριθμός τηλεφώνου του παραλήπτη (Ο αριθμός πρέπει να είναι διαθέσιμος στο WhatsApp). Εισαγάγετε τον αριθμό τηλεφώνου ξεκινώντας με τον κωδικό χώρας (χωρίς '+' και χωρίς '00'), ακολουθούμενο απευθείας από τον υπόλοιπο αριθμό σας. Παράδειγμα: 191728660
message	Υποχρεούμαι Το μήνυμα προς αποστολή (Δυνατότητα πολλαπλών γραμμών).
waonly	Υποχρεούμαι Πρέπει να έχει την αξία Ναί → Απαιτείται να ορίσετε ότι θα πρέπει να αποστέλλεται μόνο ένα μήνυμα WhatsApp.
url_media	Η άμεση διεύθυνση URL του αρχείου πολυμέσων που θέλετε να στείλετε μέσω WhatsApp. Πρέπει να ξεκινήσει με https:// και το σημείο σε ένα έγκυρο PDF, έγγρ ή εικών αρχείο. Το αρχείο πρέπει να είναι δημόσια προσβάσιμο χωρίς έλεγχο ταυτότητας. Υποστηριζόμενες μορφές: Εγγραφα: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz Εικόνες: jpg, jpeg, png
url_media_shorted	Αν η τιμή είναι Ναί, και έχει οριστεί το [pdf_with_image=yes], η εμφάνιση του συνδέσμου λήψης για το PDF περνά από μια σύντομη διεύθυνση URL.
pdf_with_image	Αν η τιμή είναι Ναί, θα εμφανιστεί μια προεπισκόπηση εικόνας του PDF για να συνοδεύει το μήνυμα (μόνο εάν το αρχείο είναι PDF).
encrypt_message	Ναί = Το μήνυμα θα κρυπτογραφηθεί όταν διαβαστεί από τον παραλήπτη. Ο παραλήπτης θα χρειαστεί να εισαγάγει ένα μοναδικό κλειδί για την αποκρυπτογράφηση του μηνύματος. Μάθετε περισσότερα σχετικά με την κρυπτογράφηση μηνυμάτων

Παράδειγμα χωρίς μέσα:


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

Παράδειγμα με μέσα:


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

Μορφοποίηση κειμένου στο WhatsApp:

Πλάγια: Χρησιμοποιήστε υπογράμμιση → _text_
Τολμηρός: Χρησιμοποιήστε αστερίσκους → *κείμενο*
Διαγραφή: Χρησιμοποιήστε tildes → ~text~
Monospace: Χρησιμοποιήστε backticks → ```κείμενο```

Για παράδειγμα : _Hello_ world, Πώς *είσαι* ~σήμερα~ από το ```SMSMobileAPI```

Στείλτε ξανά μη απεσταλμένα μηνύματα WhatsApp

Αυτό το τελικό σημείο API χρησιμοποιείται για την εκ νέου αποστολή ενός μη απεσταλμένου μηνύματος (μόνο εάν το μήνυμα έχει κατάσταση σφάλματος)

Τελικό σημείο:

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/resendwa/

Παράμετρος:

Παράμετρος	Περιγραφή
guid	Υποχρεούμαι GUID του μηνύματος που θα σταλεί εκ νέου.

Παράδειγμα:


        ΛΑΒΕ https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

Συγχρονισμός για ανάκτηση μηνύματος

Αυτό το τελικό σημείο API χρησιμοποιείται για την αποστολή αιτήματος για συγχρονισμό και ανάκτηση μηνυμάτων WhatsApp.
Αυτό το βήμα είναι υποχρεωτικό και πρέπει να εκτελεστεί πριν καλέσετε το τελικό σημείο που ανακτά τα μηνύματα.

Προειδοποίηση: Ο συγχρονισμός απαιτείται αυστηρά μόνο για τη λειτουργία ανάκτησης μηνυμάτων. Μην ξεκινήσετε συγχρονισμό για αποστολή μηνύματος.

Τελικό σημείο:

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

Παράμετρος:

Παράμετρος	Περιγραφή
apikey (required)	Υποχρεούμαι Το κλειδί API που έχετε ή θα λάβετε.

Παράδειγμα:


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

Απάντηση:



{


 "σφάλμα": "0",

   "μηνύματα": "συγχρονισμένο",

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

  "expire_at_unix": "1741692420",


 

}

Ανάκτηση μηνύματος WhatsApp

Αυτό το τελικό σημείο API χρησιμοποιείται για την ανάκτηση των μηνυμάτων WhatsApp που έχετε λάβει.

Τελικό σημείο:

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

Παράμετρος:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API που έχετε ή θα λάβετε.
before	Περάστε τη χρονική σήμανση ως παράμετρο και εμφανίστε τις εγγραφές κάτω από αυτήν τη χρονική σήμανση.
date	(εεεε-μμ-ηη) Λάβετε όλες τις εγγραφές με βάση την ημερομηνία.
message_type	Αφήστε κενό για να δείτε όλα (μηνύματα κειμένου και ήχου) Χρήση `κείμενο` για να δείτε μόνο μηνύματα κειμένου Χρήση `ήχου` για να δείτε μόνο μηνύματα ήχου που μετατρέπονται σε κείμενο

Παράδειγμα:


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

Απάντηση:



{


  "ημερομηνία": "2025-03-11",

  "ώρα": "12:27:00",

  "timestamp": "1741692420",

  "number": "19176728660",

  "contact": "Smsmobileapi",

  "message": "Μπορείτε να μου πείτε πότε θα παραλάβω την παραγγελία μου;",

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

  
  "περισσότερα": {

    "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": "Η παραγγελία σας #576 θα αποσταλεί αύριο."

	
  }

    
  
}

Πιστοποίηση

Το SMSMobile API υποστηρίζει δύο μεθόδους ελέγχου ταυτότητας: χρησιμοποιώντας ένα απλό κλειδί API ή το πρωτόκολλο OAuth2 με αναγνωριστικό πελάτη και μυστικό πελάτη.

1. Έλεγχος ταυτότητας κλειδιού API

Για να στείλετε ή να ανακτήσετε μηνύματα WhatsApp μέσω του API μας, απαιτείται έλεγχος ταυτότητας χρησιμοποιώντας ένα κλειδί API. Αυτό εξασφαλίζει ασφαλή και εξουσιοδοτημένη πρόσβαση στην υπηρεσία ανταλλαγής μηνυμάτων. Απλώς συμπεριλάβετε το κλειδί API σας στο αίτημα για έλεγχο ταυτότητας και ξεκινήστε την απρόσκοπτη αποστολή μηνυμάτων.

2. Έλεγχος ταυτότητας OAuth2

Το OAuth2 παρέχει μια πιο ασφαλή και επεκτάσιμη μέθοδο ελέγχου ταυτότητας.
Θα χρειαστεί να χρησιμοποιήσετε ένα αναγνωριστικό πελάτη και ένα μυστικό πελάτη για να αποκτήσετε ένα διακριτικό πρόσβασης, το οποίο στη συνέχεια θα πρέπει να συμπεριληφθεί στα αιτήματά σας API χρησιμοποιώντας το Εξουσιοδότηση επί κεφαλής.

Το client_id και το client_secret είναι διαθέσιμα στον πίνακα ελέγχου σας.

Λήψη διακριτικού πρόσβασης

Για να λάβετε ένα διακριτικό πρόσβασης, στείλτε ένα αίτημα POST στο τελικό σημείο του διακριτικού με το αναγνωριστικό πελάτη και το μυστικό πελάτη.


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"

Χρήση του Access Token:

Μόλις έχετε το διακριτικό πρόσβασης, συμπεριλάβετέ το στο Εξουσιοδότηση κεφαλίδα των αιτημάτων σας 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.

Στείλτε μήνυμα WhatsApp

URL WSDL

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

Παράμετροι:

- recipients: Ο αριθμός κινητού τηλεφώνου του παραλήπτη.

- message: Το μήνυμα που πρέπει να στείλετε.

- apikey: Το κλειδί API που έχετε ή θα λάβετε.

- waonly: πρέπει να έχει την αξία Ναί -> Απαιτείται να ορίσετε ότι θα πρέπει να σταλεί μόνο ένα μήνυμα WhatsApp.

Παράδειγμα


                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

Βασική εντολή cURL

Μπορείτε να χρησιμοποιήσετε την ακόλουθη εντολή cURL για να στείλετε ένα μήνυμα WhatsApp μέσω του 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 στην PHP

Εάν χρησιμοποιείτε PHP, δείτε πώς μπορείτε να στείλετε ένα μήνυμα WhatsApp χρησιμοποιώντας το 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;

        

        ?>

Αυτό το παράδειγμα PHP δείχνει πώς να στείλετε ένα αίτημα POST χρησιμοποιώντας το cURL στο SMSmobileAPI, μεταβιβάζοντας τις απαραίτητες παραμέτρους ως συσχετιστικό πίνακα.

Στείλτε WhatsApp

Χρησιμοποιήστε την επίσημη ενότητα Python μας: https://smsmobileapi.com/python/
ή χρησιμοποιήστε τον τρόπο manual...

Χρήση της βιβλιοθήκης «αιτημάτων».

Η βιβλιοθήκη « αιτημάτων » είναι μια δημοφιλής και απλή βιβλιοθήκη HTTP για την Python. Δείτε πώς μπορείτε να το χρησιμοποιήσετε για να στείλετε ένα μήνυμα WhatsApp μέσω του 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)

Αυτό το παράδειγμα δείχνει ένα απλό αίτημα POST στο SMSmobileAPI, στέλνοντας ένα μήνυμα WhatsApp σε έναν συγκεκριμένο αριθμό τηλεφώνου.

Χρήση της βιβλιοθήκης «http.client».

Η βιβλιοθήκη «http.client» περιλαμβάνεται στην τυπική βιβλιοθήκη της Python και μπορεί επίσης να χρησιμοποιηθεί για αλληλεπίδραση με το 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()

Αυτό το παράδειγμα δείχνει πώς να χρησιμοποιήσετε τη βιβλιοθήκη «http.client» για να στείλετε ένα αίτημα POST στο API. Οι παράμετροι κωδικοποιούνται με URL και αποστέλλονται με τις κατάλληλες κεφαλίδες.

Στείλτε WhatsApp

Χρησιμοποιώντας το API "fetch".

Το «fetch» API είναι ένας σύγχρονος και ευέλικτος τρόπος για να κάνετε αιτήματα HTTP σε JavaScript. Δείτε πώς μπορείτε να το χρησιμοποιήσετε για να στείλετε ένα μήνυμα WhatsApp μέσω του 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));

Αυτό το παράδειγμα δείχνει πώς να στείλετε ένα αίτημα POST χρησιμοποιώντας το API `fetch`, το οποίο υποστηρίζεται στα περισσότερα σύγχρονα προγράμματα περιήγησης.

Χρησιμοποιώντας το «XMLHttpRequest».

Εάν χρειάζεται να υποστηρίξετε παλαιότερα προγράμματα περιήγησης, μπορείτε να χρησιμοποιήσετε το αντικείμενο «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);

Αυτό το παράδειγμα δείχνει πώς να χρησιμοποιήσετε το "XMLHttpRequest" για να στείλετε ένα αίτημα POST, παρέχοντας συμβατότητα με παλαιότερα προγράμματα περιήγησης που ενδέχεται να μην υποστηρίζουν "fetch".

Στείλτε WhatsApp

Χρήση της Βιβλιοθήκης `axios`

Η βιβλιοθήκη `axios` είναι ένας δημοφιλής πελάτης HTTP για το Node.js. Δείτε πώς μπορείτε να το χρησιμοποιήσετε για να στείλετε ένα μήνυμα WhatsApp μέσω του 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);

        });

Αυτό το παράδειγμα δείχνει πώς να στείλετε ένα αίτημα POST χρησιμοποιώντας το "axios" στο Node.js για αλληλεπίδραση με το SMSmobileAPI.

Στείλτε WhatsApp

Χρήση της βιβλιοθήκης `Net::HTTP`

Μπορείτε να χρησιμοποιήσετε τη βιβλιοθήκη `Net::HTTP` στο Ruby για να στείλετε ένα μήνυμα WhatsApp μέσω του 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

Αυτό το παράδειγμα δείχνει πώς να στείλετε ένα αίτημα POST χρησιμοποιώντας το "Net::HTTP" στο Ruby στο SMSmobileAPI.

Είναι επίσης δυνατό να στείλτε ένα μήνυμα WhatsApp και ένα SMS ταυτόχρονα.

Εάν έχετε οποιεσδήποτε ερωτήσεις, προτάσεις ή χρειάζεστε βοήθεια, η ομάδα μας είναι εδώ για να σας βοηθήσει.
Μη διστάσετε να επικοινωνήσετε μαζί μας στο api@smsmobileapi.com

Λειτουργίες SMS

Λειτουργίες WhatsApp

Γενικά πρόσθετα

Πρόσθετα Ηλεκτρονικού Καταστήματος

API και Έγγραφα προγραμματιστή

Μητρώο εργαλείων και αλλαγών

Τεκμηρίωση WhatsApp

Στείλτε WhatsApp

Εκ νέου αποστολή μηνύματος

Συγχρονισμός

Ανάκτηση μηνυμάτων

Πιστοποίηση

Αποστολή WhatsApp API

Τελικό σημείο:

Παράμετροι:

Παράδειγμα χωρίς μέσα:

Παράδειγμα με μέσα:

Μορφοποίηση κειμένου στο WhatsApp:

Στείλτε ξανά μη απεσταλμένα μηνύματα WhatsApp

Τελικό σημείο:

Παράμετρος:

Παράδειγμα:

Συγχρονισμός για ανάκτηση μηνύματος

Τελικό σημείο:

Παράμετρος:

Παράδειγμα:

Απάντηση:

Ανάκτηση μηνύματος WhatsApp

Τελικό σημείο:

Παράμετρος:

Παράδειγμα:

Απάντηση:

Πιστοποίηση

1. Έλεγχος ταυτότητας κλειδιού API

2. Έλεγχος ταυτότητας OAuth2

Λήψη διακριτικού πρόσβασης

Χρήση του Access Token:

Which Method Should You Use?

Στείλτε μήνυμα WhatsApp

URL WSDL

Παράμετροι:

Παράδειγμα

Στείλτε WhatsApp

Βασική εντολή cURL

Παράδειγμα cURL στην PHP

Στείλτε WhatsApp

Χρήση της βιβλιοθήκης «αιτημάτων».

Χρήση της βιβλιοθήκης «http.client».

Στείλτε WhatsApp

Χρησιμοποιώντας το API "fetch".

Χρησιμοποιώντας το «XMLHttpRequest».

Στείλτε WhatsApp

Χρήση της Βιβλιοθήκης `axios`

Στείλτε WhatsApp

Χρήση της βιβλιοθήκης `Net::HTTP`