Ana içeriğe geç

Düğüm telegram

Düğüm telegram, Telegram Bot API ile entegrasyon sağlar. Bu sayede akış, sohbetlere ve kanallara mesaj gönderebilir, Inline butonları görüntüleyebilir, buton tıklamalarını işleyebilir ve kullanıcıya açılır bildirimler gösterebilir.

Düğüm telegram Ayarları​

"bot_token", "chat_id", "tg_text", "parse_mode", "reply_markup" alanları ve "Submit" düğmesiyle telegram düğümünün "Node Information" penceresi

Aşağıdaki başlıklarda, düğüm formundaki alanların etiketleri, parantez içinde ise değerlerin JSON şemasında saklandığı anahtarlar bulunmaktadır.

1. Bot Token (botToken)​

Telegram botunuzun, @BotFather üzerinden alınan token'ı.

Mustache desteği vardır — token, akış değişkeninde (flow) saklanabilir ve {{değişken}} ile yerleştirilebilir.

Örnek:

{{flow.telegramToken}}

2. Chat ID (chatId)​

Mesajın gönderileceği sohbet veya kanalın kimliği.

Mustache desteği vardır. Alan boş bırakılırsa, değer otomatik olarak msg.payload.message.chat.id'den alınır — bu, kullanıcıdan gelen bir mesaja yanıt verirken kullanışlıdır.

Örnek:

{{payload.message.chat.id}}

3. Message text (text)​

Gönderilecek mesajın metni.

Mustache desteği vardır — msg'den dinamik olarak veri eklenebilir.

Örnek:

Siparişiniz №{{payload.orderId}} başarıyla oluşturuldu!

4. Text format (parseMode)​

Mesaj metninin biçimlendirme modu. Mevcut seçenekler:

  • none (varsayılan) — biçimlendirme yok, metin olduğu gibi gönderilir.
  • Markdown — Telegram'ın temel Markdown'u (v1).
  • MarkdownV2 — spoiler ve diğer öğeleri destekleyen genişletilmiş Markdown versiyonu.
  • HTML — HTML biçimlendirmesi (<b>, <i>, <code>, <a> vb.).

5. Buttons (replyMarkup)​

Mesajın altında Inline butonlar oluşturucu. Butonlar sıralar halinde düzenlenmiştir (Row 1, Row 2, …): her sıra bir veya daha fazla buton içerir. Bir buton eklemek için + Button butonunu, yeni bir sıra eklemek için + Row butonunu kullanın.

Her buton için şu ayarlar yapılır:

  • Text — kullanıcının göreceği buton etiketi.
  • callback_data — butona tıklandığında msg.payload.callback_query.data alanında webhook'a gelecek değer. Bu değer ile hangi butona tıklandığı belirlenebilir ve akış uygun dalga yönlendirilir.

Örnek yapı:

Row 1: [Onayla | callback_data: confirm]  [İptal et | callback_data: cancel]
Row 2: [Daha fazla bilgi | callback_data: details]

6. Callback Query ID (callbackQueryId)​

Callback isteğinin kimliği — Inline butona tıklamaya yanıt vermek için gereklidir.

Mustache desteği vardır. Alan boş bırakılırsa, değer otomatik olarak msg.payload.callback_query.id'den alınır.

Örnek:

{{payload.callback_query.id}}

7. Show as alert (showAlert)​

Varsayılan olarak kapalı olan bir onay kutusu. Butona tıklamaya yanıt verirken bildirim türünü belirler:

  • Kapalı — kısa bir toast popup gösterilir (otomatik olarak kaybolur).
  • Açık — kullanıcı tarafından manuel olarak kapatılması gereken bir bildirim penceresi gösterilir.

8. Notification text (notificationText)​

Inline butona tıklamaya yanıt olarak görünecek bildirim metni.

Alan, yalnızca Show as alert etkinleştirildiğinde formda görüntülenir.
Mustache desteği vardır.

Örnek:

Seçiminiz alındı: {{payload.callback_query.data}}

Kullanım Örnekleri​

Örnek 1: Yeni sipariş hakkında mesaj gönderme​

Akış:

[events: order_created] ---> [telegram]

Düğüm Ayarları:

  • Bot Token: {{flow.telegramToken}}
  • Chat ID: {{flow.adminChatId}}
  • Message text: Yeni sipariş №{{payload.order.id}} {{payload.order.userName}} tarafından verildi. Tutar: {{payload.order.totalPrice}} TL.
  • Text format: none

Sonuç:
Yeni bir sipariş oluşturulduğunda bot, yönetici sohbetine bir bildirim gönderecektir.

Örnek 2: Onay butonları ile mesaj​

Düğüm Ayarları:

  • Chat ID: {{payload.message.chat.id}}
  • Message text: Siparişi onaylamak ister misiniz?
  • Buttons: 
    Row 1: [Evet, onayla | confirm]  [İptal et | cancel]

Sonuç:
Kullanıcı iki butonla bir mesaj alacaktır. Butona tıklanması, callback_data'yı webhook'a gönderecek ve burada Switch düğümü ile işlenebilir.

Örnek 3: Butona tıklamaya yanıt olarak bildirim​

Akış:

[http in] ---> [switch: callback_data == "confirm"] ---> [telegram: bildirim ile yanıt]

Düğüm Ayarları:

  • Callback Query ID: (boş bırakın — msg.payload.callback_query.id'den alınır)
  • Show as alert: açık
  • Notification text: Sipariş onaylandı!

Sonuç:
Kullanıcıya "Sipariş onaylandı!" metni ile bir açılır popup gösterilecektir; bu popup manuel olarak kapatılmalıdır.