İçeriğe geç
WbizTool

cURL ile WhatsApp mesajı gönderin

Kod yazmadan önce WbizTool WhatsApp API’sini terminalinizden deneyin. Aşağıdaki her komut https://wbiztool.com/api/v1/ altına tek bir POST’tur ve mesaj, WhatsApp Web gibi bağlanan kendi numaranızdan gider.

Ücretsiz başlayın

Ücretsiz deneme: herhangi bir 30 günde 50 mesaj, kart gerekmez.

Nasıl çalışır

  1. API anahtarınızı alın ve numaranızı bağlayın

    Kaydolun, ardından WhatsApp numaranızı WhatsApp numaraları sayfasında, WhatsApp Web’deki gibi bir QR kod veya eşleştirme koduyla bağlayın. Ayarlar → API anahtarları sayfasında bir anahtar oluşturun ve Client ID’nizi kopyalayın (aşağıdaki API anahtarları kılavuzu nerede olduğunu gösterir). Numaranın kartındaki ID (örneğin ID 678) sizin whatsapp_client değerinizdir.

  2. Kimlik bilgilerinizi test edin

    client_id ve api_key değerlerinizi /api/v1/me/ adresine POST edin. "message": "Okay" ile birlikte "status": 1 çalıştıkları anlamına gelir. Hiçbir şey göndermez ve mesaj harcamaz.

  3. Mesaj gönderin

    Telefon numarası ve metinle /api/v1/send_msg/ adresine POST gönderin. "status": 1 ve bir msg_id içeren yanıt, mesajın numaranızda sıraya alındığı anlamına gelir.

  4. Gittiğini kontrol edin

    /api/v1/message/status/<msg_id>/ adresine POST gönderin. Durum 1 Sent, durum 2 Failed demektir; nedeni error alanındadır.

cURL kod örnekleri

Kimlik bilgilerinizi kontrol edin
curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'
Metin gönderin
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -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",
    "msg": "Hi Aman, your order #4821 has shipped and will arrive on Thursday."
  }'
Yanıt
{"status": 1, "message": "Created", "msg_id": 9817263}
URL’deki bir görseli gönderin
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -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",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts today 🎉"
  }'
URL’deki bir PDF’yi gönderin
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 2,
    "country_code": "91",
    "phone": "9876543210",
    "file_url": "https://example.com/invoices/invoice-4821.pdf",
    "file_name": "invoice-4821.pdf",
    "msg": "Your invoice for order #4821 is attached."
  }'
Bilgisayarınızdan dosya yükleyin
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -F client_id=12345 \
  -F api_key=YOUR_API_KEY \
  -F whatsapp_client=678 \
  -F msg_type=2 \
  -F country_code=91 \
  -F phone=9876543210 \
  -F "msg=Your invoice for order #4821 is attached." \
  -F file_name=invoice-4821.pdf \
  -F file=@./invoice-4821.pdf
Mesaj zamanlayın
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
  -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",
    "msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
    "date": "24/12/2026",
    "time": "09:00",
    "timezone": "Asia/Kolkata"
  }'
Mesaj durumunu kontrol edin
curl -X POST https://wbiztool.com/api/v1/message/status/9817263/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

Neler yapabilirsiniz

  • JSON veya form alanları

    Gövdeyi JSON, form alanları ya da dosya yüklerken multipart form verisi (-F) olarak gönderin. Örnekler, kendi ID’lerinizi ve anahtarınızı yazdığınızda olduğu gibi çalışır.

  • Görseller ve dosyalar

    msg_type 1, img_url adresindeki bir görseli; msg_type 2, file_url adresindeki bir dosyayı gönderir. Bağlantılı dosyalar en fazla 100 MB olabilir ve bağlantı herkese açık olmalıdır.

  • Saat dilimiyle zamanlayın

    schedule_msg, date (dd/mm/yyyy), time (HH:MM) ve America/New_York gibi bir timezone adı ya da IST veya EST gibi bir kısaltma alır.

  • Her durum için webhook’lar

    "webhook": "https://…" ekleyin; mesajın durumu değiştiğinde WbizTool bu adrese msg_id ve SENT, FAILED, CANCELLED veya EXPIRED POST eder.

  • Aynı çağrılar her araçtan

    Make, Pabbly Connect ve diğer otomasyon araçları bu aynı istekleri HTTP modülleriyle gönderir. Belgelerde bir Postman koleksiyonu da bulunur.

