Toplu Bildirim

10 görüntülenme Markdown

Bir mesajı çok kişiye gönderen altı uç: hedef seçimi, sayım, deneme ve gönderim.

Genel Bakış

Bu altı uç bir mesajı çok kişiye göndermenin bütün adımlarını yürütür: kimin hedefleneceğini seçmek, kaç kişi olduğunu görmek, kendinize deneme yapmak ve göndermek.

Hedef kitle iki yoldan gelir. Süzgeçler müşterileri gruba, ülkeye, sahip olunan ürüne göre seçer. Bülten listesi ise elle tutulan bir adres listesidir ve üyelerinin müşteri olması gerekmez. Bülten anahtarı verdiğinizde süzgeçler yok sayılır.

Gönderim anında olmaz: mesajlar bildirim kuyruğuna alınır ve arka planda işlenir. Yanıttaki gönderim kimliği, o partinin kuyruktaki satırlarını bulmanızı sağlar.

Referans

Süzgeç Seçeneklerini Getirme

get/api/v1/admin/tools/bulk/lookups
Tools/GetBulkLookups admin süzgeçlerin kaynağı

Alıcı süzgeçlerinde kullanabileceğiniz değerleri döndürür.

Dönen alanlar data — 7
user_groupsarrayMüşteri grupları.
departmentsarrayDepartmanlar.
countriesobject[]Ülkeler; her biri kimlik, ad ve ülke kodu taşır.
languagesobject[]Diller; her biri anahtar ve ad taşır.
tldsarrayAlan adı uzantıları.
productsarrayÜrünler, kategori ağacıyla birlikte.
service_statusesstring[]Hizmet durumları.
Hatalar 1
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl 'https://panel.ornek.com/api/v1/admin/tools/bulk/lookups' \
  -H "Authorization: Bearer $API_KEY"
const res  = await fetch('https://panel.ornek.com/api/v1/admin/tools/bulk/lookups', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/tools/bulk/lookups');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Suzgec degerlerini BURADAN alin: kimlikleri tahmin etmek sessizce bos hedef kitle uretir.
$lookups = Api::Tools()->GetBulkLookups()['data'];

$groupIds = array_column($lookups['user_groups'], 'id');

Alıcıları Sayma

post/api/v1/admin/tools/bulk/contacts
Tools/GetBulkContacts admin gönderim yapmaz

Süzgeçlerinizin kaç kişiye ulaşacağını gönderim yapmadan söyler.

Gövde — kim 4
user_typestringAlıcı türü: client ya da staff. Varsayılan müşteri.
notification_typestringKanal: mail ya da sms. Kanal, kimin ulaşılabilir sayıldığını değiştirir.
newsletterstringBülten anahtarı. Verirseniz süzgeçler yerine bülten listesi kullanılır.
fullintSayının yanında alıcı listesini de döndürür.
Gövde — süzgeçler 11
user_groupsarrayMüşteri gruplarına göre süzer.
departmentsarrayDepartmanlara göre süzer.
countriesarrayÜlkelere göre süzer.
languagesarrayDillere göre süzer.
servicesarraySahip olunan ürünlere göre süzer.
serversarrayHizmetin bulunduğu sunuculara göre süzer.
addonsarraySahip olunan ek hizmetlere göre süzer.
services_statusarrayHizmet durumuna göre süzer.
client_statusarrayMüşteri durumuna göre süzer.
without_productsintHiç ürünü olmayan müşterileri hedefler.
birthday_marketingintDoğum günü olan müşterileri hedefler.
Dönen alanlar data — 3
countintEşleşen alıcı sayısı.
contactsarrayAlıcılar. Yalnız istediyseniz dolar.
sourcestringAlıcıların nereden geldiği: süzgeçlerden ya da bültenden.
Hatalar 1
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X POST 'https://panel.ornek.com/api/v1/admin/tools/bulk/contacts' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"user_type":"client","notification_type":"mail","user_groups":[1]}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/tools/bulk/contacts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    user_type: 'client',
    notification_type: 'mail',
    user_groups: [1],
  }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/tools/bulk/contacts');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'user_type'         => 'client',
        'notification_type' => 'mail',
        'user_groups'       => [1],
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Gondermeden ONCE sayin: ayni govdeyi gonderim ucuna verdiginizde bu sayi kadar kisiye gider.
$audience = ['user_type' => 'client', 'user_groups' => [1]];
$count    = Api::Tools()->GetBulkContacts($audience)['data']['count'];

if ($count > 0 && $count < 5000) {
    Api::Tools()->SubmitBulkNotification($audience + [
        'subject' => 'Notice',
        'message' => $html,
    ]);
}

Test Gönderimi

