İçeriğe geç
WbizTool

Mesajlaşma API'si

Birden fazla numaraya gönderme API'si

Aynı WhatsApp mesajını tek bir istekte birkaç telefon numarasına ve gruba gönderin. Bültenler, kampanyalar ve duyurular gibi küçük toplu gönderimler için kullanın.

POSThttps://wbiztool.com/api/v1/send_msg/multi/

Gövde: JSON veya form alanları

WbizTool her alıcı için bir mesaj oluşturur ve her biri için bir msg_id döndürür; böylece durumlarını tek tek kontrol edebilirsiniz.

Hızlı örnek#

curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210,9812345670,Sales Team Mumbai",
    "msg": "Our Diwali sale starts tomorrow. Get 20% off on all orders!"
  }'

12345, YOUR_API_KEY ve 678 değerlerini kendi değerlerinizle değiştirin. Bunları nerede bulacağınız için Kimlik doğrulama bölümüne bakın.

İstek parametreleri#

Kimlik doğrulama

AuthorizationheaderÖnerilir

Bearer YOUR_API_KEY: Ayarlar → API anahtarları sayfasındaki API anahtarınız. Bu başlıkla client_id ve api_key gövdeden çıkarılabilir; ikisi birden gönderilirse başlıktaki geçerli anahtar kullanılır. Bkz. Anahtarı başlıkta gönderin.

client_idintegerAuthorization başlığı olmadan

Ayarlar → API anahtarları sayfasındaki API Client ID'niz. Başlıkla isteğe bağlıdır; gönderirseniz anahtarın çalışma alanına ait olmalıdır.

api_keystringAuthorization başlığı olmadan

Aynı sayfadaki API anahtarınız; başlıkta göndermediğinizde.

whatsapp_clientintegerzorunlu

Gönderimin yapılacağı WhatsApp numarasının veya Telegram hesabının ID'si; WhatsApp ayarları sayfasında bulunur. Mesaj gönderme endpoint'inden farklı olarak bu endpoint sizin için asla numara seçmez.

Alıcılar ve mesaj

phonestringzorunlu

Virgülle ayrılmış tek bir metin içinde telefon numaraları ve grup adları; örneğin 9876543210,9812345670,Sales Team Mumbai. JSON dizisi göndermeyin. Bkz. Alıcılar nasıl okunur.

country_codestringisteğe bağlı

+ olmadan ülke telefon kodu, örneğin 91. Numara zaten bununla başlamıyorsa ve + ya da 00 ile yazılmamışsa her telefon numarasının önüne eklenir. JSON'da hem metin ("91") hem sayı (91) çalışır.

msg_typeintegeristeğe bağlı

0 metin (varsayılan), 1 görsel, 2 dosya veya belge.

msgstringmsg_type 0 olduğunda zorunlu

Mesaj metni. Görsel ve dosyalarda açıklama metnidir ve boş olabilir. WhatsApp biçimlendirmesi çalışır: *bold*, _italic_, ~strikethrough~. message da takma ad olarak kabul edilir.

Görseller ve dosyalar

img_urlstringmsg_type 1 olduğunda zorunlu

Görselin herkese açık http veya https URL'si.

file_urlstringmsg_type 2 olduğunda zorunlu

Dosyanın doğrudan indirilebileceği herkese açık http veya https URL'si.

file_namestringisteğe bağlı

Alıcıların gördüğü dosya adı, örneğin price-list.pdf. Küçük harflerle gönderilir, & : ? * $ ; gibi karakterler _ ile değiştirilir ve 150 karaktere kısaltılır. Göndermezseniz ad URL'den alınır.

Teslimat seçenekleri

webhookstringisteğe bağlı

Her mesaj gönderildiğinde, başarısız olduğunda, iptal edildiğinde veya süresi dolduğunda bir POST alan URL. İçerik, Mesaj gönderme ile aynıdır.

idempotency_keystringisteğe bağlı

İsteğe bağlı, en fazla 255 karakter. 24 saat boyunca aynı değerle yeniden denediğinizde ikinci bir mesaj yerine ilk yanıtı alırsınız. Bunun yerine Idempotency-Key başlığı olarak da gönderebilirsiniz. Bkz. Güvenle yeniden deneme.

URL'den görselcURL
curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210,9812345670",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts tomorrow."
  }'

Alıcılar nasıl okunur#

