Kampanya grafiği şeması

Kaydedilmiş bir kampanya grafiği iki dizidir: her biri bir tür ve bir yapılandırma nesnesi taşıyan nodes ve her biri bir düğümün numaralandırılmış çıktısını başka bir düğümün girdisine birleştiren edges. Grafikte başka hiçbir şey saklanmaz — kampanya adı, sayfası ve aktif durumu grafikte değil kampanyada yaşar. Kaydetmek her iki dizinin de yeni bir sürümünü yazar.

Düğüm alanları

Alan	Tür	Gerekli	Açıklama
id	string	evet	Düğümü bu grafiğin içinde tanımlar ve bağlantıların işaret ettiği şeydir. Grafik kaydedildiğinde yeni bir tanımlayıcıyla değiştirilir, bu yüzden yalnızca bir sürüm içinde kararlıdır.
type	string	evet	Düğüm türlerindeki türlerden biri veya aşağıda listelenen yalnızca-çalışma-zamanı türlerinden biri.
config	object	evet	Düğümün ayarları. Boş bir nesne geçerlidir ve yeni eklenen bir düğümün başladığı şeydir.
canvas_x	number	evet	Düğümün tuvaldeki yatay konumu. Grafik açıldığında geri yüklenir.
canvas_y	number	evet	Düğümün tuvaldeki dikey konumu. Grafik açıldığında geri yüklenir.

Bağlantı alanları

Alan	Tür	Gerekli	Açıklama
id	string	evet	Bağlantıyı bu grafiğin içinde tanımlar.
from_node_id	string	evet	Bağlantının ayrıldığı düğümün id’si. Aynı nodes dizisinde görünmelidir, yoksa bağlantı kaydetme sırasında düşürülür.
to_node_id	string	evet	Bağlantının girdiği düğümün id’si. Aynı nodes dizisinde görünmelidir, yoksa bağlantı kaydetme sırasında düşürülür.
output_index	number	evet	Bağlantının kaynak düğümün hangi çıktısından ayrıldığı. 0 varsayılan çıktıdır; bir condition’da 0 Eşleşme ve 1 Eşleşme Yok’tur; bir random_split’te 0’dan N-1’e kadar yapılandırılmış sıradaki kollardır.
label	string	hayır	Bağlantı üzerinde gösterilen görüntü metni, kaynak çıktının adından alınır — örneğin Match veya No Match. Çalıştırmalar output_index ile yönlendirilir, asla label ile değil.

İşlenmiş örnek

Bir yorum kampanyayı tetikler, bir anahtar kelime listesi dalı belirler, eşleşen kişiler bir özel mesaj ve bir saat sonra bir etiket alır ve diğer her çalıştırma hemen sona erer.

