API ile WhatsApp Mesajı Gönderme: cURL, Node, Python, PHP

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400

// Node.js 18+ (yerleşik fetch ve FormData)
const form = new FormData();
form.append("batchId", "0");
form.append("campaignName", "order-updates");
form.append("destinationNo", "971500000000");
form.append("messageType", "TEMPLATE");
form.append("templateName", "order_update");
form.append("templateLanguage", "en_US");
form.append("bodyTemplateVariables", "INV-400");

const res = await fetch("https://api.broadnet.me/whatsapp/message/sendbulk", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.BROADNET_TOKEN}` }, // fetch multipart sınırını kendisi ayarlar
  body: form,
});
console.log(await res.json());

import os
import requests

fields = {
    "batchId": "0",
    "campaignName": "order-updates",
    "destinationNo": "971500000000",
    "messageType": "TEMPLATE",
    "templateName": "order_update",
    "templateLanguage": "en_US",
    "bodyTemplateVariables": "INV-400",
}
# Her alanı url-encode (data=) yerine multipart parçası (files=) olarak gönderin.
r = requests.post(
    "https://api.broadnet.me/whatsapp/message/sendbulk",
    headers={"Authorization": f"Bearer {os.environ['BROADNET_TOKEN']}"},
    files={k: (None, v) for k, v in fields.items()},
    timeout=30,
)
print(r.json())

<?php
$ch = curl_init("https://api.broadnet.me/whatsapp/message/sendbulk");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("BROADNET_TOKEN")],
    // Dize değil dizi, cURL'un multipart/form-data göndermesini sağlar.
    CURLOPT_POSTFIELDS => [
        "batchId" => "0",
        "campaignName" => "order-updates",
        "destinationNo" => "971500000000",
        "messageType" => "TEMPLATE",
        "templateName" => "order_update",
        "templateLanguage" => "en_US",
        "bodyTemplateVariables" => "INV-400",
    ],
]);
echo curl_exec($ch);
curl_close($ch);

{
  "totalFiles": 1,
  "totalSuccess": 1,
  "totalFailed": 0,
  "totalDuplicates": 0,
  "batchId": "2609091405000000001",
  "fileResults": [
    {
      "fileName": "direct",
      "totalRecords": 1,
      "successCount": 1,
      "failedRecipients": [],
      "duplicateRecipients": []
    }
  ],
  "message": "Messages queued for delivery"
}

Hangi istek alanları en önemlidir?

Hangi alanların zorunlu olduğu messageType değerine bağlıdır. Yaygın olanlar şunlardır.

Zamanlama scheduled, scheduleTime ve gmt kullanır; delay iletimi yavaşlatır. Tam liste WhatsApp API referansında.

Düğmeli bir şablonu veya OTP'yi nasıl gönderirim?

Düğme değerini buttonsTemplateVariable içine ekleyin. Kod kopyalama düğmeli bir kimlik doğrulama şablonu için kodu hem gövde hem düğme alanlarında geçirin.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=login_code \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=482913 \
  -F buttonsTemplateVariable=482913

Burada login_code, kendi onaylı kimlik doğrulama şablonunuz için bir yer tutucudur. Birden fazla düğme için buttonsTemplateVariable bir JSON dizisi alır. Kodu sunucunuzda üretin, geçerlilik süresiyle hash'lenmiş saklayın ve asla günlüğe yazmayın. OTP rehberimiz tek dokunuşlu, sıfır dokunuşlu ve kod kopyalama iletimini kapsar.

Müşteri hizmetleri penceresi içinde nasıl yanıt veririm?

Bir oturum mesajı türü kullanın. Düz metin yanıtı için messageType=TEXT ve content gerekir.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F destinationNo=971500000000 \
  -F messageType=TEXT \
  -F campaignName=support \
  -F "content=Your order has shipped. Reply here if you need anything."

Yanıt düğmeleri için messageType=INTERACTIVE ve Meta'nın etkileşimli mesaj biçimini izleyen bir interactivePayload gönderin.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F destinationNo=971500000000 \
  -F messageType=INTERACTIVE \
  -F campaignName=support \
  -F 'interactivePayload={"type":"button","body":{"text":"Confirm your delivery slot?"},"action":{"buttons":[{"type":"reply","reply":{"id":"slot_ok","title":"Confirm"}},{"type":"reply","reply":{"id":"slot_change","title":"Change"}}]}}'

Gelen bir mesajı okundu olarak işaretlemek ve isteğe bağlı olarak yazıyor göstergesi göstermek için JSON ile POST /whatsapp/message/read çağırın:

curl -X POST https://api.broadnet.me/whatsapp/message/read \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "messageId": "wamid.HBgMOTcxNTAwMDAwMDAwFQIAEhgg", "typing": true }'

Tasarım rehberliği için etkileşimli mesajlar rehberimize bakın.

İletimi nasıl takip ederim?

Durumlar hesabınızda yapılandırılan webhook'a itilir ve batch bazında da okunabilir. Her alıcı SUBMITTED, SENT, DELIVERED ve READ aşamalarından ilerler ya da bir nedenle FAILED veya REJECTED olarak sonlanır.

curl "https://api.broadnet.me/whatsapp/message/bulk-insights?batch_Id=2609091405000000001&status=FAILED&page=0&size=50" \
  -H "Authorization: Bearer $BROADNET_TOKEN"

batch_Id zorunludur; status, destination, search, page ve size isteğe bağlıdır ve page sıfırdan başlar. Kaçırılan olaylar için polling'i yedek olarak kullanın ve alıcınızı webhook rehberimizde anlatıldığı gibi oluşturun. Batch'ler ayrıca referanstaki batch uç noktalarıyla duraklatılabilir, sürdürülebilir ve iptal edilebilir.

Hangi hataları yönetmeliyim?

Önce HTTP durumunu, sonra hata gövdesini okuyun. API hataları beş alanlı bir JSON gövdesiyle bildirir ve WhatsApp'a özgü başarısızlıklar Meta'dan gelebilir.

Hata kodları rehberimiz yaygın Meta kodlarını açıklar. İdempotency anahtarı olmadığı için Hatalar ve limitler sayfasındaki mükerrer koruma adımlarını izleyin: önce bekleyen bir kayıt yazın, dönen batchId'yi saklayın ve zaman aşımından sonra yeniden göndermeden önce durumu kontrol edin.

Örnek senaryo: Bir sipariş bildirim servisi

BAE'li bir perakendeci olan "Souq Rafiq" (kurgusal), bir sipariş kargoya verildiğinde order_update şablonunu gönderir.

1. Sipariş servisi, order-8842-shipped anahtarlı ve pending durumlu bir satır yazar.
2. Şablon ve sipariş numarasını bodyTemplateVariables olarak vererek sendbulk çağırır.
3. 200 alınca batchId'yi saklar ve satırı accepted olarak işaretler.
4. Webhook işleyicisi satırı DELIVERED veya READ ya da nedenle FAILED olarak günceller.
5. Müşteri yanıt verirse destek aracı pencere içinde TEXT oturum mesajı kullanır.
6. Gece çalışan bir iş dünkü batch'ler için bulk-insights'ı okur ve eksik durumları mutabık hale getirir.

Yaygın hatalar nelerdir?

• JSON göndermek. WhatsApp gönderim uç noktası multipart'tır; Content-Type: application/json çalışmaz.
• files= yerine Python data=; bu, formu url-encode eder.
• Pencere dışında serbest metin; başarısız olur. Şablon kullanın.
• Yanlış dil kodu; şablonun en_US değeri yerine en gibi.
• 200'ü iletildi saymak. Kuyruğa alındı demektir.
• Zaman aşımından sonra kör yeniden denemeler; bir müşteriye iki kez mesaj gidebilir.
• İstemci kodunda token. API'yi yalnızca arka ucunuzdan çağırın.
• Limitler: yük ayrıntıları şablona göre değişir. İlk kişiselleştirilmiş kampanyanız için değişken düzenini ekibimizle teyit edin.

OmniChannels.ai nasıl yardımcı olur?

BroadNet resmi bir Meta Business Solution Provider'dır ve WhatsApp Business API'ye devreye alma Meta Embedded Signup kullanır; ekibimiz kaydı sizinle birlikte hazırlar, onaylar Meta'da kalır. REST API bir OpenAPI 3.1 belirtimi ve bir TypeScript SDK'sı olan @broadnet/cpaas-sdk ile belgelenmiştir; iletim durumları kanallar arasında normalleştirilir. WhatsApp API belgeleriyle veya hızlı başlangıçla başlayın.