WbizTool phone değerini virgüllerden böler, her öğenin çevresindeki boşlukları kırpar ve ardından her öğenin ne olduğuna karar verir:

  • Telefon numaraları elinizdeki gibi yazılabilir: +91 98765 43210, 98765-43210, (987) 654-3210, 0091 98765 43210 ve +44 (0)20 7946 0018 çalışır; 919876543210.0 ve 9.19876543210E+11 gibi tablo değerleri de çalışır.
  • country_code, numara zaten bununla başlamıyorsa ve + ya da 00 ile yazılmamışsa eklenir: country_code 91 ile +44 20 7946 0018, 442079460018 olarak kalır. Yani bir listede farklı ülkelerin numaraları bir arada olabilir: diğer ülkelerin numaralarını + ile yazın.
  • Baştaki 0 ile yazılmış yerel bir numara da çalışır: 09876543210, country_code 91 ile 919876543210 numarasına; 0612345678 ise 39 ile (İtalya, burada 0 numaranın parçasıdır) 390612345678 numarasına gider.
  • Ülke kodu eklendikten sonra bir numara 7 ile 15 hane arasında olmalıdır.
  • Sales Team Mumbai veya Family 2024 gibi harf veya başka simgeler içeren metinler WhatsApp grup adı olarak değerlendirilir ve Gruba gönderme ile aynı şekilde bulunur.
  • 2024-2025 gibi harf içermeyen bir grup adı telefon numarası olarak okunur; ancak 10'dan az rakamı varsa ve çalışma alanınız tam olarak bu adı taşıyan bir gruba daha önce mesaj gönderdiyse (grup Kişiler sayfasında Gruplar altında listelenir) grup adı olarak okunur. 2024-25 veya (2024) gibi 7'den az rakamlı ve tire, nokta ya da parantez içeren kısa bir ad her zaman grup adıdır. Virgül içeren grup adlarına bu endpoint'ten gönderim yapılamaz. Bunlar için Gruba gönderme endpoint'ini kullanın.
  • Bir Telegram hesabından gönderirken bir @username, bir t.me/username bağlantısı veya tg:<id> grup adı değil, bir kişidir; bir telefon numarası da Telegram'daki o kişiye gider. Bir WhatsApp numarasından gönderirken kullanıcı adları, t.me bağlantıları ve tg:<id> atlanır.

Bilmeniz gereken diğer noktalar:

  • Ülke kodu eklendikten sonra çok kısa veya çok uzun olan numaralar, yuvarlanmış tablo değerleri ve yalnızca sıfırlardan oluşan öğeler (0, 00) sessizce atlanır. Yanıtta görünmezler ve msg_id almazlar.
  • Tekrarlar kaldırılmaz. İki kez listelenen bir numara iki mesaj alır.
  • Yerel bir numara country_code ile aynı rakamlarla başlıyorsa (örneğin country_code 91 ile 9123456780), kod eklenmez. Bu tür numaraları ülke kodu zaten eklenmiş olarak (919123456780) gönderin.
  • Görsel ve dosya URL'leri API'yi çağırdığınızda kontrol edilmez. Her mesaj gönderilirken indirilirler; bu yüzden bozuk bir bağlantı isteğin değil, mesajların daha sonra başarısız olmasına yol açar. Mesaj gönderme ile aynı gönderim anı kuralları geçerlidir: 16 MB'tan büyük görseller ve 64 MB'tan büyük videolar başarısız olur, WAV ve OGG ses dosyaları görsel olarak (msg_type 1) gönderilemez ve uzantısı olmayan ya da desteklenmeyen bir uzantısı olan dosyalara (msg_type 2) .pdf eklenir. Bkz. Görsel ve dosya gönderme.

Mesaj sınırları#

Herhangi bir şey oluşturulmadan önce tüm grup kontrol edilir, bu yüzden bir liste asla kısmen gönderilmez. phone içindeki boş olmayan her öğe sayılır; daha sonra atlanan öğeler de dahil. Kuyruğa alınmış ancak henüz gönderilmemiş mesajlar da sayılır.

  • Her plan: grup, gönderen numaranın günlük adil kullanım sınırına – herhangi bir 24 saatte 1.000 mesaj – sığmalıdır. Aksi halde hiçbir mesaj oluşturulmaz ve şu yanıtı alırsınız:
{
  "message": "Daily limit reached: a number can send 1,000 messages in 24 hours (fair use). Send the rest tomorrow. 1200 messages requested, 640 more can go out from this number in the next 24 hours.",
  "code": "daily_limit_reached",
  "status": 0
}
  • Ücretsiz plan: grup ayrıca çalışma alanının kalan ücretsiz mesajlarına (herhangi bir 30 günde 50) da sığmalıdır. Aksi halde şu yanıtı alırsınız:
{
  "message": "Not enough credits: 120 messages requested, 35 credits remaining",
  "status": 0
}