{
  "nodes": [
    {
      "id": "3f6c1a80-5d2b-4c11-9e64-7a0b8d43f215",
      "type": "trigger_comment",
      "config": { "post_scope": "all", "unique_per_user": false },
      "canvas_x": 240,
      "canvas_y": 40
    },
    {
      "id": "9b1d47e2-08af-4d5c-bb37-2c6e5f90a4d1",
      "type": "condition",
      "config": {
        "match_type": "keyword_list",
        "keyword_list_id": 41,
        "reverse_keywords": false,
        "wait_for_reply": false
      },
      "canvas_x": 240,
      "canvas_y": 200
    },
    {
      "id": "c74a2f19-6e30-4b8d-8f52-19d7c3b6e084",
      "type": "send_dm",
      "config": {
        "message_type": "text",
        "text": "Thanks for commenting. The price list is on its way."
      },
      "canvas_x": 80,
      "canvas_y": 380
    },
    {
      "id": "1a58e63d-4c97-42f0-9b18-6d2f7ae5c390",
      "type": "delay",
      "config": { "delay_seconds": 3600, "only_if_no_reply": true },
      "canvas_x": 80,
      "canvas_y": 540
    },
    {
      "id": "e2079b45-13cd-4a6e-8c71-5f83d0b29a6c",
      "type": "add_tag",
      "config": { "tag_ids": [12] },
      "canvas_x": 80,
      "canvas_y": 700
    },
    {
      "id": "7d3fb0c6-92e1-4f57-a840-3b6c1d5e2087",
      "type": "stop",
      "config": {},
      "canvas_x": 440,
      "canvas_y": 380
    }
  ],
  "edges": [
    {
      "id": "5c8e1b73-2f40-4d19-9a6b-8e7d0c34f512",
      "from_node_id": "3f6c1a80-5d2b-4c11-9e64-7a0b8d43f215",
      "to_node_id": "9b1d47e2-08af-4d5c-bb37-2c6e5f90a4d1",
      "output_index": 0,
      "label": ""
    },
    {
      "id": "b06d4a92-7e15-48c3-bf20-6a9c2d813e47",
      "from_node_id": "9b1d47e2-08af-4d5c-bb37-2c6e5f90a4d1",
      "to_node_id": "c74a2f19-6e30-4b8d-8f52-19d7c3b6e084",
      "output_index": 0,
      "label": "Match"
    },
    {
      "id": "48f1c25e-3b7d-4096-8ea4-1c5b7f02d9a3",
      "from_node_id": "9b1d47e2-08af-4d5c-bb37-2c6e5f90a4d1",
      "to_node_id": "7d3fb0c6-92e1-4f57-a840-3b6c1d5e2087",
      "output_index": 1,
      "label": "No Match"
    },
    {
      "id": "a91b7e04-6c58-4d2f-93a1-7e04b8c5f261",
      "from_node_id": "c74a2f19-6e30-4b8d-8f52-19d7c3b6e084",
      "to_node_id": "1a58e63d-4c97-42f0-9b18-6d2f7ae5c390",
      "output_index": 0,
      "label": ""
    },
    {
      "id": "d5720af8-9134-4be6-8c07-2f6a5d18b3e9",
      "from_node_id": "1a58e63d-4c97-42f0-9b18-6d2f7ae5c390",
      "to_node_id": "e2079b45-13cd-4a6e-8c71-5f83d0b29a6c",
      "output_index": 0,
      "label": ""
    }
  ]
}

Düğüm türüne göre yapılandırma anahtarları

Düğüm türü	config içindeki anahtarlar
trigger_comment	post_scope (all veya specific), post_id (post_scope specific olduğunda gerekli), unique_per_user
trigger_dm	unique_per_user
condition	match_type (any, contains, exact, keyword_list), text, keyword_list_id, reverse_keywords, wait_for_reply, filter_images, filter_gifs, filter_links
send_dm	message_type (text, image, card, text_with_buttons), text, image_url, title, subtitle, buttons, buttons_text
reply_comment	text
send_comment	text, post_id
hide_comment, delete_comment	also_block_user (yalnızca Facebook)
delay	delay_seconds (1 ila 31536000), only_if_no_reply
random_split	paths, her yüzdesi 0 ila 100 arasında ve toplamı 100’ü geçmeyen bir { "percent": number } dizisi
add_tag, remove_tag	tag_ids, sayısal etiket tanımlayıcılarının bir dizisi
stop	yok

Düğüm türleri her anahtarın ne yaptığını ve bir çalıştırma ona ulaştığında her düğümün ne yaptığını açıklar.

Bağlantı kısıtlamaları

Tuval, bir bağlantı sürüklenirken bunları uygular, bu yüzden geçersiz bir bağlantı asla kaydedilmiş bir grafiğe ulaşmaz.

1. Bir tetikleyici asla bir bağlantının hedefi olmaz.
2. Bir düğüm asla kendisine bağlanmaz.
3. Bir döngü oluşturacak bir bağlantı reddedilir.
4. Bir düğüm bir gelen bağlantı kabul eder.
5. Her çıktı bir giden bağlantı taşır.
6. Bir tetikleyici yalnızca bir condition’a bağlanır.
7. Bir condition asla başka bir condition’a bağlanmaz.
8. Tetikleyici trigger_dm olduğunda yorum eylemleri kullanılamaz.
9. Bir delete_comment’in altında, reply_comment ve hide_comment reddedilir.

