Kampanya Ekstraları | Connfig Docs

Test maili gönderme, kampanya şablonu yönetimi ve mail kuyruğu izleme için MCP araçları.

Genel Bakış

Bu sayfadaki araçlar kampanya iş akışını tamamlayan yardımcılardır: gönderim öncesi test maili, yeniden kullanılabilir şablonların yönetimi ve mail kuyruğunun izlenmesi. Tümü aboneliğinizde kampanya özelliğinin açık olmasını gerektirir.

Şablonlarda ve test mailinde merge tag'ler desteklenir ({{business_name}}, {{first_name}}, {{city}} vb. — tam liste ve {{key|yedek}} sözdizimi için Kampanya Yazma Araçları sayfasına bakın).

Araçlar

`send_test_mail`

Kampanya içeriğini önizlemek için tek bir adrese gerçek bir e-posta gönderir; konuya otomatik olarak [TEST] öneki eklenir. Mail kotasını tüketmez. Merge tag'ler örnek verilerle doldurularak gösterilir.

Önemli parametreler:

Parametre	Tip	Zorunlu	Açıklama
`workspace_id`	UUID	Evet	Çalışma alanı kimliği
`test_mail_to`	e-posta	Evet	Test mailinin gideceği adres
`body_html`	metin	Evet	HTML gövde; merge tag'ler örnek veriyle işlenir
`subject`	metin	Hayır	Konu satırı; merge tag destekler
`reply_to`	e-posta	Hayır	Yanıt adresi
`campaign_name`	metin	Hayır	İlişkili kampanya adı
`attachment_ids`	UUID dizisi	Hayır	Yüklenmiş ek dosya kimlikleri (en fazla 10)

Kullanıcı başına sıkı limit uygulanır: iki test maili arasında 60 saniye bekleme süresi ve günde (UTC) en fazla 20 test maili.

AI'a şöyle yazın: "Hazırladığımız kampanya taslağını önce cansncengz@gmail.com adresime test maili olarak gönder, merge tag'lerin nasıl göründüğüne bakayım."

`save_campaign_template`

Yeni bir kampanya şablonu oluşturur; hesapta aynı ada sahip bir şablon zaten varsa onu günceller (ada göre upsert). Yalnızca HTML gövde yazar — görsel editörle oluşturulmuş bir şablonun gövdesini değiştirmek için overwrite_visual_body: true gerekir (görsel tasarım kaybolur).

Önemli parametreler:

Parametre	Tip	Zorunlu	Açıklama
`workspace_id`	UUID	Evet	Çalışma alanı kimliği
`name`	metin	Evet	Şablon adı (1–200 karakter); upsert anahtarı
`subject`	metin	Hayır	Konu satırı; merge tag destekler
`reply_to`	e-posta	Hayır	Yanıt adresi
`body_html`	metin	Hayır	HTML gövde; merge tag destekler
`segments`	metin dizisi	Hayır	Varsayılan hedef segmentler (CRM etiketleri)
`overwrite_visual_body`	boolean	Hayır	Görsel editör gövdesinin HTML ile değiştirilmesini onaylar

AI'a şöyle yazın: "Bu e-posta metnini 'soguk-erisim-v2' adıyla şablon olarak kaydet, konu 'Merhaba {{first_name}}' olsun."

`update_campaign_template`

Bir şablonu kimliğine göre kısmi olarak günceller; yalnızca gönderilen alanlar değişir. Görsel editör gövdesini değiştirmek yine overwrite_visual_body: true gerektirir.

Önemli parametreler:

Parametre	Tip	Zorunlu	Açıklama
`template_id`	UUID	Evet	Şablon kimliği
`name`	metin	Hayır	Yeni ad
`subject`	metin	Hayır	Yeni konu; merge tag destekler
`reply_to`	e-posta	Hayır	Yeni yanıt adresi
`body_html`	metin	Hayır	Yeni HTML gövde; merge tag destekler
`segments`	metin dizisi	Hayır	Yeni varsayılan segmentler
`overwrite_visual_body`	boolean	Hayır	Görsel editör gövdesinin değiştirilmesini onaylar

En az bir güncellenecek alan gönderilmelidir.

AI'a şöyle yazın: "soguk-erisim-v2 şablonunun sadece konusunu 'Sizin için kısa bir öneri' olarak değiştir, gövdeye dokunma."

`delete_campaign_template`

Bir kampanya şablonunu kalıcı olarak siler (hard delete, geri alınamaz).

Önemli parametreler:

Parametre	Tip	Zorunlu	Açıklama
`template_id`	UUID	Evet	Silinecek şablonun kimliği

AI'a şöyle yazın: "Artık kullanmadığımız 'soguk-erisim-v1' şablonunu bul ve sil."

`get_mail_queue`

Bir çalışma alanının güncel mail kuyruğunu döndürür: takip edilen mesajlar (kuyrukta / gönderildi / hata) ile henüz gönderime alınmamış (bekleyen) kampanya alıcıları. Sonuçlar işletme adıyla zenginleştirilir; hata kodu ve yanıtlanma bilgisi de içerir.

Önemli parametreler:

Parametre	Tip	Zorunlu	Açıklama
`workspace_id`	UUID	Evet	Çalışma alanı kimliği
`limit`	sayı	Hayır	Maksimum satır (1–500, varsayılan 100)

AI'a şöyle yazın: "Mail kuyruğunda şu an kaç mesaj bekliyor ve hata alan gönderim var mı?"