Kampanya Yazma Araçları
Kampanya oluşturup gönderime alan ve çalışan kampanyaları duraklatan / devam ettiren / iptal eden MCP araçları.
Genel Bakış
Bu sayfadaki araçlar gerçek e-posta gönderimi başlatır veya çalışan kampanyaların durumunu değiştirir. Her ikisi de aboneliğinizde kampanya özelliğinin açık olmasını gerektirir.
Gerçek e-posta gönderilir
create_and_send_campaign gerçek alıcılara e-posta gönderir ve aylık mail kotanızı tüketir. AI asistanınız çağrıdan önce segmenti ve içeriği sizinle teyit etmelidir — çağrı yapıldıktan sonra kampanya kuyruğa alınır.
Merge Tag'ler (Kişiselleştirme)
Konu ve gövdede alıcı bazında dolan merge tag'ler kullanabilirsiniz: {{business_name}}, {{city}}, {{state}}, {{address}}, {{category}}, {{phone}}, {{website}}, {{rating}}, {{reviews_count}}, {{contact_name}}, {{first_name}}, {{last_name}}, {{job_title}}, {{company_size}}, {{industry}}, {{email}}.
Boş değerler için {{key|yedek metin}} biçimini kullanın; bilinmeyen veya boş anahtarlar yedek metinle ya da boş dizeyle değiştirilir — ham süslü parantezler alıcıya asla ulaşmaz.
Araçlar
create_and_send_campaign
CRM segmentlerini (etiketleri) hedefleyen bir e-posta kampanyası oluşturur ve gönderim kuyruğuna alır. Alıcılar, domain başına warmup limitlerine göre günlere yayılarak gönderilir. body_html veya template_id parametrelerinden en az biri verilmelidir; schedule_at ile başlangıç ileri bir tarihe ertelenebilir.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | UUID | Evet | Çalışma alanı kimliği |
campaign_name | metin | Evet | Kampanya adı (1–200 karakter) |
segments | metin dizisi | Evet | CRM etiket adları — bu etiketlerden herhangi birini taşıyan CRM kayıtları/kişileri alıcı olur (en az 1) |
subject | metin | Hayır* | Konu satırı; template_id konu sağlamıyorsa zorunlu. Merge tag destekler |
body_html | metin | Hayır* | HTML e-posta gövdesi (veya template_id kullanın). Merge tag destekler |
template_id | UUID | Hayır | Konu/gövde için kayıtlı bir kampanya şablonu kullan |
reply_to | e-posta | Hayır | Yanıt adresi; verilmezse hesabınızın e-postası kullanılır |
schedule_at | ISO tarih | Hayır | Gelecekte bir başlangıç zamanı; verilmezse hemen başlar |
*subject ve body_html, doğrudan veya şablon üzerinden mutlaka sağlanmalıdır.
Çağrı öncesi kota kontrolü yapılır: aylık limit dolmuşsa veya aktif, doğrulanmış bir gönderim domain'i yoksa araç hata döner. Yanıtta campaign_id ve güncel kota durumu (mail_quota) bulunur.
AI'a şöyle yazın: "'sicak-lead' etiketli tüm kayıtlara 'Kasım Teklifi' adında bir kampanya hazırla; konu 'Merhaba {{first_name|orada}}, size özel teklifimiz var' olsun. Önce bana göster, ben onaylayınca gönder."
control_campaign
Bir kampanyayı kontrol eder: pause (çalışan kampanyayı duraklatır), resume (duraklatılmış kampanyayı devam ettirir ve askıda kalmış alıcıları yeniden zamanlar), cancel (çalışan/duraklatılmış kampanyayı iptal eder — geri alınamaz).
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | UUID | Evet | Çalışma alanı kimliği |
campaign_id | UUID | Evet | Kampanya kimliği |
action | enum | Evet | pause, resume veya cancel |
Geçersiz durum geçişleri hata döner: yalnızca çalışan kampanya duraklatılabilir, yalnızca duraklatılmış kampanya devam ettirilebilir; tamamlanmış veya iptal edilmiş kampanya iptal edilemez.
AI'a şöyle yazın: "Kasım Teklifi kampanyasını şimdilik duraklat — bounce oranına bakıp devam edeceğiz."
Kampanya durumunu ve alıcı ilerlemesini izlemek için Kampanya Okuma Araçları sayfasındaki list_campaigns ve get_campaign araçlarını kullanın.