post/api/v1/admin/tools/bulk/test
Tools/TestBulkNotification admin yalnız size gider

Mesajı müşterilere değil, verdiğiniz adreslere ve departman çalışanlarına gönderir.

Gövde 5
messagestringzorunluMesaj gövdesi.
notification_typestringKanal. Varsayılan e-posta.
subjectstringKonu. Boş bırakılırsa sabit bir başlık kullanılır.
departmentsint[]Departmanlar. Bu departmanlara atanmış çalışanlara gider.
emailsstringDışarıdan adresler. Satır satır yazılır.
Dönen alanlar data — 1
sentintGönderilen test sayısı.
Hatalar 2
body_required422Mesaj gövdesi boş.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X POST 'https://panel.ornek.com/api/v1/admin/tools/bulk/test' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"subject":"Test","message":"Hello.","emails":"[email protected]"}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/tools/bulk/test', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    subject: 'Test',
    message: 'Hello.',
    emails: '[email protected]',
  }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/tools/bulk/test');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'subject' => 'Test',
        'message' => $html,
        'emails'  => '[email protected]',
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Test SUZGECLERI dikkate almaz: hedef kitleyi dogrulamaz, yalniz mesajin gorunumunu dogrular.
Api::Tools()->TestBulkNotification([
    'subject' => 'Notice',
    'message' => $html,
    'emails'  => '[email protected]',
]);

Toplu Bildirimi Gönderme

post/api/v1/admin/tools/bulk/submit
Tools/SubmitBulkNotification admin geri alınamaz

Mesajı eşleşen tüm alıcılar için kuyruğa alır. Asıl gönderim budur.

Gövde — mesaj 5
messagestringzorunluMesaj gövdesi.
subjectstringKonu. E-postada zorunlu.
notification_typestringKanal. Varsayılan e-posta.
ccstringBilgi olarak eklenecek adresler. Satır satır yazılır.
deliverystringZarf biçimi: single herkese ayrı mesaj, multiple tek zarfta toplu. Toplu zarfta alıcılar birbirini görebilir.
Gövde — kim 3
user_typestringAlıcı türü: müşteriler ya da personel.
newsletterstringBülten anahtarı. Verirseniz süzgeçler yerine bülten listesi kullanılır.
*array | intSayma ucundaki on bir süzgecin aynısı burada da geçerlidir.
Dönen alanlar data — 3
queuedboolKuyruğa alındı mı.
recipientsintKuyruğa alınan alıcı sayısı.
batch_idstringBu gönderimin kimliği. Bildirim kuyruğunda aynı gönderimin satırlarını bununla bulursunuz.
Hatalar 4
subject_required422E-postada konu boş.
body_required422Mesaj gövdesi boş.
no_recipients422Süzgeçlere uyan alıcı yok.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X POST 'https://panel.ornek.com/api/v1/admin/tools/bulk/submit' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"notification_type":"mail","user_type":"client","subject":"Notice","message":"Important update.","delivery":"single","user_groups":[1]}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/tools/bulk/submit', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    notification_type: 'mail',
    user_type: 'client',
    subject: 'Notice',
    message: 'Important update.',
    delivery: 'single',
    user_groups: [1],
  }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/tools/bulk/submit');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'subject'     => 'Notice',
        'message'     => $html,
        'delivery'    => 'single',
        'user_groups' => [1],
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Kuyruga alinan bir gonderim GERI ALINAMAZ; toplu iptalin yolu kuyruk satirlarini silmektir.
$batch = Api::Tools()->SubmitBulkNotification($audience + [
    'subject' => 'Notice',
    'message' => $html,
])['data'];

// Yanlis gitti: bekleyenleri kuyruktan cikarin.
$queued = Api::Tools()->GetNotificationQueue([], ['status' => 'pending'])['data'];
$ids    = array_column(
    array_filter($queued, fn (array $n): bool => $n['batch_id'] === $batch['batch_id']),
    'id',
);

Api::Tools()->BulkDeleteNotificationQueue(['ids' => $ids]);
Yanıt 
{
  "data": {
    "queued": true,
    "recipients": 1842,
    "batch_id": "b7f3c1a9"
  }
}
{
  "error": {
    "code": "no_recipients",
    "message": "No recipient matched the filters."
  }
}

Bülten Listesini Okuma

get/api/v1/admin/tools/bulk/newsletters
Tools/GetBulkNewsletters admin dile göre

Bülten abonelerini döndürür. Bunlar müşteri olmak zorunda değildir.

