İçeriğe geç
WbizTool

Mesajlaşma API'si

WhatsApp grubuna mesaj gönderme API'si

Bağlı numaranızın üyesi olduğu bir WhatsApp grubuna WhatsApp metni, görseli veya belgesi gönderin. Ekip duyuruları, topluluk güncellemeleri ve toplu bildirimler için kullanın.

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

Gövde: JSON, form alanları veya dosya yüklerken multipart/form-data

Mesaj kuyruğa alınır ve WhatsApp numaranızdan gruba gönderilir. Yanıt, durumunu kontrol etmek için kullanabileceğiniz bir msg_id verir.

Hızlı örnek#

curl -X POST https://wbiztool.com/api/v1/send_msg/group/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "group_name": "Sales Team Mumbai",
    "msg": "Reminder: *weekly review* starts at 4 PM today."
  }'

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_clientintegerÇalışma alanınızda birden fazla bağlı numara varsa zorunlu

Gönderimin yapılacağı WhatsApp numarasının ID'si; WhatsApp ayarları sayfasında bulunur. Hangi ekip üyesi bağlamış olursa olsun, çalışma alanınızdaki her numara kullanılabilir. Bu alanı göndermezseniz ve çalışma alanınızda tam olarak bir bağlı WhatsApp numarası varsa, o numara kullanılır (hiçbir WhatsApp numarası bağlı değilse tek Telegram hesabı kullanılır).

Grup ve mesaj

group_namestringzorunlu

WhatsApp grubunun adı; tam olarak WhatsApp'ta göründüğü gibi yazılmalıdır. Metin (string) olarak gönderin. 2024 gibi bir JSON sayısı bir HTML hata sayfası (HTTP 500) döndürür. Bkz. Grup nasıl bulunur.

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 ve dosya yüklenmediğinde zorunlu

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

file_urlstringmsg_type 2 olduğunda ve dosya yüklenmediğinde zorunlu

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

filefileisteğe bağlı

URL vermek yerine görseli veya dosyayı yükleyin. İsteği multipart/form-data olarak, alan adı file olacak şekilde gönderin.

file_namestringisteğe bağlı

Grubun gördüğü dosya adı, örneğin price-list.pdf. Dosyanın nasıl gönderileceğini uzantısı belirler, bu yüzden bir uzantı ekleyin. Küçük harflerle gönderilir, & : ? * $ ; gibi karakterler _ ile değiştirilir ve 150 karaktere kısaltılır. Göndermezseniz ad URL'den veya yüklenen dosyadan alınır.

Teslimat seçenekleri

expire_after_secondsintegeristeğe bağlı

Mesaj bu kadar saniye içinde gönderilmediyse süresi dolmuş (durum 4) olarak işaretlenir; örneğin bir saat için 3600. Bunu bir arka plan işi süre dolduktan en az 30 saniye sonra yapar; bu yüzden bir dakikadan kısa süreler için buna güvenmeyin.

webhookstringisteğe bağlı

Mesaj gönderildiğinde veya başarısız olduğ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.

Görseller ve dosyalar, Mesaj gönderme ile aynı kurallara uyar: URL'ler API'yi çağırdığınızda indirilir (en fazla 100 MB). Mesaj gönderilirken 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; yüklenen dosyalar da buna dahildir. Dosya adları küçük harflerle gönderilir. Uzantıların ve hataların tam listesi için Görsel ve dosya gönderme bölümüne bakın.

Dosya yüklemek için Mesaj gönderme sayfasındaki multipart örneklerini kullanın; URL'yi /api/v1/send_msg/group/ ile, phone/country_code alanlarını da group_name ile değiştirin.

URL'den görsel
curl -X POST https://wbiztool.com/api/v1/send_msg/group/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "group_name": "Sales Team Mumbai",
    "img_url": "https://example.com/reports/weekly-sales.png",
    "msg": "This week'\''s sales summary"
  }'

Grup nasıl bulunur#

WbizTool, API'yi çağırdığınızda grup adını kontrol etmez. Mesaj gönderilirken WbizTool, WhatsApp sohbetlerinizde group_name değerini arar ve yalnızca adı tam olarak group_name olan gruba gönderir. Bu nedenle:

  • Bağlı WhatsApp numaranız grubun üyesi olmalıdır.
  • Grubun tam adını, emoji ve noktalama işaretleri dahil, WhatsApp'ta göründüğü gibi kullanın. Baştaki ve sondaki boşluklar yok sayılır, art arda gelen birden fazla boşluk tek boşluk sayılır.
  • Eksik adlar artık eşleşmez. Sales Team adı, Sales Team Mumbai arama sonuçlarında ilk sırada olsa bile bu gruba göndermez.
  • Büyük ve küçük harfleri WhatsApp'ta göründüğü gibi yazın. Yalnızca büyük/küçük harf farkı olan bir ad, örneğin sales team mumbai, yalnızca hiçbir sohbet tam yazımla eşleşmiyorsa ve tek bir yazım eşleşiyorsa kabul edilir.
  • Bir kişiye bir grupla aynı adı vermeyin. WhatsApp'ınızda bu adda bir kişi varsa ya da bir kişi ve bir grup bu adı paylaşıyorsa, mesaj gönderilmez. Kişinin veya grubun adını değiştirin.
  • İki grubun adı tamamen aynıysa, mesaj WhatsApp arama sonuçlarındaki ilk gruba gider. Her gruba benzersiz bir ad verin.
  • Hiçbir grubun adı tam olarak bu değilse, ad bir kişiye aitse, grupta yalnızca yöneticiler mesaj gönderebiliyorsa ve numaranız yönetici değilse ya da yalnızca topluluk yöneticileri paylaşım yapabiliyorsa, mesaj Group not found hatasıyla başarısız olur.
  • Numaranız gruptan ayrıldıysa, mesaj Group member blocked hatasıyla başarısız olur.

