Bilgi bankası

Zinn® Campaigns API ve MCP: geliştirici kılavuzu

Oturum açma, izinler, örnekler, sınırlar, hatalar, webhook'lar ve bir yapay zekâ asistanının MCP üzerinden hangilerini çalıştırabileceği bilgisiyle birlikte her bir Zinn® Campaigns API işlemi.

Vikingimiz Zinn®, biri açık olan makaleler dizininin yanında kontrol listesini okuyor.

Kontrol panelindeki Zinn® Campaigns üzerinden yapabileceğiniz her şeyi API aracılığıyla ve çoğunu MCP üzerinden hesabınıza bağlı bir yapay zekâ asistanından da yapabilirsiniz. Bu rehber; oturum açmayı, izinleri, her iki yönteme ait uygulamalı bir örneği, sınırları, hataları ve 89 Campaigns işleminin her birini kapsamaktadır. Aşağıdaki işlem listesi API spesifikasyonumuzdan oluşturulmuştur, dolayısıyla her zaman API'nin yaptıklarıyla eşleşir. Her işlemin her alanı, zinndigital.com/developers/api/zinn-campaigns adresindeki API başvuru kılavuzunda yer almaktadır.

Oturum açma

  • API anahtarları. Kontrol panelinde Ayarlar → API anahtarları bölümünden bir anahtar oluşturun ve bunu Authorization: Bearer zdk_live_… olarak gönderin (bir zdk_test_… anahtarı korumalı alan modunda çalışır). Anahtara yalnızca ihtiyaç duyduğu Campaigns izinlerini verin, fazlasını değil.
  • Yapay zekâ asistanları (MCP). Claude, ChatGPT, Cursor veya herhangi bir MCP istemcisini uygulamadan giriş yaparak ya da bir bağlantı jetonuyla (zmcp_live_…) https://api.zinndigital.com/v1/mcp adresine bağlayın. Bkz. Claude, Cursor veya ChatGPT'yi hesabınıza bağlama. Onay ekranında Zinn® Campaigns izinlerini işaretleyin.
  • İzinler. email_marketing.view kampanyaları, listeleri, kişileri, formları, göndericileri, SMS ayarlarını ve raporları okur; email_marketing.manage bunları oluşturur ve değiştirir. Kendi e-posta servisiniz üzerinden gönderdiğiniz kampanyalar campaigns.view ve campaigns.manage kullanır.
  • Bayiler. Müşteri kuruluşlarınızdan biri adına işlem yapmak için org_id değerini iletin. Anahtarınız veya bağlantınız yalnızca tek bir kuruluşa ulaştığında bu değeri boş bırakın.

Örnek: API ile taslak kampanya oluşturma

curl -X POST https://api.zinndigital.com/v1/email-marketing/campaigns \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring sale",
  "subject": "Our spring sale starts today",
  "list_id": "<list id>",
  "sender_id": "<sender id>",
  "template": "basic"
}'

Yanıt, taslak ile birlikte 201 olur. Taslağı POST /v1/email-marketing/campaigns/{campaign_id}/test ile test edin, GET /v1/email-marketing/campaigns/{campaign_id}/lint ile kontrol edin ve POST /v1/email-marketing/campaigns/{campaign_id}/send ile gönderin.

Örnek: Bir yapay zekâ asistanından aynı taslak

Asistanınıza basit sözcüklerle örneğin "Konusu 'Bahar indirimimiz bugün başlıyor' olan, Bahar indirimi adlı bir Zinn® Campaigns e-postası taslağı oluştur" deyin. Arka planda işlemi api_operations_search ile bulur, parametrelerini api_operation_get ile okur ve api_operation_call ile çalıştırır:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "api_operation_call",
    "arguments": {
      "operation_id": "createEmailMarketingCampaign",
      "confirm": true,
      "body": {
        "name": "Spring sale",
        "subject": "Our spring sale starts today"
      }
    }
  }
}