Bir grafik pratikte bir tetikleyici tutar, ancak verinin şekli birden fazlasına izin verir. Düğümlerinde yapılandırma hataları olan bir grafik hiç kaydedilemez — tuval bunun yerine hataları bildirir. Bir kampanya oluşturun bunların hepsini karşılayan bir grafiği bir araya getirmeyi anlatır.

Palet dışındaki düğüm türleri

Çalışma zamanı, palet karosu ve ayarlar paneli olmayan sekiz tür daha tanır. Tuvalde oluşturulan bir grafik onları asla içermez; yalnızca editörü atlayan bir yol aracılığıyla görünürler, bu yüzden onları bir özellik olarak değil yalnızca çalışma zamanına özgü olarak ele alın.

Düğüm türü	Çalıştırmanın ne yaptığı
switch	Her kolun kurallarını değerlendirir ve eşleşen ilk kolu izler, veya yapılandırılmışsa varsayılan bir kolu. Eşleşme ve varsayılan kol olmadığında çalıştırma sona erer.
wait_until	Yapılandırılmış bir zamana kadar bekler ve sonra devam eder, bir delay’in planlandığı şekilde planlanır.
block_user	Kişiyi engeller ve devam eder. Yalnızca Facebook; Instagram’da hiçbir şey yapmaz ve uyarır.
unhide_comment, typing_indicator, mark_seen, set_field, note	Çalıştırılabilir, ancak ayarlar paneli taşımazlar ve bu sayfanın arkasındaki kaynaklar onlar için hiçbir yapılandırma kaydetmez.

Kaydetme bir grafiğe ne yapar

• Her kaydetme grafiğin yeni bir sürümünü yazar. Kampanya en yeni sürüme işaret eder ve yalnızca o sürümün tetikleyicisi yeni çalıştırmalar başlatır.
• Her düğüm tanımlayıcısı kaydetme sırasında yeniden oluşturulur ve bağlantılar yeni tanımlayıcılara yeniden eşlenir. Bu yüzden tanımlayıcılar bir sürüm içinde kararlıdır, kaydetmeler arasında değil.
• from_node_id’si veya to_node_id’si aynı nodes dizisinde olmayan bir bağlantı düşürülür ve grafiğin geri kalanı yine de kaydedilir.
• Boş bir grafik — her iki dizi de boş — başarıyla kaydedilir. İçinde tetikleyici olmadan, hiçbir şey bir çalıştırma başlatmaz.
• Zaten devam eden bir çalıştırma başladığı sürümde kalır, bu yüzden bir kampanyayı düzenlemek ve kaydetmek devam etmekte olan çalıştırmaları asla değiştirmez.
• Hiçbir çalıştırma onlara referans vermediğinde daha eski sürümler kaldırılır.

Notlar

• Bir send_dm düğümündeki bir postback düğmesi kendi çıktısını alır. Kaydetme sırasında tuval her düğme dalını ekstra condition düğümlerine genişletir ve bağlantıları düğmenin tanımlayıcısıyla etiketler; grafiği açmak onları tekrar düğme çıktılarına daraltır.
• Bir çalıştırma, output_index’i düğümün seçtiği çıktıyla eşleşen bağlantıyı izler. Hiçbir bağlantı o indeksi taşımadığında, çalıştırma o düğümde tamamlanır.
• Zaten ziyaret ettiği bir düğüme ulaşan bir çalıştırma bir döngü hatasıyla sona erer, bu yüzden editör zaten döngüleri reddeder.
• Bu referanstaki yapılandırma anahtarları yazılacak olanlardır. Bazı düğüm türleri, daha önce kaydedilmiş grafiklerin hala çalışması için tutulan daha eski anahtar yazımlarına da yanıt verir.

İlgili

• Düğüm türleri — config içindeki her anahtar için tam düğüm başına referans
• Bir kampanya oluşturun — yukarıdaki kısıtlamaları karşılayan bir grafik oluşturma
• Kampanyaları test edin ve hata ayıklayın — kaydedilmiş bir grafiği çalıştırma ve aldığı yolu okuma
• Çalıştırma durumları — bir çalıştırmanın bir grafiği gezerken geçtiği durumlar