SMS mesajlarınız kendi telefonunuzdan gönderilir.Nasıl çalıştığını öğrenin
PLATFORMFORMFORMAPI-ilk mimarlıkGüvenli cihaz çiftleşiyorTeslimat görünürlüğü görünürlüğüMulti-device kontrolüVersioned documents
Geliştirici merkezi/ WhatsApp API

WA · 9 belgelenmiş işlemler

WhatsApp API Belgeleme

WhatsApp mesajları ve medya gönderin, alıcı sayıları doğrulama ve açık bir senkronizasyon isteğinden sonra mesajları güvenli bir şekilde alır.

Bağlantılı telefonlar konuşmaları ve medyayı senkronize etmek
REST temel URLhttps://api.smsmobileapi.com

JSON yanıtları · HTTPS gerekli · UTF-8

API anahtarını bağlayın

Bir kez, SMS'deki uç noktaları test edin, aramalar, bildirimler, WhatsApp ve e-posta.

Buraya başlayın

İlk isteğiniz dört adımda

1

WhatsApp'i desteklenen bir mobil için bağlayın.

2

Alıcıyı sayı kontrol uç noktası ile onaylayın.

3

Sadece wa only =yes ile gönderin.

4

Satın alınan mesajları almak için: koleksiyon, arama /getwa /synchronisation /, kurtarma için bekle, sonra arama /getwa.

YENIDEN BESLENMEDEN ÖNCE MANDATORY MESAJLARI ALDI

WhatsApp senkronizasyonu ilk önce talep edin.

aramadan önce aramadan önce/getwaWhatsApp mesajları almak için, bir senkronizasyon penceresi talep etmeniz gerekirhttps://api.smsmobileapi.com/getwa/synchronisation/. Bu açık adım WhatsApp ve SMSMobileAPI arasındaki değişimi güvenle yazmak için gereklidir. Kurtarmayı bekleyin, sonra arayın/getwa.

Gerekli senkronizasyon uç noktası açın →
Güvenli SMSMobileAPI mobil uygulama bir telefona web paniğe ve REST API'e SMS için bir telefon ve operasyon çağrısı
Şifrelenmiş mobil platform bağlantı bağlantı bağlantı

Resmi mobil uygulama

Telefonunuz, kontrol paneliniz ve API arasındaki güvenli köprü.

SMS ve çağrı işlemleri, bağlı telefonunuza yüklenen resmi SMSMobileAPI uygulaması üzerinden geçer. Uygulama, cihazı güvenli bir şekilde hesabınızla eşleştirir, yetkili etkinlikleri senkronize eder ve mobil ağı kontrol paneline ve REST API'ye bağlar.

1Mobil uygulamaTelefonu ve SIM'ini eşler 2Şifreli bağlantıAktarım halindeki verileri doğrular ve korur 3Kontrol Paneli ve APIİş akışlarını ve etkinliği kontrol eder
  • Resmi Google Play ve Apple App Store listeleri aracılığıyla dağıtılan imzalı sürümler
  • Google ve Apple platform incelemesi, imzalama ve dağıtım kontrolleri
  • Güvenli cihaz eşleştirme, HTTPS aktarımı ve kimlik doğrulamalı API erişimi
  • Yalnızca etkinleştirdiğiniz mobil özellikler için gerekli izinler
Google Play'de resmi SMSMobileAPI uygulamasını alın Apple App Store'da resmi SMSMobileAPI uygulamasını indirin
Yetenekler, Android

BU API İÇİN WEBHOOK V2

İş akışınızın ihtiyaç duyduğu mobil olaylara abone olun.

5 olay türü

Bir hedef her şeyi alabilir ya da üretim sistemlerini, analizleri ve operasyonel uyarıları ayırabilirsiniz. Her olayın kesin bir adı vardır, böylece uygulamanız onu öngörülebilir şekilde işleyebilir.

whatsapp.submitted

WhatsApp gönderim talebi oluşturuldu