Bir asistanın yapmayacağı şeyler. Alıcılarınıza gönderim yapan ya da para veya kullanım hakkı harcayan hiçbir işlem — bir kampanya göndermek, SMS veya WhatsApp mesajları göndermek, yapay zekâ kredileriyle yazmak, US mesajlaşması için kaydolmak — bir asistana izin verilmez; böylece yanlış anlaşılan bir talimat asla müşterilerinize ulaşamaz. Asistan taslağı hazırlar; siz kontrol panelinde Gönder düğmesine basarsınız veya API'yi kendiniz çağırırsınız. SMTP parolası gibi gizli bilgiler de asla bir asistan üzerinden iletilmez: bunları kontrol panelinde giriniz.

Sınırlar

  • Her bir kişi veya API anahtarı için dakikada 1.200 istek ve her bir kuruluş için dakikada 6.000 istek. İkisinden daha kısıtlayıcı olanı geçerlidir.
  • Her bir MCP bağlantısı için dakikada 600 istek.
  • Sınır aşıldığında yanıt, bir Retry-After başlığı içeren 429 kodudur: bu kadar saniye bekleyiniz.
  • Liste üyeleri ekleme işlemi istek başına en fazla 1.000 adres alır; planınızın kişi ve e-posta hakları, API aracılığıyla yaptığınız her şey için geçerlidir.

Hatalar

Her hata aynı yapıya sahiptir:

{"error": {"code": "UNPROCESSABLE_ENTITY", "message": "…", "details": [{"field": "subject", "code": "REQUIRED", "message": "…"}], "request_id": "…"}}

code, aynı sorun için asla değişmez, bu nedenle message yerine bunu test edin. Destek ekibiyle iletişime geçtiğinizde request_id değerini belirtin. Karşılaşacağınız yanıtlar: 401 UNAUTHORIZED, 403 FORBIDDEN, 404 NOT_FOUND, 409 CONFLICT, 422 UNPROCESSABLE_ENTITY, 429 TOO_MANY_REQUESTS. 403, anahtarın veya bağlantının aşağıdaki listede belirtilen bir izne sahip olmadığı anlamına gelir; 404 ayrıca göremediğiniz bir kuruluştaki bir durumu da kapsar; 422, details içinde her bir hatalı alanı listeler; bir 429 sonrasında Retry-After üstbilgisindeki saniye sayısı kadar bekleyin.

Web kancaları

Teslimat sonuçları, e-postanızı gönderen sağlayıcıdan Zinn® Campaigns içine gelir:

  • Kendi sağlayıcınızla (örneğin Resend), web kancası imzalama gizli anahtarını kontrol panelindeki gönderme bağlantısında (Kampanyalar → Gönderme) saklayın. Bir webhook_url alırsınız; sağlayıcının teslim edildi, iletilemedi ve şikayet edildi etkinliklerini buraya yönlendirin. Bir iletilememe veya spam şikayeti, adresi gelecekteki gönderimlerden derhal kaldırır.
  • Zinn® gönderimiyle yapılandırılacak hiçbir şey yoktur.

Sonuçları rapor işlemleriyle (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport) okuyun.

Her Kampanya işlemi

Genel Bakış

  • GET /v1/email-marketing — Tek bir kuruluş için Zinn® Campaigns genel bakışı. getEmailMarketingOverview işlemi. Denetlenen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.