Büyük listeleri birkaç numaraya veya güne bölün. Büyük kampanyalar için bunun yerine Kampanyalar sayfasından bir tablo dosyası yükleyin.

Yanıt#

Başarılı bir istek HTTP 200 döndürür:

{
  "msg_ids": [9817263, 9817264, 9817265],
  "messages": [
    { "msg_id": 9817263, "contact": "919876543210", "is_group": false },
    { "msg_id": 9817264, "contact": "919812345670", "is_group": false },
    { "msg_id": 9817265, "contact": "Sales Team Mumbai", "is_group": true }
  ],
  "message": "Successfully created 3 messages",
  "status": 1
}
AlanTürAçıklama
statusintegerEn az bir mesaj kuyruğa alındıysa 1, aksi halde 0.
messagestringBaşarıda Successfully created N messages, aksi halde hata mesajı.
msg_idstam sayı dizisiKuyruğa alınan mesajların ID'leri, phone sırasına göre. Yalnızca başarıda bulunur.
messagesdiziKuyruğa alınan her mesaj için bir nesne. Yalnızca başarıda bulunur.
messages[].msg_idintegerMesajın ID'si.
messages[].contactstringÜlke kodu uygulanmış telefon numarası veya grup adı.
messages[].is_groupbooleanÖğe grup adı olarak değerlendirildiyse true.

Atlanan numaraları bulmak için messages listesini gönderdiğiniz listeyle karşılaştırın ve telefon numarası olarak kastettiğiniz her öğe için is_group değerinin false olduğunu kontrol edin.

Hatalar#

Çoğu hata, status değeri 0 olarak HTTP 200 döndürür; bu yüzden gövdedeki status değerini her zaman kontrol edin. HTTP 400 ve 403 hataları dışında yanıtlar (başarılı olanlar dahil) Content-Type: text/html ile gönderilen JSON'dur; bu yüzden otomatik JSON algılamaya güvenmek yerine (örneğin kodsuz araçlarda) gövdeyi kendiniz ayrıştırın:

{ "message": "Invalid whatsapp client", "status": 0 }
MesajNasıl düzeltilir
Auth Errorclient_id ve api_key değerlerinin ikisini de gönderin.
Invalid Client Idclient_id değerini sayı olarak gönderin. HTTP 403 ile döner.
Auth Error: invalid api keyAnahtarın mevcut olduğunu, silinmediğini ve bu client_id değerine ait olduğunu kontrol edin. HTTP 400 ile döner.
Msg cant be nullMetin mesajları (msg_type 0) msg gerektirir.
Image Url Can't be nullmsg_type 1 için img_url gönderin.
File Url Can't be nullmsg_type 2 için file_url gönderin.
Not enough credits: … messages requested, … credits remainingÜcretsiz planın mesajları listeyi karşılamıyor. Daha az alıcıya gönderin veya bir plan seçin. Bkz. Mesaj sınırları.
Daily limit reached: … messages requested, … more can go out from this number in the next 24 hours.Listeyi günlere veya numaralara bölün. Bkz. Mesaj sınırları.
Invalid whatsapp clientBu whatsapp_client ID'si çalışma alanınızda değil.
No valid contacts foundphone içindeki her öğe boştu veya atlandı. Numaraların ülke koduyla birlikte 7 ile 15 hane arasında olduğunu kontrol edin.
Demo Account can not access apisNormal bir hesap kullanın.
Invalid JSON format: …JSON gövdesi geçerli değil veya form alanlarını client_id olmadan gönderdiniz.

İpuçları#

  • phone değerini metin olarak gönderin: listenizi virgüllerle birleştirin. Bir JSON dizisi {} döndürür.
  • Şimdilik Python istemcisinin send_bulk_messages yöntemini kullanmayın: listeyi bu endpoint'in yok saydığı phones alanında gönderir. Endpoint'i yukarıdaki örneklerdeki gibi doğrudan çağırın.
  • Her mesajı takip edin: messages içindeki her msg_id değerini kaydedin veya her biri gönderildiğinde, başarısız olduğunda, iptal edildiğinde ya da süresi dolduğunda bildirim almak için bir webhook iletin.
  • Numaranızı bağlı tutun: her mesaj WhatsApp numaranızdan gönderilir, bu yüzden tüm grup gönderilene kadar numaranın WhatsApp ayarları sayfasında bağlı kalması gerekir.
  • Kişiye göre farklı metin: bu endpoint herkese aynı msg değerini gönderir. Her mesajı kişiselleştirmek için her alıcı için bir kez Mesaj gönderme endpoint'ini çağırın.