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ı​

Edit

1. wa_phone_number_id​

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. wa_access_token​

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

Mustache desteği vardır — token'ı akışta bir değişkende saklayabilir ve {{değişken}} ile yerleştirebilirsiniz.

Örnek:

{{flow.whatsappToken}}

3. wa_api_version​

İstekler için kullanılacak Graph API sürümü. Statik bir alandır.

Örnek:

v19.0

4. wa_action​

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

  • text — normal metin mesajı. text alanını etkinleştirir.
  • template — Meta'da önceden onaylanmış şablon mesajı. templateName, locale ve components alanlarını etkinleştirir.

5. wa_to​

Alıcının telefon numarası uluslararası formatta: ülke kodu ile, + işareti olmadan ve boşluk olmadan.

Mustache desteği vardır.

Örnek:

{{payload.user.phone}}

veya statik olarak: 79001234567

6. wa_text​

Mesajın metni. Sadece action: text durumunda kullanılır.

Mustache desteği vardır.

Örnek:

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

7. wa_template_name​

Meta Business Manager'da onaylanmış şablonun adı. Sadece action: template durumunda kullanılır.

Mustache desteği vardır.

Örnek:

order_confirmation

8. wa_locale​

Şablonun dili language_REGION formatında. Meta'daki şablonun dili ile tam olarak eşleşmelidir.

Örnekler:

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

9. wa_components​

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

Her bir öğe üç alan içerir:

  • type — şablonun bölümü: header (başlık) veya body (ana gövde).
  • 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  |  name: order_id   |  text: {{payload.orderId}}
type: body  |  name: amount     |  text: {{payload.totalPrice}}

Kullanım Örnekleri​

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

Akış:

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

Düğüm Ayarları:

  • accessToken: {{flow.whatsappToken}}
  • phoneNumberId: {{flow.phoneNumberId}}
  • apiVersion: v19.0
  • action: text
  • to: {{payload.order.phone}}
  • text: 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ış:

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

Düğüm Ayarları:

  • action: template
  • to: {{payload.order.phone}}
  • templateName: order_status_update
  • locale: tr_TR
  • components: 
    type: body  |  name: order_id    |  text: {{payload.order.id}}
    type: body  |  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. templateName ve locale alanlarının değerleri, onaylı şablonun parametreleri ile tam olarak eşleşmelidir.