E-posta kampanyaları

  • GET /v1/email-marketing/campaigns — E-posta kampanyaları, en yeniden eskiye, tek bir keyset sayfası. listEmailMarketingCampaigns işlemi. Denetlenen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP üzerinden.
  • POST /v1/email-marketing/campaigns — Taslak bir e-posta kampanyası oluşturun. createEmailMarketingCampaign işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP üzerinden.
  • GET /v1/email-marketing/campaigns/{campaign_id} — Tek bir e-posta kampanyası. getEmailMarketingCampaign işlemi. Denetlenen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP üzerinden.
  • PATCH /v1/email-marketing/campaigns/{campaign_id} — Bir taslağı (veya taslağa geri dönen reddedilmiş bir kampanyayı) düzenleyin. updateEmailMarketingCampaign işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP üzerinden.
  • GET /v1/email-marketing/campaigns/{campaign_id}/lint — Gönderilmeden önce bir kampanyanın metnini teslim edilebilirlik sorunlarına karşı denetleyin. lintEmailMarketingCampaign işlemi. Denetlenen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP üzerinden.
  • GET /v1/email-marketing/campaigns/{campaign_id}/report — Bir kampanyanın sayısal verileri. getEmailMarketingCampaignReport işlemi. Denetlenen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP üzerinden.
  • POST /v1/email-marketing/campaigns/{campaign_id}/send — Bir kampanyayı listesine göndermeye başlayın. İşlem: sendEmailMarketingCampaign. Denetlenen izinler: email_marketing.manage, email_marketing.view. Yapay zekâ asistanından: Yalnızca API ve kontrol paneli: Para veya kullanım kotası harcar, bu nedenle bir kişinin basması gerekir (gerçek alıcılara gönderir ve kullanım kotasını harcar).
  • POST /v1/email-marketing/campaigns/{campaign_id}/test — Şimdi kuruluşun bir üyesine bir test kopyası gönderin. İşlem: testEmailMarketingCampaign. Denetlenen izinler: email_marketing.manage, email_marketing.view. Yapay zekâ asistanından: Evet, MCP aracılığıyla.
  • POST /v1/email-marketing/campaigns/{campaign_id}/translate — Bir kampanyayı eksik veya güncel olmayan her kişi diline çevirin. İşlem: translateEmailMarketingCampaign. Denetlenen izinler: email_marketing.manage, email_marketing.view. Yapay zekâ asistanından: Evet, MCP aracılığıyla.
  • GET /v1/email-marketing/campaigns/{campaign_id}/translations — Bir kampanya listesindeki her kişi dili ve çevirisinin güncel olup olmadığı. İşlem: listEmailMarketingCampaignTranslations. Denetlenen izinler: email_marketing.view. Yapay zekâ asistanından: Evet, MCP aracılığıyla.

Yapay Zekâ ile Yazma

  • POST /v1/email-marketing/ai/write — Zinn® AI ile kısa bir özatten taslak kampanya e-postası yazın. İşlem writeEmailMarketingCampaignWithAi. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: Yalnızca API ve kontrol paneli: Para veya kullanım hakkı harcar, bu nedenle bir kişi basmalıdır (yapay zekâ ile yazma yapay zekâ kredisi harcar).

Marka kiti

  • GET /v1/email-marketing/brand-kit — Kuruluşun marka kiti (ad, logo, renkler, yazı tipi, ses tonu). İşlem getEmailMarketingBrandKit. Kontrol edilen izinler: email_marketing.view. Bir yapay zekâ asistanından: Evet, MCP aracılığıyla.
  • PUT /v1/email-marketing/brand-kit — Marka kitini düzenleyin. İşlem updateEmailMarketingBrandKit. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: Evet, MCP aracılığıyla.
  • POST /v1/email-marketing/brand-kit/read — Kuruluşun web sitesinden marka kitini okuyun. İşlem readEmailMarketingBrandKit. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: Evet, MCP aracılığıyla.

Kişiler ve tek seferlik iletiler

  • GET /v1/email-marketing/contacts — Kuruluşun kişileri, her seferinde bir keyset sayfası. listEmailMarketingContacts işlemi. Denetlenen izinler: email_marketing.view. Yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/contacts/{contact_id}/messages — Zinn® kredi bakiyesinden ödenerek tek bir kişiye bir SMS gönderin. sendEmailMarketingMessage işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Yapay zekâ asistanından: yalnızca API ve gösterge paneli: para veya kullanım hakkı harcar, bu nedenle bir kişi basmalıdır (bir kişiye tek seferlik mesaj gönderilmesi kullanım hakkı harcar).
  • GET /v1/email-marketing/messages — Kuruluşun gönderdiği SMS ve WhatsApp mesajları, en yeniden en eskiye, bir keyset sayfası. listEmailMarketingMessages işlemi. Denetlenen izinler: email_marketing.view. Yapay zekâ asistanından: evet, MCP aracılığıyla.

Listeler

  • GET /v1/email-marketing/lists — Abone olan / abonelikten çıkan sayılarıyla birlikte kuruluşun e-posta listeleri. İşlem listEmailMarketingLists. Kontrol edilen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/lists — Bir e-posta listesi oluşturun (veya bu ada sahip olanı döndürün). İşlem createEmailMarketingList. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/lists/{list_id}/members — Bir listeye e-posta adresine göre kişiler ekleyin (istek başına en fazla 1.000). İşlem addEmailMarketingListMembers. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.

