Dev DOC WhatsApp - SMSMobileAPI

WhatsApp Belgeleri

Bu dokümantasyon yalnızca WhatsApp mesajlarının gönderilmesi ve alınmasıyla ilgilidir.

Daha fazla bilgi edinmek için buraya tıklayın WhatsApp entegrasyonumuzun sunduğu tüm özellikler hakkında bilgi edinin.

SMSmobileAPI olarak API'mizi mümkün olduğunca her türlü mimari veya platformla uyumlu hale getirmeye çalışıyoruz.
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.

E-ticaret çözümleri ve yazılımları için hazır eklentilerimiz de mevcuttur. Bunları keşfetmek için buraya tıklayın.

API REST

cURL

JavaScript

piton

Düğüm.js

Yakut

WSDL

WhatsApp API'sini gönder

Bu API uç noktası WhatsApp mesajlarını göndermek için kullanılır.

Bitiş noktası:

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

Parametreler:

- apikey: Benzersiz API anahtarınız.

- 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: Gönderilecek mesaj (Birden fazla satır olabilir).

- url_media: WhatsApp üzerinden göndermek istediğiniz medya dosyasının doğrudan URL'si. İle başlamalıdır https:// ve geçerli bir şeye işaret ediyor PDF, belge veya görüntü Dosya. Dosya, kimlik doğrulaması olmadan herkes tarafından erişilebilir olmalıdır.
Desteklenenler: 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: değere sahip olmalı Evet -> Yalnızca bir WhatsApp mesajının gönderilmesi gerektiğini belirtmek gerekir

Medya olmadan örnek:


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

Medya örneği:


        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'ta Metni Biçimlendirme:

İtalik: Use underscores → _text_
Gözü pek: Use asterisks → *text*
Üstü çizili: Use tildes → ~text~
Tek aralıklı: Use backticks → ```text```

Örnek: _Merhaba_ dünya, ```SMSMobileAPI```'den ~bugün~ nasılsınız?

Gönderilmemiş bir WhatsApp mesajını yeniden gönder

Bu API uç noktası, gönderilmemiş bir mesajı yeniden göndermek için kullanılır (yalnızca mesajın bir hata durumu varsa)

Bitiş noktası:

ELDE ETMEK POSTALAMAK https://api.smsmobileapi.com/resendwa/

Parametre:

- guid: (gerekli) Tekrar gönderilecek mesajın GUID'si.

Örnek:


        https://api.smsmobileapi.com/resendwa/?apikey=API_ANAHTARINIZ&guid=MESAJIN_GUID'İNİ ALIN

Mesajı almak için senkronizasyon

Bu API uç noktası, WhatsApp mesajlarını senkronize etme ve alma isteği göndermek için kullanılır.
Bu adım zorunludur ve mesajları alan uç noktayı çağırmadan önce yürütülmelidir.

Uyarı: Senkronizasyon yalnızca mesaj alma işlevi için kesinlikle gereklidir. Mesaj göndermek için senkronizasyon başlatmayın.

Bitiş noktası:

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

Parametre:

- apikey (required): Sahip olduğunuz veya alacağınız API anahtarı.

Örnek:


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

Cevap vermek :



{


 "hata": "0",

   "mesajlar": "senkronize edildi",

  "son_süre_bitiş_saati": "2025-03-11 12:27:00",

  "unix'te_sona_eriyor": "1741692420",


 

}

WhatsApp Mesajını Al

Bu API uç noktası alınan WhatsApp mesajlarını almak için kullanılır.

Bitiş noktası:

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

Parametre:

- apikey (required): Sahip olduğunuz veya alacağınız API anahtarı.

- before (optional): Zaman damgasını parametre olarak geçir ve bu zaman damgasının altındaki kayıtları göster.

- date (optional): (yyyy-aa-gg) Tarihe göre tüm kayıtları al.

Örnek:


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

Cevap vermek :



