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ı

Edit

1. botToken

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

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

Örnek:

{{flow.telegramToken}}

2. chat_id

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

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

Örnek:

{{payload.message.chat.id}}

3. text

Gönderilecek mesajın metni.

Mustache desteği vardır — msg içinden dinamik olarak veriler eklenebilir.

Örnek:

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

4. parseMode

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

none — 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. replyMarkup

Mesajın altında Inline butonlar oluşturucu. Butonlar satırlara düzenlenmiştir: her satır bir veya daha fazla buton içerir.

Her buton için belirlenir:

Metin — kullanıcının gördüğü buton etiketi.
callback_data — butona tıklandığında msg.payload.callback_query.data alanında webhuka gelecek değer. Bu değer ile hangi butonun tıklandığı belirlenebilir ve akış uygun dalga yönlendirilir.

Yapı örneği:

Satır 1: [Onayla | callback_data: confirm]  [İptal et | callback_data: cancel]
Satır 2: [Daha fazla | callback_data: details]

6. callbackQueryId

Callback isteğinin kimliği — Inline buton tıklamasına 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. showAlert

Onay kutusu. Buton tıklamasına yanıt olarak bildirim türünü belirler:

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

8. notificationText

Inline butona tıklama yanıtında görünecek bildirim metni.

Alan, yalnızca showAlert açık olduğunda 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ı:

botToken: {{flow.telegramToken}}
chat_id: {{flow.adminChatId}}
text: Yeni sipariş №{{payload.order.id}} {{payload.order.userName}}'den. Tutar: {{payload.order.totalPrice}} TL.
parseMode: 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ı:

chatId: {{payload.message.chat.id}}
text: Siparişi onaylıyor musunuz?

replyMarkup:

Satır 1: [Evet, onayla | confirm]  [İptal et | cancel]

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

Örnek 3: Buton tıklamasına yanıt olarak bildirim

Akış:

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

Düğüm Ayarları:

callbackQueryId: (boş bırakın — msg.payload.callback_query.id'den alınır)
showAlert: açık
notificationText: Sipariş onaylandı!

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

Düğüm telegram