İçe Aktarmalar

  • GET /v1/email-marketing/imports — Geçmiş kişi içe aktarmaları, en yeniden eskiye, her seferinde bir anahtar kümesi sayfası. İşlem listEmailMarketingImports. Kontrol edilen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/imports — Rıza onayı ile birlikte bir grup kişiyi içe aktarın. İşlem createEmailMarketingImport. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.

Kayıt formları

  • GET /v1/email-marketing/forms — Kayıt formları (çift onaylı), önce en yeniler, tek anahtar kümesi sayfası. İşlem: listEmailMarketingForms. Denetlenen izinler: email_marketing.view. Yapay zeka asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/forms — Onaylanan kişileri tek bir listeye ekleyen bir kayıt formu oluşturun. İşlem: createEmailMarketingForm. Denetlenen izinler: email_marketing.manage, email_marketing.view. Yapay zeka asistanından: evet, MCP aracılığıyla.
  • DELETE /v1/email-marketing/forms/{form_id} — Bir kayıt formunu silin (önceden onaylanmış kişiler listede kalır). İşlem: deleteEmailMarketingForm. Denetlenen izinler: email_marketing.manage, email_marketing.view. Yapay zeka asistanından: evet, MCP aracılığıyla.
  • PATCH /v1/email-marketing/forms/{form_id} — Bir kayıt formunu değiştirin (metin, liste, yönlendirme, açık veya kapalı). İşlem: updateEmailMarketingForm. Denetlenen izinler: email_marketing.manage, email_marketing.view. Yapay zeka asistanından: evet, MCP aracılığıyla.

Gönderim bağlantıları

  • GET /v1/email-marketing/senders — Kuruluşun gönderim bağlantıları. listEmailMarketingSenders işlemi. Denetlenen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/senders — Bir kampanya göndericisi bağlayın (Zinn® gönderimi veya müşterinin kendi SMTP sunucusu). createEmailMarketingSender işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: yalnızca API ve gösterge paneli: bir yapay zekâ modeline asla ulaşmaması gereken bir gizli dizi taşır (gövde, SMTP parolasıdır).
  • DELETE /v1/email-marketing/senders/{sender_id} — Bir gönderim bağlantısını ve saklanan parolasını kaldırın. deleteEmailMarketingSender işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/senders/{sender_id}/verify — Hiçbir şey göndermeden bir gönderim bağlantısının çalıştığını kanıtlayın. verifyEmailMarketingSender işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • PUT /v1/email-marketing/senders/{sender_id}/webhook — Bu bağlantı için e-posta sağlayıcınızın webhook imzalama gizli dizisini saklayın. setEmailMarketingSenderWebhook işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: sizin tarafınızdan değil, başka bir sistem (bir sağlayıcı veya ziyaretçi) tarafından çağrılır (bir sağlayıcının webhook gizli dizisini saklar).

SMS ve WhatsApp

  • GET /v1/email-marketing/sms — SMS ekranının ihtiyaç duyduğu bilgiler — açık mı?, duraklatıldı mı?, kredi bakiyesi ve fiyatlar. getEmailMarketingSms işlemi. Kontrol edilen izinler: email_marketing.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • GET /v1/email-marketing/sms/campaigns — Toplu SMS kampanyaları, en yeniden en eskiye, tek bir keyset sayfası. listSmsMarketingCampaigns işlemi. Kontrol edilen izinler: email_marketing.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/sms/campaigns — Bir listeye taslak SMS oluşturun. createSmsMarketingCampaign işlemi. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • GET /v1/email-marketing/sms/campaigns/{campaign_id} — Tek bir toplu SMS kampanyası. getSmsMarketingCampaign işlemi. Kontrol edilen izinler: email_marketing.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — Bir taslağı (veya taslağa geri dönen reddedilmiş bir kampanyayı) düzenleyin. updateSmsMarketingCampaign işlemi. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — Bir toplu SMS kampanyasının sayısal verileri. getSmsMarketingCampaignReport işlemi. Kontrol edilen izinler: email_marketing.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — Listesinde SMS almayı kabul eden herkese SMS göndermeye başlayın veya kredi yetersizliği nedeniyle duraklatılmış olanı devam ettirin. İşlem sendSmsMarketingCampaign. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: Yalnızca API ve kontrol paneli: Para veya kullanım hakkı harcar, bu nedenle bir kişi basmalıdır (ücretli SMS/WhatsApp mesajları gönderir).
  • GET /v1/email-marketing/sms/registrations/us — Bu kuruluşun US 10DLC kaydı ve maliyeti. İşlem getEmailMarketingUsRegistration. Kontrol edilen izinler: email_marketing.view. Bir yapay zekâ asistanından: Evet, MCP aracılığıyla.
  • POST /v1/email-marketing/sms/registrations/us — Bu kuruluşun markasını ve kampanyasını US 10DLC için gönderin (gönderim sırasında ücretlendirilir). İşlem submitEmailMarketingUsRegistration. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: Yalnızca API ve kontrol paneli: Para veya kullanım hakkı harcar, bu nedenle bir kişi basmalıdır (US 10DLC kaydı operatör ücretlerine tabidir).

