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.
REST, SOAP, cURL veya Python, JavaScript, PHP gibi çeşitli programlama dillerini kullanıyor olun, API'miz projelerinize sorunsuz bir şekilde entegre olacak şekilde tasarlanmıştır.

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:

Parametre	Tanım
apikey	Gerekli Benzersiz API anahtarınız.
recipients	Gerekli Alıcının telefon numarası (Numaranın WhatsApp'ta kullanılabilir olması gerekmektedir). Ülke koduyla başlayarak ('+' ve '00' olmadan) telefon numaranızı girin, ardından numaranızın geri kalanını girin. Örnek: 191728660
message	Gerekli Gönderilecek mesaj (Birden fazla satır olabilir).
waonly	Gerekli Değeri olmalı Evet → Yalnızca bir WhatsApp mesajının gönderilmesi gerektiğini belirtmek için gereklidir.
url_media	WhatsApp üzerinden göndermek istediğiniz medya dosyasının doğrudan URL'si. Şu şekilde başlamalıdır: https:// ve geçerli bir şeye işaret ediyor PDF, belge veya görüntü dosya. Dosyanın kimlik doğrulaması yapılmadan herkes tarafından erişilebilir olması gerekir. Desteklenen formatlar: Belgeler: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz Resimler: jpg, jpeg, png
url_media_shorted	Eğer değer ise Evetve [pdf_with_image=yes] ayarlandığında, PDF için indirme bağlantısının gösterimi kısa bir URL üzerinden gerçekleşir.
pdf_with_image	Eğer değer ise Evet, PDF'in bir görüntü önizlemesi mesaja eşlik edecek şekilde gösterilecektir (yalnızca dosya bir PDF ise).
encrypt_message	Evet = Mesaj alıcı tarafından okunduğunda şifrelenecektir. Alıcının mesajı şifresini çözmek için benzersiz bir anahtar girmesi gerekecektir. Mesaj şifrelemesi hakkında daha fazla bilgi edinin

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: Alt çizgileri kullan → _text_
Gözü pek: Yıldız işareti kullan → *metin*
Üstü çizili: Tildeleri kullanın → ~metin~
Tek aralıklı: Ters tırnak işaretini kullan → ```metin```

Ö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:

Parametre	Tanım
guid	Gerekli Tekrar gönderilecek mesajın GUID'i.

Ö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:

Parametre	Tanım
apikey (required)	Gerekli 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:

Parametre	Tanım
apikey	Gerekli Sahip olduğunuz veya alacağınız API anahtarı.
before	Zaman damgasını parametre olarak geçir ve bu zaman damgasının altındaki kayıtları göster.
date	(yyyy-aa-gg) Tarihe göre tüm kayıtları al.
message_type	Tüm (metin ve sesli mesajları) görmek için boş bırakın Kullanmak `metin` sadece metin mesajlarını görmek için Kullanmak `ses` sadece metne dönüştürülmüş sesli mesajları görmek için

Ö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

SMS Özellikleri

WhatsApp Özellikleri

Genel Eklentiler

Çevrimiçi Mağaza Eklentileri

API ve Geliştirici Belgeleri

Araçlar ve Değişiklikler günlüğü

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