WhatsApp Aracı
WhatsApp aracı, WhatsApp Business numaranızdan mesaj gönderir — düz metin, medya (resim/video/belge/ses) ve önceden onaylanmış mesaj şablonları. Bir otomatik yanıtlayıcı oluşturmak için WhatsApp tetikleyicisi ile eşleştirin veya ajanın sizin adınıza yanıt vermesi için bir Agent node içinde kullanın.
Bir akışa ekleme
Araç node'un araç seçicisinde WhatsApp Business'ı seçin, hesabı seçin ve ihtiyaç duyduğunuz işlemleri etkinleştirin.
Kurulum / kimlik bilgileri
Araç, bağlı bir WhatsApp Business numarasından gönderim yapar.
- WhatsApp Business hesabınızı Flowera'ya bağlayın (Bağlantı Bilgileri → Bağlı Hesaplar — bkz. WhatsApp bağlantı bilgileri).
- Araçta, WhatsApp Hesabı açılır menüsünü açın ve numarayı seçin.
- Akış tek bir WhatsApp tetikleyicisiyle başlıyorsa, Flowera eşleşen numarayı otomatik olarak seçer.
WhatsApp, yalnızca müşterinin son mesajından itibaren 24 saat içinde serbest biçimli metin ve medya göndermenize izin verir. Bu pencerenin dışında, onaylanmış bir şablon mesajı kullanmanız gerekir (aşağıya bakın). Bir gönderim bu kural tarafından engellenirse Flowera net bir hata gösterir.
Girdiler
| Parametre | Açıklama | Zorunlu |
|---|---|---|
| WhatsApp Hesabı | Gönderim yapılacak bağlı WhatsApp Business numarası. | Evet |
| Operations | Hangi eylemlerin etkinleştirileceği (metin, şablon, medya, interaktif buton, liste, Flow). | Evet |
| Select Template | Gönderilecek onaylı şablon (yalnızca Şablon Mesajı Gönder için). | Şablon gönderirken |
| Language Code | Boş bırakın. Seçilen şablon dilini zaten taşır; bu alan yalnızca dil bilgisi olmayan çok eski kayıtlı seçimler için yedektir. | Hayır |
| Header Image / Video / Document URL | Medya başlığı olan bir şablon için medya. | İsteğe bağlı |
| Document Filename | Bir belge başlığı için görüntülenen ad. | İsteğe bağlı |
Body Variable {{1}}…{{15}} | Şablon gövdesindeki {{n}} yer tutucularını dolduran değerler. | Şablonun gerektirdiği kadar |
| Header Text Variable | Şablonun metin başlığındaki {{1}} için değer. | Başlıkta değişken varsa |
| Product SKU / Product SKUs | Katalog şablonunun göndereceği ürünler (aşağıya bakın). | Katalog şablonları için |
| URL Button Suffix (1st / 2nd dynamic URL button) | URL'si bir değişkenle biten bir URL butonu için bağlantının sonu (https://magaza.com/takip/{{1}}). | Şablonda böyle bir buton varsa |
| Carousel URL Suffixes (one per card) | Kart butonu bir değişkenle biten bir bağlantı açan ürün karuselleri için — her kart için bir değer. | Karuselde böyle bir buton varsa |
| Advanced: Raw JSON Parameters | Otomatik oluşturulan şablon bileşenlerinin yerine ham JSON kullanın. Geçersiz JSON şablon gönderimini bir hatayla durdurur. | İsteğe bağlı |
| Catalog ID | Meta Commerce Manager katalog kodunuz. | Send Product / Product List / Product Carousel ve tek ürün / karusel şablonları için |
Kullanılabilir işlemler
| İşlem | Ne yapar |
|---|---|
| Metin Mesajı Gönder | Düz metin gönderir (4096 karaktere kadar). 24 saatlik pencerenin açık olmasını gerektirir. |
| Şablon Mesajı Gönder | Önceden onaylanmış bir şablon gönderir — 24 saatlik pencerenin dışında bile çalışır. |
| Medya Mesajı Gönder | URL ile bir resim, video, belge veya ses dosyası gönderir (resimler 5 MB'a kadar, video/ses 16 MB'a kadar, belgeler 100 MB'a kadar). |
| İnteraktif Buton Gönder | En fazla 3 dokunulabilir yanıt butonu gönderir. Müşterinin dokunduğu buton buttonPayload olarak geri döner. |
| Liste Mesajı Gönder | Müşterinin açıp seçim yaptığı bir menü gönderir — bölümlere ayrılmış, toplam en fazla 10 satır. Seçilen satır listReplyId olarak geri döner. |
| Flow Mesajı Gönder | Yayınlanmış bir WhatsApp Flow (çok ekranlı sohbet içi form) gönderir. Formu Select Flow'dan seçersiniz; cevaplar formResponse olarak geri döner. |
| Katalog Gönder | Tüm ürün kataloğunuzu WhatsApp içinde açan bir kart gönderir. Ürün kodu gerekmez. |
| Ürün Gönder | M üşterinin sepetine ekleyebileceği tek ürün kartı gönderir (görsel, başlık, fiyat). |
| Ürün Listesi Gönder | Bölümlere ayrılmış hâlde en fazla 30 ürün gönderir. |
| Ürün Karuseli Gönder | 2-10 ürünü yatay kaydırmalı kartlar olarak gönderir. |
Bir Flow, bir alanı ancak gönder butonu o alanı eşliyorsa geri döndürür. Formu Flow Builder'da kurarsanız bu eşleme sizin için üretilir. Bir gönderim cevapsız geldiyse formu açın — bir uyarı eksik alanları söyler — sonra kaydedin ve yeniden yayınlayın: yeniden yayınlanana kadar WhatsApp eski sürümü sunmaya devam eder.
Şablonları Flowera'da — numaranızın satırında Bağlantı Bilgileri → Bağlı Hesaplar → Şablonları Yönet, bkz. WhatsApp şablonları — ya da Meta'nın WhatsApp Manager'ında oluşturun. Her iki durumda da Meta inceler ve yalnızca onaylı şablonlar Select Template açılır menüsünde görünür (en fazla 500). Yeni bir şablon onaylandıktan sonra listeyi yeniden yüklemek için yenile simgesini kullanın.
Girdiler nasıl doldurulur
Akış bir WhatsApp tetikleyicisinden başladığında Flowera olayı araca bağlar; böylece adresleme kendiliğinden dolar:
- Size mesaj gönderen kişi, alıcı (
recipientPhoneNumber) olur. - Medya URL'leri ve altyazılar, araç argümanlarından veya flow state'ten alınır.
Metni siz belirlersiniz. Bir Araç node'unda messageText adlı bir Araç Giriş
Argümanı ekleyin ve değeri olarak yanıtı yazan node'un label'ını verin — {{ Agent }}. Bunun
yerine araç bir Agent'a bağlıysa metni, aracı çağırmaya karar verdiğinde agent'ın
kendisi üretir.
messageText müşterinin sözünü geri yollarBir Araç node'unda metin argümanını boş bırakırsanız araç gelen mesaja geri düşer — müşteri kendi yazdığını geri alır. Argümanı açıkça eşleyin.
Şablonlar için, Body Variable alanlarını doldurun — seçilen şablonun bildirdiği değişken sayısına göre birer birer görünürler.
Şablonda bağlantısı bir değişkenle biten bir URL butonu varsa — https://magaza.com/takip/{{1}}
gibi bir takip bağlantısı — URL Button Suffix (1st dynamic URL button) alanına {{1}} yerine
geçecek kısmı yazın; örneğin {{$flow.state.orderId}}. Böyle ikinci bir buton 2nd alanını
kullanır. Bu alanlar her şablonda görünür; şablonda böyle bir buton yoksa boş bırakın. Şablonun
ihtiyaç duyduğu bir alanı boş bırakırsanız WhatsApp mesajın tamamını reddeder.
Kimlik doğrulama (tek kullanımlık kod) şablonlarında yalnızca kodu doldurun. Kodu Body Variable
{{1}} alanına yazın — örneğin {{$flow.state.otp}}. Meta kodu iki kez ister: gövdede ve şablonun
kodu kopyala butonunda; node kodu butona sizin için kopyalar, bu yüzden bu şablonlarda URL Button
Suffix alanını boş bırakın.
WhatsApp aracı bir Agent node içindeyse ve Select Template'ten bir şablon seçtiyseniz, gönderilen tam olarak o şablondur — adı, dili ve doldurduğunuz değerler. Model yalnızca ne zaman gönderileceğine karar verir; başka bir şablon seçemez veya değerleri değiştiremez. Şablonu modelin kendisinin seçmesini istiyorsanız Select Template'i boş bırakın.
Her zaman şablonun kendi dili kullanılır. Bir şablonun her dili Select Template içinde ayrı bir seçenektir (dil, adın yanında gösterilir); doğru seçeneği seçin. Language Code alanı artık bunu geçersiz kılmaz — hâlâ bu alanı dolu tutan eski akışlar çalışmaya devam eder.
Advanced: Raw JSON Parameters diğer tüm şablon alanlarının yerini alır. JSON geçerli bir dizi değilse şablon gönderimi, Tool node'unda da Agent node'unun içinde de alanın adını veren bir hatayla durur ve hiçbir şey gönderilmez. Node'un diğer WhatsApp işlemleri çalışmaya devam eder. Eskiden şablonu hiçbir değer olmadan sessizce gönderiyordu ve WhatsApp reddediyordu.
Katalogdan satış
Meta Commerce Manager'da bir ürün kataloğunuz varsa bot ürünleri sohbette gösterebilir ve sipariş alabilir — müşteri WhatsApp'tan çıkmadan ürünlere bakar, sepete ekler ve gönderir.
Başlamadan önce
- Meta Commerce Manager'da Çevrimiçi ürünler türünde bir katalog oluşturun ve ürünlerinizi yükleyin (her biri için içerik kodu / SKU, başlık, fiyat ve görsel gerekir).
- Kataloğu WhatsApp Business hesabınıza bağlayın. Hesap başına tek katalog — zaten bağlı bir katalog varsa ikincisini oluşturmak yerine ürünlerinizi ona ekleyin.
- Numaranız için katalog görünürlüğünü açmasını destekten isteyin. Meta, sohbet başlığındaki mağaza simgesini varsayılan olarak kapalı tutar ve bu ayarı kendi arayüzlerinin hiçbirinde sunmaz; bu nedenle bağlı katalog, ayar API üzerinden açılana kadar görünmez. Flowera'da bunun için henüz self-servis bir ekran yok.
Aşağıdaki katalog gönderim araçları bu ayardan bağımsız çalışır — bu anahtar yalnızca sohbet başlığındaki kalıcı mağaza simgesini kontrol eder.
Hangi gönderimi kullanmalı
| İşlem | Ne zaman | Gerekli |
|---|---|---|
| Send Catalog | Müşteri ne sattığınızı sorduğunda. Hepsini açar. | Hiçbir şey — Catalog ID bile gerekmez |
| Send Product | Belirli bir ürün hakkında cevap verirken. | Catalog ID + ürünün SKU'su |
| Send Product List | Birkaç ürün önerirken (en fazla 30, bölümler hâlinde). | Catalog ID + SKU'lar |
| Send Product Carousel | Kısa ve görsel bir set göstermek istediğinizde (2-10 ürün). | Catalog ID + SKU'lar |
Catalog ID'yi Commerce Manager'da Katalog → Ayarlar altında bulabilirsiniz.
Tool node, üzerinde etkinleştirdiğiniz her işlemi aynı argümanlarla çalıştırır. Bir node'da iki katalog gönderimi seçiliyse müşteriye iki mesaj gider. Her gönderim için ayrı bir Tool node açın ve üzerinde tek bir işlem seçin.
Bu kural Agent node için geçerli değil — o araçları teker teker çağırır.
Flowera ürünlerinizi sizin için listeleyemez — katalog içeriğini okumak, uygulamanın sahip olmadığı bir Meta iznini gerektirir. SKU'ları Commerce Manager'dan kopyalayın. Bir ajanın ürün önermesi için SKU listesini sistem talimatına ekleyin.
Siparişi almak
Müşteri sepetini gönderdiğinde akış eventType: order ile çalışır ve ayrıştırılmış sepet
{{$webhook.<ad>.order}} içinde gelir — satır kalemleri, adetler, fiyatlar ve toplam. {{$question}}
doğrudan bir LLM'e verebileceğiniz okunabilir bir özet taşır. Tam yapı için
WhatsApp tetikleyicisi sayfasına bakın.
Sohbet içi ödeme yalnızca birkaç ülkede var (Türkiye ve AB dâhil değil). Diğer yerlerde sipariş geldikten sonra ödeme linkini normal bir metin mesajı olarak gönderin.
Katalog şablonları
Müşterilere 24 saatlik pencerenin dışında ulaşmak için (örneğin terk edilmiş sepet hatırlatması) şablon editöründe bir katalog şablonu oluşturup Şablon Mesajı Gönder ile gönderin:
| Buton | Şablonda olması gereken | Not |
|---|---|---|
| Kataloğu Gör | Gövde, başlık yok | Tüm kataloğu açar |
| Ürünleri Gör | Metin başlığı + gövde | Ürünleri gönderirken siz seçersiniz |
| Ürünü Gör | Ürün başlığı + gövde | Gövde 160 karakterle sınırlıdır |
Katalog butonu şablondaki tek buton olmak zorundadır.
Katalog şablonu ürün taşımaz — onaylı şablon yalnızca bir kalıptır, ürünleri her gönderimde siz seçersiniz. Select Template'ten şablonu seçtiğinizde ihtiyaç duyulan alanlar görünür:
| Şablon | Doldurulacak | Zorunlu |
|---|---|---|
| Kataloğu Gör | Küçük resim ürün kodu | Hayır — WhatsApp katalogdaki ilk ürünü kullanır |
| Ürünleri Gör | Ürün kodları + bölüm başlığı | Evet — aksi hâlde butonun arkası boş kalır |
| Ürünü Gör | Ürün kodu + Catalog ID | Evet |
| Ürün karuseli | Ürün kodları + Catalog ID | Evet |
Ürün kodlarını virgülle ya da alt alta yazın. Ürünleri Gör için en fazla 30, karusel için en fazla 10.
Her alan {{$degisken}} kabul eder; böylece ürünleri akış çalışma anında seçebilir.
Ürün karuseli şablonları
Karusel şablonu ürünlerinizi kaydırmalı kartlar hâlinde gösterir. Şablon editöründe Ürün Karuseli seçeneğini açın ve kart butonunun ne yapacağını seçin:
| Kart butonu | Ne olur | Sipariş bildirimi |
|---|---|---|
| WhatsApp içinde Gör | Ürün WhatsApp içinde açılır, müşteri sepete ekler | Evet |
| Web sitesini aç | Müşterinin tarayıcısında siteniz açılır | Hayır |
Kartı bir kez tanımlarsınız. Meta şablonu iki özdeş kartla onaylar, ardından o şablonla 10 ürüne kadar gönderebilirsiniz.
Kart butonu bir değişkenle biten bir bağlantı açıyorsa Carousel URL Suffixes (one per card) alanını doldurun — her kart için bir değer, virgülle ya da alt alta. Kalan kartlar için son değer tekrarlanır.
Karusel şablonunun kendi başlığı, alt bilgisi veya butonu olamaz — bunları kartlar taşır — ve Pazarlama kategorisinde olmalıdır. Karuseli açtığınızda editör bu bölümleri gizler ve kategoriyi sizin için değiştirir.
Kart butonu web sitenizi açıyorsa satın alma WhatsApp dışında gerçekleşir ve Meta bunu Flowera'ya hiç bildirmez. Siparişi bekleyen bir akış sonsuza kadar bekler. Akışınız siparişe tepki veriyorsa WhatsApp içi butonu kullanın.
Şablonun metin başlığında {{1}} varsa — Meta'nın terk edilmiş sepet örneği
Forget something, {{1}}? şeklinde — Header Text Variable alanını doldurun. Sabit başlıklarda
boş bırakın.
WhatsApp Manager'da oluşturulmuş bazı şablonlar değişkenlerini numaralandırmak ({{1}}) yerine
isimlendirir ({{code}}). Bunlar da çalışır — Body Variable alanları numaralı kalır, şablon
açılır menüsü isimleri sırasıyla listeler; böylece hangi alanın hangisi olduğunu görürsünüz.
Çıktılar
Araç, gönderim sonucunu döndürür (mesaj kimliği ve durumu). Tek çıktılı bir araçtır — akış bir sonraki node'a geçer. Daha sonra ihtiyaç duyacağınız her şeyi flow state'te kaydedin.
Örnek
Sipariş onayı şablonu
- Bir akış (veya zamanlanmış çalıştırma), bir siparişin onaylandığı noktaya ulaşır.
- Şablon Mesajı Gönder etkinleştirilmiş WhatsApp aracıyla bir Araç node ekleyin.
- Onaylı
order_confirmationşablonunuzu istediğiniz dildeki seçeneğiyle seçin ve Body Variable{{1}}'i müşteri adına,{{2}}'yi sipariş numarasına eşleyin.
Bir şablon olduğu için, müşteri son 24 saatte mesaj göndermemiş olsa bile bu güvenilir bir şekilde gönderilir.
İpuçları
- Proaktif her şey için şablon kullanın. Serbest biçimli metin yalnızca 24 saatlik pencere içinde çalışır; şablonlar her zaman çalışır.
- Doğru dil seçeneğini seçin — Select Template içinde bir şablonun her dili ayrı listelenir ve node, seçtiğiniz seçeneğin dilinde gönderir.
- Şablonları yenileyin, yeni bir şablon onaylandıktan sonra açılır menüde görünmesi için.
- Onaylı bir şablonu düzenlemek onu devreden çıkarır — Meta yeniden onaylayana kadar; değişkenlerini veya butonlarını değiştirmek bu node'u da güncellemeyi gerektirir. Bkz. WhatsApp şablonları.
İlgili
- WhatsApp tetikleyicisi — WhatsApp mesajlarından bir akış başlatın
- WhatsApp şablonları — şablon oluşturma, düzenleme ve silme
- Instagram aracı — Instagram için eşdeğeri
- Araç node · Agent node
- Değişkenler — WhatsApp webhook yük değişkenleri