İç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

client_idintegerzorunlu

Ayarlar → API anahtarları sayfasındaki API Client ID'niz.

api_keystringzorunlu

Aynı sayfadaki API anahtarınız.

whatsapp_clientintegerSahibin birden fazla bağlı numarası varsa zorunlu

Gönderimin yapılacağı WhatsApp numarasının ID'si; WhatsApp ayarları sayfasında bulunur. Çalışma alanı sahibine ait bir numara olmalıdır. Bu alanı göndermezseniz ve sahibin tam olarak bir bağlı numarası varsa, o numara 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.

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ı desteklenmez ve desteklenen bir uzantısı olmayan 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 ilk sonucu açar. 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.
  • Adı benzersiz yapın. Kısa veya eksik bir ad, aramada önce görünen farklı bir sohbetle eşleşebilir.
  • Hiçbir şey eşleşmezse, 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 NoneBu whatsapp_client ID'si çalışma alanı sahibine ait değil. Yukarıdaki uyarıya bakın.
Invalid whatsapp client id.whatsapp_client gönderin. Sahibin tam olarak bir bağlı numarası yoksa zorunludur.
Not enough creditsPlanınızda mesaj hakkı kalmadı.
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.
  • 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.