Bilmeniz gerekenler

  • "status": 1 mesajın teslim edildiği değil, sıraya alındığı anlamına gelir. Sent son başarı durumudur; API mesajın teslim edilip edilmediğini veya okunup okunmadığını bildirmez.
  • JSON içinde msg alanındaki yeni satırı \n olarak yazın. Ham bir satır sonu veya sondaki bir virgül JSON’u geçersiz kılar.
  • Geçmişteki bir zamanlama saati kabul edilir ve hemen gönderilir. Tarih gün önce yazılır (24/12/2026), bu yüzden göndermeden önce kontrol edin.
  • Mesaj gönderme hataları HTTP 400 ile döner (günlük sınırda 429); Mesaj zamanlama hataları ise genellikle HTTP 200 ve "status": 0 ile döner; bu yüzden her zaman gövdeyi çözüp status değerine bakın.
  • API ile bir WhatsApp grubuna göndermek (phone yerine group_name) ücretsiz deneme dahil tüm planlarda çalışır.
  • Ücretsiz deneme herhangi bir 30 günde 50 mesaj ve 1 numara içerir, kart gerekmez. Ücretli planlar ABD’de aylık $25’dan başlar (sizin fiyatınız Fiyatlar sayfasındadır) ve adil kullanım kapsamında sınırsız mesaj gönderir: numara başına günde en fazla 1.000.
  • Mesajlar kendi WhatsApp numaranızdan gider, bu yüzden WhatsApp’ın kuralları geçerlidir: sizden haber bekleyen kişilere yazın.

Sık sorulan sorular

Mesaj göndermek için WhatsApp API endpoint’i nedir?
client_id, api_key, whatsapp_client, phone (numarada ülke kodu yoksa country_code ile birlikte) ve msg ile https://wbiztool.com/api/v1/send_msg/ adresine POST gönderin. Yanıtta status ve başarılıysa bir msg_id bulunur.
cURL ile WhatsApp mesajı nasıl zamanlanır?
Aynı alanlara ek olarak date (dd/mm/yyyy), time (HH:MM) ve timezone ile https://wbiztool.com/api/v1/schedule_msg/ adresine POST gönderin. Yanıttaki msg_id ile mesajı daha sonra kontrol edebilir veya iptal edebilirsiniz.
Mesajın gönderildiğini nasıl anlarım?
"status": 1 ve bir msg_id içeren yanıt, mesajın sıraya alındığı anlamına gelir. SENT, FAILED, CANCELLED veya EXPIRED içeren bir POST almak için bir webhook URL’si verin ya da msg_id ile Mesaj durumu endpoint’ini çağırın. Sent son durumdur: API teslim edildi veya okundu bilgisi vermez.
Telefon numarasını hangi biçimde göndermeliyim?
Numarayı ülke koduyla (919876543210) ya da ülke kodu olmadan (9876543210) country_code (91) ile birlikte gönderin. Boşluklar, +, tireler ve parantezler sizin için kaldırılır; yani +91 98765-43210 da çalışır.
WhatsApp Business API’ye veya Meta onayına ihtiyacım var mı?
Hayır. WbizTool, WhatsApp Web gibi bağlanan kendi WhatsApp veya WhatsApp Business numaranızdan gönderir. Meta onayı yoktur ve onaylatılması gereken mesaj şablonu yoktur.
Mesaj başına mı ücret alınıyor?
Hayır. Ücretsiz deneme herhangi bir 30 günde 50 mesaj içerir. Ücretli planlar adil kullanım kapsamında, numara başına günde en fazla 1.000 olmak üzere sınırsız mesaj gönderir: ABD’de aylık Lite $25, Standard $59 ve Advanced $149; Fiyatlar sayfası ülkenizin fiyatını gösterir.

Kılavuzları okuyun

İlgili sayfalar

İlk otomatik WhatsApp mesajınızı bugün gönderin

Bir hesap oluşturun, QR kodu okutun ve beş dakikadan kısa sürede mesaj gönderin.

Ücretsiz başlayın

Ücretli planlar ABD’de aylık $25’dan başlar. Fiyatlar