Otomasyonlar

Otomasyonlar, abone olayları tarafından tetiklenen çok adımlı e-posta dizileri oluşturmanızı sağlar. Bir tetikleyici tanımlayın, adım dizisi oluşturun ve MailLand tetikleyici her çalıştığında akışı otomatik olarak yürütür.

Otomasyon TetikleyicileriBölüm bağlantısını kopyala

Her otomasyon tek bir tetikleyici ile başlar:

| Manual | 5 | API aracılığıyla manuel olarak tetiklenir |

Otomasyon DurumlarıBölüm bağlantısını kopyala

Adım TürleriBölüm bağlantısını kopyala

Her otomasyon sıralı bir adım dizisi içerir:

KişiselleştirmeBölüm bağlantısını kopyala

Otomasyon e-posta adımları, kayıtlı abonenin kendi kaydından alıcı başına değiştirilen {{variable}} birleştirme etiketlerini destekler.

<p>Hi {{firstName}}, here's what's new this month.</p>

Eski snake_case yazımları ({{first_name}}, {{last_name}}, {{full_name}}, {{subscriber_id}}) takma ad olarak çalışmaya devam eder.

Otomasyon OluşturmaBölüm bağlantısını kopyala

POST https://api.mail.land/v1/marketing/automations

{
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": 0,
  "mailingListId": "7h3n5k8w2q9m1t",
  "campaignId": null,
  "steps": [
    {
      "type": 0,
      "order": 1,
      "templateId": "2p9x4k7m3q8n1z",
      "subject": "Welcome to our newsletter!"
    },
    {
      "type": 1,
      "order": 2,
      "delayMinutes": 1440
    },
    {
      "type": 0,
      "order": 3,
      "templateId": "9k4p2x7m1q3n8z"
    }
  ]
}

Bir otomasyonda segmentId alanı yoktur: bu alan burada mevcut değildir (segmentler başka yerlerde, örneğin kampanyalarda kullanılır). SendEmail adımının içeriği templateId'den gelir, satır içi htmlContent/textContent/fromName/fromEmail'den değil.

Adım AlanlarıBölüm bağlantısını kopyala

SendEmail adımı (type: 0):

Bir adımda satır içi htmlContent/textContent/fromName/fromEmail/replyTo yoktur. Gönderen, çalışma alanı adıyla birlikte gösterilen noreply@<ilk tam doğrulanmış alan adı> olarak sabittir, adım başına yapılandırılamaz.

Wait adımı (type: 1):

Condition adımı (type: 2):

Bir Condition adımı bir kapıdır, bir dallanma değildir: doğrusal bir adım listesinin ikinci bir yolu yoktur. Doğru olarak değerlendirildiğinde kayıt bir sonraki adıma devam eder. Yanlış olarak değerlendirildiğinde kayıt orada biter (Completed) ve o abone için sonraki hiçbir adım çalışmaz.

Karşılaştırmalar, segmentlerin zaten sunduğu operatörlerle aynı, büyük/küçük harf duyarsız dize karşılaştırmalarıdır. Oluşturma/güncelleme sırasında conditionField bilinmiyorsa, conditionOperator yukarıdaki değerlerden biri değilse veya değere ihtiyaç duyan bir operatör için conditionValue eksikse 400 VALIDATION_FAILED döndürülür.

AddToList / RemoveFromList adımları (type: 3, 4):

UpdateSubscriber adımı (type: 5):

Webhook adımı (type: 6):

Webhook adımı istekleri, adımın alıcısına ait bir anahtarla imzalanır (X-MLND-Signature, müşteri webhook'ları gibi doğrulanır): her farklı adım URL'sinin kendi anahtarı vardır, bu yüzden hiçbir alıcı başka bir alıcı adına imza atamaz. Anahtarları GET /v1/marketing/automations/{id}/webhook-signing-secrets ile okuyun, POST /v1/marketing/automations/{id}/webhook-signing-secrets/regenerate ile yenileyin, bkz. Sürümleme. Yalnızca bir alıcıyı yenilemek için { "webhookUrl": "…" } gönderin.

curl -X POST https://api.mail.land/v1/marketing/automations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "trigger": 0,
    "mailingListId": "7h3n5k8w2q9m1t",
    "steps": [
      {
        "type": 0, "order": 1,
        "subject": "Welcome!",
        "templateId": "2p9x4k7m3q8n1z"
      },
      { "type": 1, "order": 2, "delayMinutes": 1440 },
      {
        "type": 0, "order": 3,
        "subject": "Getting started",
        "templateId": "9k4p2x7m1q3n8z"
      }
    ]
  }'

YanıtBölüm bağlantısını kopyala