Kendi e-posta servisiniz üzerinden kampanyalar (şablonlar, segmentler, engellemeler)

  • GET /v1/campaigns — Kuruluşun kampanyaları. İşlem listCampaigns. Bir yapay zekâ asistanından: Evet, MCP aracılığıyla.
  • POST /v1/campaigns — Bir şablondan ve hedef kitleden bir kampanya oluşturun. İşlem createCampaign. Bir yapay zekâ asistanından: Evet, MCP aracılığıyla.
  • DELETE /v1/campaigns/esp — Sağlayıcı hesabının bağlantısını kesin ve kayıtlı anahtarını kaldırın. İşlem disconnectEsp. Yapay zeka asistanından: Yalnızca API ve kontrol paneli: Bir yapay zeka modeline asla ulaşmaması gereken bir gizli dizi taşır (kayıtlı ESP anahtarını imha eder).
  • GET /v1/campaigns/esp — Kuruluşun kendi e-posta sağlayıcı hesabı. İşlem getEspConnection. Yapay zeka asistanından: Evet, MCP aracılığıyla.
  • POST /v1/campaigns/esp — Bir e-posta sağlayıcı hesabı bağlayın. İşlem connectEsp. Yapay zeka asistanından: Yalnızca API ve kontrol paneli: Bir yapay zeka modeline asla ulaşmaması gereken bir gizli dizi taşır (gövde, ESP API anahtarıdır).
  • POST /v1/campaigns/esp/verify — Sağlayıcı hesabının çalıştığını doğrulayın ve doğrulanmış alan adlarını okuyun. İşlem verifyEspConnection. Yapay zeka asistanından: Yalnızca API ve kontrol paneli: Bir yapay zeka modeline asla ulaşmaması gereken bir gizli dizi taşır (kayıtlı bir ESP anahtarını yeniden kontrol eder).
  • POST /v1/campaigns/preview — Örnek değerlerle bir şablonu Render edin. İşlem previewCampaignTemplate. Yapay zeka asistanından: Evet, MCP aracılığıyla.
  • GET /v1/campaigns/segments — Kaydedilmiş kitle segmentleriniz. İşlem listCampaignSegments. Denetlenen izinler: campaigns.view. Yapay zeka asistanından: Evet, MCP aracılığıyla.
  • POST /v1/campaigns/segments — Yeni bir kitle segmenti kaydedin. İşlem createCampaignSegment. Denetlenen izinler: campaigns.manage. Yapay zeka asistanından: Evet, MCP aracılığıyla.
  • GET /v1/campaigns/segments/fields — Filtre sözlüğü, değer listeleri ve sihirli etiketler. İşlem: getCampaignSegmentFields. Kontrol edilen izinler: campaigns.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • POST /v1/campaigns/segments/preview — Bunun kaç kişiye ulaştığı, kimler olduğu ve kimleri hariç tuttuğu. İşlem: previewCampaignSegment. Kontrol edilen izinler: campaigns.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • DELETE /v1/campaigns/segments/{segmentId} — Bir segmenti arşivleyin. İşlem: archiveCampaignSegment. Kontrol edilen izinler: campaigns.manage. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • GET /v1/campaigns/segments/{segmentId} — Kaydedilmiş tek bir segment. İşlem: getCampaignSegment. Kontrol edilen izinler: campaigns.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • PATCH /v1/campaigns/segments/{segmentId} — Bir segmenti yeniden adlandırın veya filtrelerini değiştirin. İşlem: updateCampaignSegment. Kontrol edilen izinler: campaigns.manage. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • GET /v1/campaigns/suppressions — Pazarlama iletileri almaması gereken adresler. İşlem: listCampaignSuppressions. Kontrol edilen izinler: campaigns.view. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • POST /v1/campaigns/suppressions — Gizleme listesine bir adres ekleyin. İşlem: createCampaignSuppression. Kontrol edilen izinler: campaigns.manage. Bir yapay zeka asistanından: evet, MCP aracılığıyla.
  • GET /v1/campaigns/tags — Kampanya düzenleyicisinin sunduğu sihirli etiket paleti. listCampaignTags işlemi. Yapay zekâ asistanından: evet, MCP aracılığıyla.
  • GET /v1/campaigns/templates — Kuruluşun kampanya şablonları. listCampaignTemplates işlemi. Yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/campaigns/templates — Bir kampanya şablonu oluşturun. createCampaignTemplate işlemi. Yapay zekâ asistanından: evet, MCP aracılığıyla.
  • DELETE /v1/campaigns/templates/{templateId} — Bir şablonu arşivleyin ve çeviri kaynaklarını devre dışı bırakın. archiveCampaignTemplate işlemi. Yapay zekâ asistanından: evet, MCP aracılığıyla.
  • GET /v1/campaigns/templates/{templateId} — Tek bir kampanya şablonu. getCampaignTemplate işlemi. Yapay zekâ asistanından: evet, MCP aracılığıyla.
  • PUT /v1/campaigns/templates/{templateId} — Bir kampanya şablonunu düzenleyin. updateCampaignTemplate işlemi. Yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/campaigns/unsubscribe — Bir pazarlama listesinden ayrılın. Hesap gerekmez. unsubscribeFromCampaigns işlemi. Yapay zekâ asistanından: Yalnızca API ve kontrol paneli: asla bir yapay zekâ modeline ulaşmaması gereken bir gizli anahtar taşır (alıcının imzalı abonelikten çıkma belirtecini alır).
  • DELETE /v1/campaigns/{campaignId} — Bir kampanyayı silin ve teslimat satırlarını kullanımdan kaldırın. deleteCampaign işlemi. Yapay zekâ asistanından: Yalnızca API ve kontrol paneli: yapay zekâ bağlantılarına sunulmayan bir izin gerektirir (bir ESP kampanyasını silmek campaigns.send gerektirir).
  • GET /v1/campaigns/{campaignId} — Bir kampanya ve teslimat raporu. getCampaign işlemi. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/campaigns/{campaignId}/control — Devam eden bir gönderimi duraklatın, devam ettirin veya iptal edin. controlCampaign işlemi. Bir yapay zekâ asistanından: yalnızca API ve gösterge paneli: para veya kota harcar, bu nedenle bir kişi basmalıdır (canlı bir gönderimi duraklatır/devam ettirir).
  • POST /v1/campaigns/{campaignId}/send — Kalıcı gönderimi başlatın. sendCampaign işlemi. Bir yapay zekâ asistanından: yalnızca API ve gösterge paneli: para veya kota harcar, bu nedenle bir kişi basmalıdır (gerçek alıcılara bir ESP kampanyası gönderir).
  • POST /v1/campaigns/{campaignId}/test — Kampanyanın gerçekte kullanacağı kanal üzerinden bir gerçek mesaj gönderin. testSendCampaign işlemi. Bir yapay zekâ asistanından: yalnızca API ve gösterge paneli: yapay zekâ bağlantılarına sunulmayan bir izin gerektirir (bir ESP test gönderimi campaigns.send iznine ihtiyaç duyar).