{


  "tarih": "2025-03-11",

  "saat": "12:27:00",

  "zaman damgası": "1741692420",

  "sayı": "19176728660",

  "iletişim": "Smsmobileapi",

  "mesaj": "Siparişimi ne zaman alacağımı söyleyebilir misiniz?",

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

  
  "Daha": {

    "otomatik_cevap": "1",

    "e-postaya_aktar": "1",

    "sohbet_gpt_cevap": "1"

	
  },


  "sohbetgpt": {

    "prompt_tokens": "900",

    "tamamlama_belirteçleri": "10",

    "toplam_token": "910",

    "toplam_token_maliyeti": "0,182"

	 "response": "#576 siparişiniz yarın kargoya verilecektir."

	
  }

    
  
}

Kimlik doğrulama

SMSMobile API iki kimlik doğrulama yöntemini destekler: basit bir API Anahtarı veya istemci kimliği ve istemci sırrı içeren OAuth2 protokolü kullanılarak.

1. API Anahtar Kimlik Doğrulaması

API'miz üzerinden WhatsApp mesajları göndermek veya almak için bir API anahtarı kullanılarak kimlik doğrulaması gerekir. Bu, mesajlaşma servisine güvenli ve yetkili erişimi garanti eder. Kimlik doğrulaması yapmak ve mesajları sorunsuz bir şekilde göndermeye başlamak için API anahtarınızı isteğe eklemeniz yeterlidir.

2. OAuth2 Kimlik Doğrulaması

OAuth2 daha güvenli ve ölçeklenebilir bir kimlik doğrulama yöntemi sağlar.
Daha sonra API isteklerinize dahil edilmesi gereken bir erişim belirteci elde etmek için bir istemci kimliği ve istemci sırrı kullanmanız gerekecektir. Yetkilendirme Başlık.

client_id ve client_secret kontrol panelinizde mevcuttur.

Erişim Belirteci Elde Etme

Erişim belirteci almak için istemci kimliğiniz ve istemci sırrınızla belirteç uç noktasına bir POST isteği gönderin.


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"

Erişim Belirtecini Kullanma:

Erişim belirtecini aldıktan sonra bunu şuraya ekleyin: Yetkilendirme API isteklerinizin başlığı:


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 mesajı gönder

WSDL URL

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

Parametreler:

- recipients: Alıcının cep telefonu numarası.

- message: Gönderilecek mesaj.

- apikey: Sahip olduğunuz veya alacağınız API anahtarı.

- waonly: değere sahip olmalı Evet -> Yalnızca bir WhatsApp mesajının gönderilmesi gerektiğini belirtmek için gereklidir.

Örnek


                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 gönder

Temel cURL Komutu

SMSmobileAPI üzerinden WhatsApp mesajı göndermek için aşağıdaki cURL komutunu kullanabilirsiniz:


        curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

PHP'de cURL Örneği

Eğer PHP kullanıyorsanız, cURL kullanarak WhatsApp mesajı göndermenin yolu şöyledir:


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

        

        ?>

Bu PHP örneği, gerekli parametreleri ilişkisel bir dizi olarak geçirerek cURL kullanarak SMSmobileAPI'ye bir POST isteğinin nasıl gönderileceğini göstermektedir.

WhatsApp gönder

Resmi Python Modülümüzü kullanın: https://smsmobileapi.com/python/
veya manuel yolu kullanın ...

`requests` Kütüphanesini Kullanma

`requests` kütüphanesi Python için popüler ve basit bir HTTP kütüphanesidir. SMSmobileAPI üzerinden bir WhatsApp mesajı göndermek için bunu nasıl kullanabileceğiniz aşağıda açıklanmıştır:


        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)

Bu örnek, SMSmobileAPI'ye yapılan basit bir POST isteğini ve belirli bir telefon numarasına WhatsApp mesajı göndermeyi göstermektedir.

`http.client` Kütüphanesini Kullanma

`http.client` kütüphanesi Python'un standart kütüphanesinde yer alır ve API'nizle etkileşim kurmak için de kullanılabilir:


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

