Ana içeriğe geç

WhatsApp Düğümü

WhatsApp düğümü, WhatsApp Business Cloud API (Meta) ile entegrasyon sağlar. Bu sayede akış, kullanıcılara normal metin mesajları ve değişkenlerin yerleştirildiği onaylı şablon mesajları gönderebilir.

WhatsApp Düğüm Ayarları​

"wa_phone_number_id", "wa_access_token", "wa_api_version", "wa_action", "wa_to", "wa_text" alanlarıyla whatsapp 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. Telefon Numarası ID (phoneNumberId)​

Meta'daki gönderici numarasının kimliği. Bunu Meta Business Manager'da WhatsApp → Başlarken bölümünde bulabilirsiniz.

Mustache desteği vardır.

Örnek:

{{flow.phoneNumberId}}

2. Erişim Token'ı (accessToken)​

Meta Business Manager'dan alınan kalıcı erişim token'ı.

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

Örnek:

{{flow.whatsappToken}}

3. API Versiyonu (apiVersion)​

İsteklerde kullanılacak Graph API versiyonu. Statik bir alan olup, varsayılan değeri v20.0'dır.

Örnek:

v20.0

4. Eylem (action)​

Gönderilen mesajın türü. Mevcut seçenekler:

  • Mesaj (varsayılan) — normal bir metin mesajı. Alıcı ve Mesaj metni alanlarını etkinleştirir.
  • Şablon — Meta'da önceden onaylanmış bir şablon mesajı. Alıcı, Şablon adı, Yerelleştirme ve Bileşenler alanlarını etkinleştirir.

5. Alıcı (to)​

Alıcının telefon numarası uluslararası formatta: ülke kodu ile, + işareti olmadan ve boşluk olmadan. Her iki Eylem seçeneğinde de bu alan vardır.

Mustache desteği vardır.

Örnek:

{{payload.user.phone}}

veya statik olarak: 79001234567

6. Mesaj metni (text)​

Mesajın metni. Sadece Eylem: Mesaj durumunda kullanılır.

Mustache desteği vardır.

Örnek:

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

7. Şablon adı (templateName)​

Meta Business Manager'da onaylanmış şablonun adı. Sadece Eylem: Şablon durumunda kullanılır.

Mustache desteği vardır.

Örnek:

order_confirmation

8. Yerelleştirme (locale)​

Şablonun dili. Meta'daki şablonun dili ile tam olarak eşleşmelidir. Sadece Eylem: Şablon durumunda kullanılır.

Örnekler:

  • en_US — İngilizce (ABD)
  • fr_FR — Fransızca

9. Bileşenler (components)​

Şablonun parametreleri — gönderim sırasında şablona yerleştirilecek değişkenlerin değerleri. Sadece Eylem: Şablon durumunda kullanılır.

Bileşenler + Bileşen butonu ile eklenir ve numaralandırılır (Bileşen 1, Bileşen 2, …). Her bileşen üç alan içerir:

  • type — şablonun bölümü: header (başlık) veya body (ana gövde).
  • parameter_name — WhatsApp Business panelinde şablonda tanımlandığı gibi değişkenin adı.
  • text — değişkenin yerine yerleştirilecek değer. Mustache desteği vardır.

Örnek:

type: body  |  parameter_name: order_id   |  text: {{payload.orderId}}
type: body  |  parameter_name: amount     |  text: {{payload.totalPrice}}

Kullanım Örnekleri​

Örnek 1: Sipariş için Metin Bildirimi​

Akış:

[events: order_created] ---> [whatsapp]

Düğüm Ayarları:

  • Telefon Numarası ID: {{flow.phoneNumberId}}
  • Erişim Token'ı: {{flow.whatsappToken}}
  • API Versiyonu: v20.0
  • Eylem: Mesaj
  • Alıcı: {{payload.order.phone}}
  • Mesaj metni: Siparişiniz №{{payload.order.id}} alınmıştır. Tutar: {{payload.order.totalPrice}} TL.

Sonuç:
Sipariş oluşturulduğunda kullanıcı, sipariş detaylarıyla birlikte bir WhatsApp mesajı alacaktır.

Örnek 2: Değişkenlerle Şablon Mesajı​

Akış:

[events: order_status_changed] ---> [whatsapp]

Düğüm Ayarları:

  • Eylem: Şablon
  • Alıcı: {{payload.order.phone}}
  • Şablon adı: order_status_update
  • Yerelleştirme: en_US
  • Bileşenler: 
    type: body  |  parameter_name: order_id    |  text: {{payload.order.id}}
    type: body  |  parameter_name: status      |  text: {{payload.order.status}}

Sonuç:
Kullanıcı, sipariş numarası ve durumu ile yerleştirilmiş onaylı bir şablon mesajı alacaktır.

bilgi

Şablon mesajları önceden oluşturulmalı ve Meta Business Manager'da onay alınmalıdır. Şablon adı ve Yerelleştirme alanlarının değerleri, onaylı şablonun parametreleri ile tam olarak eşleşmelidir.