Herkese açık sayfalar ve gelen web kancaları

  • GET /v1/public/email-marketing/c/{token} — Tıklama sayacı. Alıcı başına bir tıklama kaydeder ve orijinal bağlantıya yönlendirir. emailMarketingClick işlemi. Bir yapay zekâ asistanından: alıcılarınızın bir e-postadan açtığı sayfa (tıklama izleme yönlendirmesi).
  • GET /v1/public/email-marketing/f/{public_id} — Bir kayıt formunun barındırılan sayfası (giriş gerekmez). emailMarketingFormPage işlemi. Bir yapay zekâ asistanından: alıcılarınızın bir e-postadan açtığı sayfa (herkese açık kayıt formu sayfası).
  • POST /v1/public/email-marketing/f/{public_id} — Bir kayıt formu gönderin (barındırılan sayfa, yerleştirme veya JSON). İşlem emailMarketingFormSubmit. Bir yapay zeka asistanından: sizin tarafınızdan değil, başka bir sistem tarafından çağrılır (bir sağlayıcı veya bir ziyaretçi) (bir ziyaretçi kayıt formu gönderir).
  • GET /v1/public/email-marketing/fc — Çift onaylı (double opt-in) doğrulama sayfası (giriş gerekmez). İşlem emailMarketingFormConfirmPage. Bir yapay zeka asistanından: alıcılarınızın bir e-postadan açtığı bir sayfa (çift onaylı doğrulama sayfası).
  • POST /v1/public/email-marketing/fc — Bir kaydı onaylayın (kişiyi onay kaydıyla birlikte listeye ekler). İşlem emailMarketingFormConfirm. Bir yapay zeka asistanından: sizin tarafınızdan değil, başka bir sistem tarafından çağrılır (bir sağlayıcı veya bir ziyaretçi) (bir ziyaretçi çift onayı doğrular).
  • GET /v1/public/email-marketing/o/{token} — Açılma izleme görseli (1x1 GIF). Alıcı başına bir açılma sayar. İşlem emailMarketingOpenPixel. Bir yapay zeka asistanından: alıcılarınızın bir e-postadan açtığı bir sayfa (açılma izleme pikseli).
  • GET /v1/public/email-marketing/u/{token} — Alt bilgi abonelikten çıkma bağlantısı (giriş gerekmez). İşlem emailMarketingUnsubscribePage. Bir yapay zeka asistanından: alıcılarınızın bir e-postadan açtığı bir sayfa (abonelikten çıkma sayfası).
  • POST /v1/public/email-marketing/u/{token} — RFC 8058 tek tıkla abonelikten çıkma (ve sayfanın "her şeyi durdur" butonu). İşlem emailMarketingUnsubscribeOneClick. Bir yapay zekâ asistanından: sizin tarafınızdan değil, başka bir sistem (bir sağlayıcı veya bir ziyaretçi) tarafından çağrılır (RFC 8058 tek tıkla abonelikten çıkma).
  • GET /v1/public/email-marketing/warmup-u/{token} — Pazarlama havuzu ısınma e-postasının abonelikten çıkma bağlantısı (giriş gerekmez). İşlem emailMarketingWarmupUnsubscribePage. Bir yapay zekâ asistanından: alıcılarınızın bir e-postadan açtığı sayfa (ısınma abonelikten çıkma sayfası).
  • POST /v1/public/email-marketing/warmup-u/{token} — Isınma e-postasından RFC 8058 tek tıkla abonelikten çıkma. İşlem emailMarketingWarmupUnsubscribeOneClick. Bir yapay zekâ asistanından: sizin tarafınızdan değil, başka bir sistem (bir sağlayıcı veya bir ziyaretçi) tarafından çağrılır (ısınma için tek tıkla abonelikten çıkma).
  • POST /v1/webhooks/campaign-events — E-posta sağlayıcısından gelen imzalı teslimat olayını içeri aktarın. İşlem receiveCampaignDeliveryWebhook. Bir yapay zekâ asistanından: sizin tarafınızdan değil, başka bir sistem (bir sağlayıcı veya bir ziyaretçi) tarafından çağrılır (imzalı ESP teslimat web kancası).
  • POST /v1/webhooks/campaigns/telnyx — SMS sağlayıcımızdan gelen SMS yanıtları (STOP / START). İşlem receiveCampaignsTelnyxInbound. Bir yapay zekâ asistanından: sizin tarafınızdan değil, başka bir sistem (bir sağlayıcı veya bir ziyaretçi) tarafından çağrılır (imzalı Telnyx gelen web kancası).
  • POST /v1/webhooks/email-marketing/{connection_id} — Bir gönderim bağlantısı için müşterinin kendi e-posta sağlayıcısının teslimat etkinlikleri. İşlem receiveEmailMarketingProviderWebhook. Bir yapay zekâ asistanından: sizin tarafınızdan değil, başka bir sistem (sağlayıcı veya ziyaretçi) tarafından çağrılır (imzalı gönderici-sağlayıcı web kancası).