Grup sorunları API yanıtında görünmez. Mesajın gönderilip gönderilmediğini öğrenmek için bir webhook veya Mesaj durumu kullanın.

Resmi istemciyi kullanma#

Python istemcisi bu endpoint'i sizin için çağırır.

Python
from wbiztool_client import WbizToolClient

client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)

result = client.send_message_to_group(
    group_name="Sales Team Mumbai",
    msg="Reminder: weekly review starts at 4 PM today.",
    whatsapp_client=678,
)
print(result)

Hatalar requests.HTTPError fırlatır. Nedeni e.response.json()["message"] ile okuyun.

Yanıt#

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

{
  "status": 1,
  "message": "Created",
  "msg_id": 9817263
}
AlanTürAçıklama
statusintegerMesaj kuyruğa alındıysa 1, istek başarısız olduysa 0.
messagestringBaşarıda Created, aksi halde hata mesajı.
msg_idintegerKuyruğa alınan mesajın ID'si. Durumu daha sonra kontrol etmek için kaydedin. Yalnızca başarıda bulunur.

"status": 1, mesajın gruba ulaştığı değil, kuyruğa alındığı anlamına gelir. Gönderildiğini doğrulamak için bir webhook veya Mesaj durumu kullanın.

Hatalar#

Hatalar, status değeri 0 olarak HTTP 400 döndürür:

{ "status": 0, "message": "Group Name cant be null" }
MesajNasıl düzeltilir
Auth Error - Please send correct API key and Client idBoş olmayan bir api_key gönderin.
Invalid client id.client_id değerini sayı olarak gönderin.
Auth Error: invalid api keyAnahtarın mevcut olduğunu, silinmediğini ve bu client_id değerine ait olduğunu kontrol edin.
Group Name cant be nullgroup_name ekleyin.
Msg cant be nullMetin mesajları (msg_type 0) msg gerektirir.
Image Url Can't be nullmsg_type 1 için img_url gönderin veya bir file yükleyin.
File Url Can't be nullmsg_type 2 için file_url gönderin veya bir file yükleyin.
Invalid file url, Can't download / Invalid file urlURL herkese açık değil, zaman aşımına uğradı veya dosya 100 MB'tan büyük.
Invalid whatsapp client <id>: this WhatsApp number was deleted or does not belong to your account…Bu whatsapp_client silinmiş veya API anahtarının çalışma alanında değil. WhatsApp ayarları sayfasındaki bağlı bir numaranın ID'sini kullanın.
Invalid whatsapp client id.whatsapp_client gönderin. Çalışma alanınızda tam olarak bir bağlı numara yoksa zorunludur.
Not enough creditsÇalışma alanı ücretsiz planda ve mesajı kalmadı: ücretli planlar sınırsız mesaj gönderir. Bkz. Mesajlarınız bittiğinde.
Daily limit reached: a number can send 1,000 messages in 24 hours (fair use). Send the rest tomorrow. (HTTP 429, "code": "daily_limit_reached")Bu numara son 24 saatte 1.000 mesaj aldı (adil kullanım). Yanıtta reddedilen mesajın msg_id değeri yine bulunur; bu mesaj başarısız görünür. Kalanını daha sonra veya başka bir numaradan gönderin.
Demo Account can not access apisNormal bir hesap kullanın.
Account DisabledHesabınız devre dışı. Destekle iletişime geçin.
Invalid JSON format: …JSON gövdesi geçerli değil; genellikle sondaki bir virgül veya msg içindeki kaçışsız bir satır sonu nedeniyle. Yeni satırlar için \n kullanın.

İpuçları#

  • Önce adı test edin: herhangi bir şeyi otomatikleştirmeden önce gruba kısa bir metin gönderin ve Mesaj durumu ile kontrol edin. Group not found hatasıyla başarısız olursa Grup nasıl bulunur bölümüne bakın.
  • Adı değiştirilen gruplar: biri grubun adını WhatsApp'ta değiştirirse, entegrasyonunuzdaki group_name değerini de güncelleyin.
  • Mesaj türleri: msg_type için yalnızca 0, 1 ve 2 geçerli değerlerdir. Tam sayı olmayan herhangi bir değer JSON yerine bir HTML hata sayfası (HTTP 500) döndürür.
  • Aynı anda birkaç grup: Birden fazla numaraya gönderme endpoint'i tek bir istekte telefon numaralarıyla karışık grup adlarını kabul eder.