Bir WhatsApp gönderim işi oluşturuldu.

whatsapp.sent

WhatsApp gönderildi

Bağlı WhatsApp ortamı mesajın gönderildiğini doğruladı.

whatsapp.failed

WhatsApp başarısız oldu

WhatsApp gönderme işlemi başarısız oldu.

whatsapp.received

WhatsApp alındı

Hesap senkronizasyon talep ettikten sonra bir WhatsApp mesajı alındı.

whatsapp.voice.transcribed

Sesli mesaj yazıya döküldü

Uygun bir alınmış WhatsApp sesli mesaj kullanılabilir metne dönüştürüldü.

Kimlik doğrulama

Kimlik bilgilerini sunucunuzda tutun

Doğrudan entegrasyonlar için apikey'i kullanın. OAuth2 istemci kimlik bilgileri sunucu tarafı uygulamalar için mevcuttur; bir jeton isteyin ve bunu Yetkilendirme olarak gönderin: Taşıyıcı ACCESS_TOKEN.

Tarih Yönetimi

Clear history güvenle: önizleme, silme, ilerleme

Bu uç noktaları, API anahtarınız için seçilen sunucu tarihini, telefonlarda veya dış hizmetlerde mesaj vermemektedir. Hesap süresi sağlamazlar. Yeni aktivite, yıkımdan sonra görünebilir.

request_id ve yeniden deneme rehberi
Bütünleştirici koruma koruma

Varsayılan olarak, bağlantılı veya işleme kayıtları görünür. Sadece sadece sadece kullanım kullanımı kullanın include_linked=1 Bu entegrasyonları kabul ederseniz veya devam eden işleme çalışmayı durdurabilir.

Nasıl istek id çalışır

  1. action=preview ile olan sayıların bir göstergesi. request_id gerekli değildir ve kayıtları silinmez.
  2. Genrate a unique request_id Yeni bir deletion için, örneğin bir UUID. Onu göndermeden önce kurtar action=delete.
  3. Yeniden geziler, zamanlar veya HTTP 202, aynı şeyi tekrarlayın API Anahtar, tarih uç noktası, request_id ve include_linked değer. Bir hatadan sonra otomatik olarak yeni bir kimlik üretmeyin.
  4. Tamamlandığında, operasyon sona erer. ID'sini yeniden kullanmak yeni gelen kayıtları silmenin yerine aynı sonucu döndürür. Sadece kasıtlı olarak yeni bir temizlik için yeni bir kimlik kullanın.

request_id Deletion işleminizi tanımlayın, bireysel bir birey değil SMSİzinli format: 16-128 ASCII mektuplar, basamaklar, hipnozlar veya alt işaretler. A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A A UUID Kripto.randomUUID() ile üretilen uygun.

Silme işlemi gruplar halinde yürütülür. HTTP 202 ile continue_required=true dönerse 3 saniye sonra action=delete isteğini tekrarlayın. Arka planda cron çalışmaz. action=status yalnızca ilerlemeyi okur ve HTTP 200 dönse bile silmeyi sürdürmez.

Deletion ve durum örnekleri

Başlangıçta kendi eşsiz değerinizle request_id örneklerini değiştirin. Aşağıdaki silekler gerçek hesap tarihini değiştirir; onlar önizleme değildir.

POST · API anahtar
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · · OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET · statü durumu
curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET Ayrıca kabul de kabul kabul de kabul action=preview veya veya action=delete. POST önerilir: URL parametreleri tarayıcı tarihine ve sunucu loglarına sızdırılabilir. Asla bir halk bağlantı, görüntü veya prefetch'de bir deletion URL'yi yerlemeyin.

POST için, form gövdesinde veya JSON nesnesinde tüm parametreleri gönderin, asla sorgu dizesinde. Bilinmeyen parametreler reddedilir; tarih veya mobil filtreler desteklenmez.

Tarih için kimlik doğrulama son noktaları