Akışlar

  • GET /v1/email-marketing/flows — E-posta akışları (hoş geldiniz, damlama, yıllık bir tarih), bir keyset sayfası. İşlem listEmailMarketingFlows. Kontrol edilen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/flows — Bir akış oluşturun (taslak olarak başlar). İşlem createEmailMarketingFlow. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • DELETE /v1/email-marketing/flows/{flow_id} — Bir akışı ve kayıtlarını silin (gönderilen çalıştırmaları kampanya olarak kalır). İşlem deleteEmailMarketingFlow. Kontrol edilen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • GET /v1/email-marketing/flows/{flow_id} — Adımları ve raporuyla (kayıtlı, devam eden, adım başına çalıştırmalar ve alıcılar) tek bir akış. İşlem getEmailMarketingFlow. Kontrol edilen izinler: email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • PATCH /v1/email-marketing/flows/{flow_id} — Bir akışı değiştirin; steps belirtildiğinde tüm dizinin yerini alır. updateEmailMarketingFlow işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/flows/{flow_id}/activate — Bir akışı etkinleştirin; yalnızca şu andan itibaren listeye katılan kişiler dahil edilir. activateEmailMarketingFlow işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.
  • POST /v1/email-marketing/flows/{flow_id}/pause — Bir akışı duraklatın; vadesi gelen adımlar bekler ve akış yeniden etkinleştirilene kadar yeni kimseye e-posta gönderilmez. pauseEmailMarketingFlow işlemi. Denetlenen izinler: email_marketing.manage, email_marketing.view. Bir yapay zekâ asistanından: evet, MCP aracılığıyla.