Sorgu parametreleri 2
typestringKanal: email ya da sms. Varsayılan e-posta.
langstringDil kodu. Vermezseniz tüm diller özet olarak döner ve yanıtın şekli değişir.
Dönen alanlar data
entriesstring[]Listedeki adresler ya da numaralar. Dil verildiğinde döner.
countintListedeki kayıt sayısı.
by_langobjectDil koduna göre sayı ve liste. Dil verilmediğinde bunun yerine bu döner.
Hatalar 1
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -G 'https://panel.ornek.com/api/v1/admin/tools/bulk/newsletters' \
  -H "Authorization: Bearer $API_KEY" \
  -d type=email \
  -d lang=en
const url = new URL('https://panel.ornek.com/api/v1/admin/tools/bulk/newsletters');
url.searchParams.set('type', 'email');
url.searchParams.set('lang', 'en');

const res  = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
const body = await res.json();
$url = 'https://panel.ornek.com/api/v1/admin/tools/bulk/newsletters?' . http_build_query([
    'type' => 'email',
    'lang' => 'en',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Yanit dile gore SEKIL DEGISTIRIR: dil verirseniz duz liste, vermezseniz dil basina ozet.
$one = Api::Tools()->GetBulkNewsletters([], ['lang' => 'en'])['data']['entries'];
$all = Api::Tools()->GetBulkNewsletters()['data']['by_lang'];

Bülten Listesini Yazma

put/api/v1/admin/tools/bulk/newsletters
Tools/SaveBulkNewsletters admin liste bütün yazılır

Bir dil ve kanal için bülten listesini baştan yazar.

Gövde 4
langstringzorunluHangi dilin listesi yazılacak.
typestringKanal. Varsayılan e-posta.
entriesstring[]Listenin tamamı. Gönderdiğiniz set yeni gerçektir.
contentstringAynı liste, satır satır metin olarak. Dizi yerine kullanılır.
Dönen alanlar data — 3
langstringYazılan dil.
typestringYazılan kanal.
countintListedeki kayıt sayısı.
Hatalar 2
lang_required422Dil verilmedi.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X PUT 'https://panel.ornek.com/api/v1/admin/tools/bulk/newsletters' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"lang":"en","type":"email","entries":["[email protected]","[email protected]"]}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/tools/bulk/newsletters', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    lang: 'en',
    type: 'email',
    entries: ['[email protected]', '[email protected]'],
  }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/tools/bulk/newsletters');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'lang'    => 'en',
        'type'    => 'email',
        'entries' => $entries,
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Tek adres EKLEMEK icin mevcut listeyi de gonderin: gonderdiginiz set eskisinin yerine gecer.
$entries   = Api::Tools()->GetBulkNewsletters([], ['lang' => 'en'])['data']['entries'];
$entries[] = '[email protected]';

Api::Tools()->SaveBulkNewsletters(['lang' => 'en', 'entries' => $entries]);

Tuzaklar

Kuyruğa alınan gönderim geri alınamaz

Gönderim ucunun geri alma yolu yoktur. Yanlış bir mesajı durdurmanın tek yolu, yanıttaki gönderim kimliğiyle bildirim kuyruğundaki bekleyen satırları bulup silmektir; o ana kadar gitmiş olanlar gitmiştir. Bu yüzden göndermeden önce saymak bir formalite değil, tek güvenliktir.

Test hedef kitleyi doğrulamaz

Test ucu süzgeçleri hiç okumaz: yalnız verdiğiniz adreslere ve departman çalışanlarına gönderir. Yani mesajın görünümünü doğrular, kimlere gideceğini değil. Hedef kitleyi doğrulamak sayma ucunun işidir; ikisini birlikte kullanın.

Toplu zarfta alıcılar birbirini görebilir

Zarf biçimini toplu seçmek mesajı tek bir gönderide birleştirir. Bu hızlıdır ama alıcı adresleri birbirine görünür hâle gelebilir; müşteri listesi göndermek bir veri sızıntısıdır. Emin değilseniz tekil biçimi seçin.

Bülten listesi bütün olarak yazılır

Yazma ucu birleştirme yapmaz: gönderdiğiniz set o dilin listesinin yerine geçer. Tek bir adres eklemek için önce mevcut listeyi okuyup üzerine eklemeniz gerekir, yoksa geri kalan aboneler silinir.

Bülten okuması dile göre şekil değiştirir

Dil verirseniz düz bir liste alırsınız; vermezseniz dil başına gruplanmış bir özet gelir. Tek bir şekil bekleyen kod, dil parametresi unutulduğunda boş liste okur ve bunu "abone yok" sanır.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.

Bize Ulaşın Destek Talebi Oluştur

Oturumunuzu açık tutmak, dil ve para birimi tercihinizi hatırlamak ve siteyi geliştirmek için çerez kullanıyoruz. Çerez Politikası