Birpikey veya bir Yazarlaşma kullanın: SMSMobileAPI OAuth2 tarafından yayınlanan Ayırma erişim. Bir yenileme token veya bir API anahtarını bir Ayıer token olarak göndermeyin. Açıklamalanmış jetonlar reddedilir.

Alanlar ayarlandığında, history:read önizleme /status ve izin verir history:delete Ayrıca deletion izin verir. Hem token hem de tokenler OAuth müşteri uygulanır. kapsamı olmayan Legacy Jetonlar mevcut hesap erişimlerini korur.

OAuth2 Benzersiz birincil birincil seçin API anahtar. Birkaç birincil anahtar var ise, aynı zamanda da sağlar apikey Hesabına ait birini seçmek. Orta anahtarlar asla birincil anahtar tarihine erişmez.

Devam etmeden önce cevabı okuyun

count delete bu operasyon tarafından kaldırıldı. Seçilen at start ilk seçimdir; protected at start dışlanmış kayıtlardır. Bağlantılı kayıtları saymak için önbellek kullanma işlemini, linked=1 dahil olduğunda bile.

JSON · · HTTP 202
{
    "result": {
        "error": 0,
        "history": "whatsapp-sent",
        "action": "delete",
        "request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
        "status": "processing",
        "completed": false,
        "count_delete": 100,
        "total_before": 250,
        "selected_at_start": 200,
        "protected_at_start": 50,
        "include_linked": 0,
        "continue_required": true,
        "message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
    }
}
  • completed=true ile 200: bit. Sadece 200 önizleme veya durum yanıtı tamamlanmamıştır.
  • 400 INVALID REQUEST ID: formatı kontrol edin. 404 REQUEST NOT FOUND: Bu ID için hiçbir operasyon mevcut değildir, API anahtar ve tarih.
  • 401: geçersiz veya süresiz kimlikler. 403: yetersiz OAuth kapsamı veya yetkisiz hesabı.
  • 409 HISTORY_BUSY: Başka bir temizlik çalışır; orijinal müşteriden devam edin. 409 INCLUDE_LINKED_CONFLICT: Orijinal include_linked değerini geri yükleyin.
  • 409 OAUTH_ACCOUNT_AMBIGUOUS: Bir an için API Bu hesaba ait anahtar.
  • 503 veya ağ kesintisi: Bazı partiler zaten tamamlanmış olabilir. Kontrol konfigürasyonu, sonra orijinal ile yeniden başa çıkmak request_id. Geçici bir işlem otomatik olarak yaratmaz.
POST · GET

Bir WhatsApp mesajı gönder

#
ENDPOINThttps://api.smsmobileapi.com/sendsms

Bağlı ortam üzerinden bir WhatsApp metni veya desteklenen medya gönderir.

Ne zaman kullanılmalı

Bireysel alıcılar veya kontrol paneli kişi grubu için kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız; bir Ayıer token omit.
recipients telefon telefon telefon telefon telefon telefon telefon telefon Gerekli Ülke kodu artı sayısı, + veya 00 olmadan.
message dize Gerekli Text body; birden çok çizgi desteklenmektedir.
waonly Evet Gerekli WhatsApp-sadece teslimat talep etmek için evet olmalıdır.
url_media HTTPS URL URL URL Seçmeli Yayın PDF, belge, arşiv veya JPG / PNG URL.
url_media_shorted Evet Seçmeli PDF önizleme modu ile kısaltılmış bir URL kullanın.
pdf_with_image Evet Seçmeli PDF için bir görüntü önizleme ekleyin.
encrypt_message Evet Seçmeli Alıcının şifresini gerektirir.
contactGroup GUID Seçmeli Bir pano grubu içinde her temasa gönderin.

Örneğin

kıvrımlı
curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=191728660" \
  --data-urlencode "message=Your order is ready."

Örnek yanıt

JSON
{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "MESSAGE_GUID",
    "send_with_whatsapp": "1"
  }
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Desteklenen medya URL'leri kamu HTTPS kaynakları olmalıdır.
  • WhatsApp format: *bold*, italic , ~strikethrough~ ve üçlü geri dönüşüm monospace.