{
  "id": "4f8k2m9p1q6z3s",
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": "subscriberJoins",
  "triggerName": "SubscriberJoins",
  "status": "draft",
  "statusName": "Draft",
  "mailingListId": "7h3n5k8w2q9m1t",
  "mailingListName": "Product Updates",
  "campaignId": null,
  "campaignName": null,
  "stepsCount": 3,
  "totalEnrolled": 0,
  "totalCompleted": 0,
  "activatedAt": null,
  "createdAt": "2026-02-17T12:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Bir otomasyonda segmentId/segmentName alanı yoktur ve kayıt sayaçları totalEnrolled/totalCompleted'dir (totalEnrollments/activeEnrollments/completedEnrollments değil). Detay yanıtı ayrıca steps (tam adım listesi), completionRate ve totalFailed ekler: tenant'ta şablonu olmayan (eksik veya sonradan silinmiş) bir SendEmail adımına ulaşan kayıtlar.

Otomasyonları ListelemeBölüm bağlantısını kopyala

GET https://api.mail.land/v1/marketing/automations

curl https://api.mail.land/v1/marketing/automations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Otomasyon Detaylarını GörüntülemeBölüm bağlantısını kopyala

GET https://api.mail.land/v1/marketing/automations/{id}

Tüm adımlar dahil tam otomasyonu döndürür:

curl https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "id": "4f8k2m9p1q6z3s",
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": "subscriberJoins",
  "triggerName": "SubscriberJoins",
  "status": "active",
  "statusName": "Active",
  "mailingListId": "7h3n5k8w2q9m1t",
  "mailingListName": "Product Updates",
  "campaignId": null,
  "campaignName": null,
  "stepsCount": 3,
  "totalEnrolled": 230,
  "totalCompleted": 200,
  "totalFailed": 4,
  "activatedAt": "2026-01-10T08:05:00Z",
  "steps": [
    {
      "order": 1,
      "type": "sendEmail",
      "typeName": "SendEmail",
      "delayMinutes": null,
      "templateId": "2p9x4k7m3q8n1z",
      "subject": "Welcome to our newsletter!",
      "settings": null
    },
    {
      "order": 2,
      "type": "wait",
      "typeName": "Wait",
      "delayMinutes": 1440,
      "templateId": null,
      "subject": null,
      "settings": null
    },
    {
      "order": 3,
      "type": "sendEmail",
      "typeName": "SendEmail",
      "delayMinutes": null,
      "templateId": "9k4p2x7m1q3n8z",
      "subject": "Getting started with MailLand",
      "settings": null
    }
  ],
  "completionRate": 86.96,
  "createdAt": "2026-01-10T08:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Otomasyon GüncellemeBölüm bağlantısını kopyala

PUT https://api.mail.land/v1/marketing/automations/{id}

Active dışındaki her durum güncellenebilir (yalnızca Draft/Paused değil). İstek gövdesi oluşturma isteği ile aynıdır.

curl -X PUT https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "trigger": 0,
    "mailingListId": "7h3n5k8w2q9m1t",
    "steps": [
      {
        "type": 0, "order": 1,
        "subject": "Welcome!",
        "templateId": "2p9x4k7m3q8n1z"
      },
      { "type": 1, "order": 2, "delayMinutes": 1440 },
      {
        "type": 0, "order": 3,
        "subject": "Getting started",
        "templateId": "9k4p2x7m1q3n8z"
      }
    ]
  }'

Otomasyon EtkinleştirmeBölüm bağlantısını kopyala

POST https://api.mail.land/v1/marketing/automations/{id}/activate

Otomasyonu Draft veya Paused durumundan Active durumuna geçirir. Etkinleştirildikten sonra, otomasyon tetikleyici çalıştığında aboneleri kaydetmeye başlar.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/activate \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Otomasyon DuraklatmaBölüm bağlantısını kopyala

POST https://api.mail.land/v1/marketing/automations/{id}/pause

Otomasyonu duraklatır. Yeni aboneler kaydedilmez ve dizide halihazırda bulunan aboneler ilerlemeyi durdurur, her kayıt mevcut adımında bekler. Otomasyonu yeniden etkinleştirmek, duraklatılan her kaydı kaldığı yerden devam ettirir ve duraklama sırasında vadesi gelen her şeyi teslim eder.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/pause \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Otomasyon ArşivlemeBölüm bağlantısını kopyala

POST https://api.mail.land/v1/marketing/automations/{id}/archive

Otomasyonu arşivler; bu işlem Active dahil herhangi bir durumdan yapılabilir. Arşivlenen otomasyonlar varsayılan liste görünümlerinden gizlenir.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/archive \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Otomasyon ÇoğaltmaBölüm bağlantısını kopyala

POST https://api.mail.land/v1/marketing/automations/{id}/duplicate?name=Copy%20of%20Welcome%20Series

Klonlanmış adımlar ve ayarlarla yeni bir Draft otomasyon oluşturur. name sorgu parametresi isteğe bağlıdır.

curl -X POST "https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/duplicate?name=Copy%20of%20Welcome%20Series" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Manuel TetiklemeBölüm bağlantısını kopyala

POST https://api.mail.land/v1/marketing/automations/{id}/trigger

{
  "subscriberIds": ["3m8k1p9x4q7n2z", "6q2n9k4x1p8m3z", "1x7m3q8k2n9p4z"]
}

Belirli aboneleri otomasyona manuel olarak kaydeder. Otomasyon Active durumunda olmalı ve tetikleyici türü Manual (5) olmalıdır.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/trigger \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"subscriberIds": ["3m8k1p9x4q7n2z", "6q2n9k4x1p8m3z", "1x7m3q8k2n9p4z"]}'

Kayıt TakibiBölüm bağlantısını kopyala

Her abonenin otomasyon boyunca ilerlemesi bir kayıt olarak takip edilir:

Cancelled kayıt durumu yoktur. Otomasyon detay yanıtı toplam kayıt sayılarını totalEnrolled ve totalCompleted olarak içerir (totalEnrollments/activeEnrollments/completedEnrollments/failedEnrollments değil).

Otomasyon SilmeBölüm bağlantısını kopyala

DELETE https://api.mail.land/v1/marketing/automations/{id}

Otomasyonu, adımlarını ve kayıt verilerini kalıcı olarak siler.

curl -X DELETE https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Hata YanıtlarıBölüm bağlantısını kopyala

Otomasyon uç noktaları hiçbir zaman 422 döndürmez.

Sonraki AdımlarBölüm bağlantısını kopyala

• Kampanyalar: tek seferlik kampanyalar gönderin
• Aboneler: otomasyonların hedeflediği kişileri yönetin
• Listeler: tetikleyiciler için aboneleri listelere düzenleyin