Bu örnek, API'ye bir POST isteği göndermek için `http.client` kütüphanesinin nasıl kullanılacağını gösterir. Parametreler URL kodludur ve uygun başlıklarla gönderilir.

WhatsApp gönder

`fetch` API'sini kullanma

`fetch` API, JavaScript'te HTTP istekleri yapmak için modern ve çok yönlü bir yoldur. SMSmobileAPI aracılığıyla bir WhatsApp mesajı göndermek için bunu nasıl kullanabileceğiniz aşağıda açıklanmıştır:


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

Bu örnek, çoğu modern tarayıcıda desteklenen `fetch` API'sini kullanarak bir POST isteğinin nasıl gönderileceğini göstermektedir.

`XMLHttpRequest` Kullanımı

Daha eski tarayıcıları desteklemeniz gerekiyorsa `XMLHttpRequest` nesnesini kullanabilirsiniz:


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

Bu örnek, `fetch` komutunu desteklemeyen eski tarayıcılarla uyumluluk sağlayarak, bir POST isteği göndermek için `XMLHttpRequest` komutunun nasıl kullanılacağını göstermektedir.

WhatsApp gönder

`axios` Kütüphanesini Kullanma

`axios` kütüphanesi Node.js için popüler bir HTTP istemcisidir. SMSmobileAPI aracılığıyla bir WhatsApp mesajı göndermek için bunu nasıl kullanabileceğiniz aşağıda açıklanmıştır:


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

        });

Bu örnek, Node.js'de `axios` kullanılarak SMSmobileAPI ile etkileşime geçmek için bir POST isteğinin nasıl gönderileceğini göstermektedir.

WhatsApp gönder

`Net::HTTP` Kütüphanesini Kullanma

Ruby'deki `Net::HTTP` kütüphanesini kullanarak SMSmobileAPI üzerinden WhatsApp mesajı gönderebilirsiniz:


        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

Bu örnek, Ruby'de `Net::HTTP` kullanılarak SMSmobileAPI'ye bir POST isteğinin nasıl gönderileceğini göstermektedir.

Ayrıca şu da mümkündür: aynı anda bir WhatsApp mesajı ve bir SMS gönderin.

Herhangi bir sorunuz, öneriniz varsa veya yardıma ihtiyacınız varsa ekibimiz size yardımcı olmak için burada.
Bize ulaşmaktan çekinmeyin api@smsmobileapi.com

WhatsApp Belgeleri

WhatsApp gönder

Mesajı tekrar gönder

Senkronizasyon

Mesajları Al

Kimlik doğrulama

WhatsApp API'sini gönder

Bitiş noktası:

Parametreler:

Medya olmadan örnek:

Medya örneği:

WhatsApp'ta Metni Biçimlendirme:

Gönderilmemiş bir WhatsApp mesajını yeniden gönder

Bitiş noktası:

Parametre:

Örnek:

Mesajı almak için senkronizasyon

Bitiş noktası:

Parametre:

Örnek:

Cevap vermek :

WhatsApp Mesajını Al

Bitiş noktası:

Parametre:

Örnek:

Cevap vermek :

Kimlik doğrulama

1. API Anahtar Kimlik Doğrulaması

2. OAuth2 Kimlik Doğrulaması

Erişim Belirteci Elde Etme

Erişim Belirtecini Kullanma:

Which Method Should You Use?

WhatsApp mesajı gönder

WSDL URL

Parametreler:

Örnek

WhatsApp gönder

Temel cURL Komutu

PHP'de cURL Örneği

WhatsApp gönder

`requests` Kütüphanesini Kullanma

`http.client` Kütüphanesini Kullanma

WhatsApp gönder

`fetch` API'sini kullanma

`XMLHttpRequest` Kullanımı

WhatsApp gönder

`axios` Kütüphanesini Kullanma

WhatsApp gönder

`Net::HTTP` Kütüphanesini Kullanma