POST · GET

Bir tanımlanmamış WhatsApp mesajı

#
ENDPOINThttps://api.smsmobileapi.com/resendwa/

Şu anda bir hata statüsüne sahip olan WhatsApp mesajı yeniden gözden geçirin.

Ne zaman kullanılmalı

Başarısız bir WhatsApp giriş girişini teşhis ettikten sonra kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız.
guid dize Gerekli Başarısız mesajın GUID.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Sadece başarısız mesajlar tekrar için uygundur.
ELDE ETMEK

Activate inbound retrieval

#
ENDPOINThttps://api.smsmobileapi.com/getwa/active/

Activates, suçlamak veya WhatsApp mesajı geri dön.

Ne zaman kullanılmalı

İlk önce Activate koleksiyonu. Ardından, mesaj almadan önce, sen /getwa /synchronisation /getwa / ihteşme yoluyla senkronizasyonu talep etmelisiniz.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız.
statut 0 | 1 | x Seçmeli 1 aktive eder, 0 deactivates, x veya omission mevcut durumu göz önünde bulundurmak.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"

Örnek yanıt

JSON
{
  "success": true,
  "read_message_active": 1,
  "status_note": "Activated"
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Inbound retrieval, mahremiyet için varsayılan olarak devre dışı bırakılır.
  • Sadece bir araya gelme mesajları almaz: senkronizasyon talebi yeni alınan aktivite için /getwa kullanmaya önce zorunlu kalır.
ELDE ETMEK

Gerekli: WhatsApp senkronizasyonu talep edin

#
ENDPOINThttps://api.smsmobileapi.com/getwa/synchronisation/

Mandatory security step before retrieving received WhatsApp messages. It opens a time-limited synchronization window.

Ne zaman kullanılmalı

Bu uç noktası daha önce aramanız gerekir / SMSMobileAPI'e yeni alınan mesajlar için WhatsApp'i kontrol etmeniz için ihtiyacınız olduğunda. Kurtarmayı bekleyin, sonra /getwa deyin.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"

Örnek yanıt

JSON
{
  "error": "0",
  "messages": "synchronized",
  "expire_at": "2026-03-11 12:27:00",
  "expire_at_unix": "1773232020"
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • senkronizasyon sadece mesajları almak içindir. göndermeden önce arama.
  • Cevap süresi sona ermiş ve süresi at unix. Yenileyici toplamak için ihtiyacınız olduğunda başka bir senkronizasyon penceresi talep edin.
  • Bir senkronizasyon isteği WhatsApp ve SMSMobileAPI arasındaki değişimi korumak zorunludur.
ELDE ETMEK

Erişim tarihi: WhatsApp mesajları

#
ENDPOINThttps://api.smsmobileapi.com/getwa

Returns received WhatsApp messages that were recovered during a requested synchronization window.

Ne zaman kullanılmalı

Mandatory ön şart: inbound retrieval, https://api.smsmobilapi.com/getwa/synchronisation/ first, wait for recovery, then call this endpoint. /getwa kendini senkronizasyona başlamaz.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız.
before Unix zamantampampampampamp Seçmeli Bu zamantamp'tan önce kayıtlarınızı döndürür.
date YYYYYY-MM-DDD Seçmeli Bir tarih için kayıtlarınızı döndürür.
message_type metin | ses Seçmeli Filtre metin mesajları veya ses mesajları her ikisi için de geçerlidir; omit.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"

Örnek yanıt

JSON
{
  "date": "2026-03-11",
  "hour": "12:27:00",
  "timestamp": "1773232020",
  "number": "19176728660",
  "contact": "SMSMobileAPI",
  "message": "When will I receive my order?",
  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
ELDE ETMEK

Bir WhatsApp numarası kontrol edin

#
ENDPOINThttps://api.smsmobileapi.com/whatsapp/checknumber/

Bir telefon numarasının WhatsApp'de olup olmadığını kontrol edin.

Ne zaman kullanılmalı

Kaçılabilir başarısızlıkları azaltmak için göndermeden önce kullanın.

Parametreler

AdTürGereklilikTanım
apikey dize Gerekli API anahtarınız.
recipients telefon telefon telefon telefon telefon telefon telefon telefon Gerekli Ülke kodu artı sayısı, + veya 00 olmadan.

Örneğin

kıvrımlı
curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"

Örnek yanıt

JSON
{
  "contact_found_on_whatsapp": "yes",
  "recipients": "19176728660"
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
POSTALAMAK

OAuth2 erişim token

#
ENDPOINThttps://api.smsmobileapi.com/oauth2/token

Bir Ayıer token için Exchanges client overview.

Ne zaman kullanılmalı

Kısa süreli kimliklerin tercih edildiği sunucu-to-server entegrasyonları için kullanın.

Parametreler

AdTürGereklilikTanım
grant_type dize Gerekli Müşteri credentials olmalıdır.
client_id dize Gerekli Panelden müşteri kimliği.
client_secret dize Gerekli Müşteri panodan gizli.

Örneğin

kıvrımlı
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=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Müşteriyi sunucunuzda gizli tutun. Asla mobil veya tarayıcı kodunda ekleyin.
POST · GET

Gönderilen WhatsApp mesajlarının geçmişini temizle

#
ENDPOINThttps://api.smsmobileapi.com/delete-history-whatsapp-sent/

WhatsApp mesajlarının açık sunucu kayıtları. WhatsApp konuşmalarından mesajları silmiyor.

Ne zaman kullanılmalı

İlk önce önizleme kullanın, sayıları kontrol edin, sonra açıkça istek delesyon. Bu, seçilen tüm tarihi açıklar API Anahtar, tarih olmadan, telefon veya mesaj filtreleri.

Parametreler

AdTürGereklilikTanım
apikey dize Seçmeli Gerekli olmadan Gerekli OAuth2. with . with OAuth2, Seçmeli olarak bir an seçin API Aynı hesaba ait anahtar.
action Tanıtım | silin | durum Seçmeli preview silmeden sayar; delete silmeyi başlatır veya sürdürür; status yalnızca ilerlemeyi gösterir. API varsayılanı delete, bu test aracının varsayılanı preview değeridir.
include_linked 0 | 1 Seçmeli Varsayılan 0: Bağlantılı veya işleme kayıtlarını tut. Onları içerecek 1 set, kırılma entegrasyonları riski ile. Bu değeri bir delesyon devam ederken değişmeden tutun.
request_id dize Seçmeli delete ve status için zorunlu, preview için isteğe bağlıdır. 16–128 ASCII harfi, rakam, kısa çizgi (-) veya alt çizgi (_) kullanın. Her yeni silme işlemi için benzersiz bir ID oluşturun ve tüm yeniden denemelerde aynı ID’yi koruyun. Bu bir mesaj ID’si veya API anahtarı değildir.

Örneğin

kıvrımlı
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
Deletion ve durum örnekleri

Başlangıçta kendi eşsiz değerinizle request_id örneklerini değiştirin. Aşağıdaki silekler gerçek hesap tarihini değiştirir; onlar önizleme değildir.

POST · API anahtar
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · · OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET · statü durumu
curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

Örnek yanıt

JSON
{
    "result": {
        "error": 0,
        "history": "whatsapp-sent",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Yukarıdaki örnek bir önbellek değil, bir deletion. Kontlar açıklayıcıdır; kesin seçim, yıkım başladığında sabitlenir.
  • include_linked=1 Bu kesintiyi bozabilir GHL, Zapier, otomasyonlar, Ücretli bağlantılar veya teslimat izleme. Asla hesap mülkiyeti veya depolama bütünlüğü kontrollerini atlamıyor.
POST · GET

Alınan WhatsApp mesajlarının geçmişini temizle

#
ENDPOINThttps://api.smsmobileapi.com/delete-history-whatsapp-received/

WhatsApp mesajlarının açık sunucu kayıtları. WhatsApp'i veya konuşmaları bozmaz.

Ne zaman kullanılmalı

İlk önce önizleme kullanın, sayıları kontrol edin, sonra açıkça istek delesyon. Bu, seçilen tüm tarihi açıklar API Anahtar, tarih olmadan, telefon veya mesaj filtreleri.

Parametreler

AdTürGereklilikTanım
apikey dize Seçmeli Gerekli olmadan Gerekli OAuth2. with . with OAuth2, Seçmeli olarak bir an seçin API Aynı hesaba ait anahtar.
action Tanıtım | silin | durum Seçmeli preview silmeden sayar; delete silmeyi başlatır veya sürdürür; status yalnızca ilerlemeyi gösterir. API varsayılanı delete, bu test aracının varsayılanı preview değeridir.
include_linked 0 | 1 Seçmeli Varsayılan 0: Bağlantılı veya işleme kayıtlarını tut. Onları içerecek 1 set, kırılma entegrasyonları riski ile. Bu değeri bir delesyon devam ederken değişmeden tutun.
request_id dize Seçmeli delete ve status için zorunlu, preview için isteğe bağlıdır. 16–128 ASCII harfi, rakam, kısa çizgi (-) veya alt çizgi (_) kullanın. Her yeni silme işlemi için benzersiz bir ID oluşturun ve tüm yeniden denemelerde aynı ID’yi koruyun. Bu bir mesaj ID’si veya API anahtarı değildir.

Örneğin

kıvrımlı
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
Deletion ve durum örnekleri

Başlangıçta kendi eşsiz değerinizle request_id örneklerini değiştirin. Aşağıdaki silekler gerçek hesap tarihini değiştirir; onlar önizleme değildir.

POST · API anahtar
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · · OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET · statü durumu
curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

Örnek yanıt

JSON
{
    "result": {
        "error": 0,
        "history": "whatsapp-received",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

Bu isteği çalıştırmak ister misiniz?API anahtarını interaktif testleyiciyi kilidini açmak için sayfanın başında bağlayın.

Anahtarı bağlayın ↑
İyi bilmek
  • Yukarıdaki örnek bir önbellek değil, bir deletion. Kontlar açıklayıcıdır; kesin seçim, yıkım başladığında sabitlenir.
  • include_linked=1 Bu kesintiyi bozabilir GHL, Zapier, otomasyonlar, Ücretli bağlantılar veya teslimat izleme. Asla hesap mülkiyeti veya depolama bütünlüğü kontrollerini atlamıyor.

Sorun giderme

Hatalar ve güvenli yenidenrries

HTTP statüsünü ve JSON hata alanını yeniden denemeden önce okuyun. İstekyi ilk önce düzeltmeden doğrulama veya doğrulama başarısızlıklarını yeniden denemeyin.

HTTPKod Kodu KoduNe yapmalı
400missing_parameterGerekli bir parametre boş veya yok. Son nokta için parametre masasına göz atın.
403invalid_apikeyAPI anahtarı bilinmemektedir, süresiz veya talep edilen özellik için yetkili değildir.
429too_many_requestsİstekler çok hızlı geliyor. Bekle, sonra üst üste tekrar tekrarla.
500server_errorHizmet isteği tamamlayamadı. Devam ederse yanıt ve iletişim desteği tutun.
Yeniden deneme kuralıYeniden deneme sadece 429 ve 5xx yanıtlarını geçici olarak yeniden deneyin. 1 saniye sonra, sonra 2, 4 ve 8 saniyeye kadar geri başlayın.

Yardıma mı ihtiyacınız var?

İstek bağlamını getir - sırlarınız değil.

Son noktayı paylaşın, zamantamp, HTTP durumu ve sanitized yanıt. API anahtarlarını, jetonları veya özel mesaj içeriğini asla dahil etmeyin.

İletişim API destek