Blogdan son yazılar

Barındırma, SEO ve sitelerin geniş ölçekte yönetilmesi hakkında yazdıklarımız.

Barındırma Katmanından SEO ve Bağlantı İnşası: 2026 Yılı Operatörünün Bakış Açısı

2026'da barındırmanın indekslemeyi ve bağlantı değerini (link equity) nasıl şekillendirdiği: sayfaları dizinde tutmak, üzerlerinde geliştirme yapmadan önce eski alan adlarını incelemek, ayak izi (footprint) bırakmadan bağlantı inşa etmek ve altyapının SEO için neler yapabileceği ve yapamayacağı konusunda dürüst bir değerlendirme.

Gönderiyi oku →

WordPress'i Hızlı ve Güvenli Hale Getirme: Performans ve Eklenti Kontrol Listesi

Hızlı ve güvenli bir WordPress için pratik bir kontrol listesi: sunucu düzeyinde önbelleğe alma, site başına bir nesne önbelleği, çalıştırılmaya değer az sayıda eklenti, teknoloji yığınını güncel tutma ve asla önbelleğe almamanız gereken WooCommerce sayfaları.

Gönderiyi oku →

2026'da Yönetilen Web Barındırma Nasıl Seçilir: Alıcı Kılavuzu

İyi bir yönetilen barındırmayı kontrol paneline sahip ucuz bir sunucudan gerçekte neyin ayırdığı — taşımalar, yedeklemeler, izolasyon, gerçek önbelleğe alma ve dürüst ölçeklendirme — ve taahhütte bulunmadan önce bunu nasıl değerlendireceğiniz.

Gönderiyi oku →

Blogu okuyun →

Hâlâ sorun mu yaşıyorsunuz?

Her pakette destek dahildir, destek ekibimiz günde 24 saat hizmet vermektedir ve 58 dilimizden herhangi biriyle bize yazabilirsiniz; size kendi dilinizde yanıt veriyoruz.

Destek ekibiyle iletişime geçin Tüm makaleler