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 (Channels → WhatsApp üzerinden).
- 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 Şablon | Gönderilecek onaylı şablon (yalnızca Şablon Mesajı Gönder için). | Şablon gönderirken |
| Language Code | Şablonun dili (onaylı şablonla eşleşmelidir). | Şablon gönderirken |
| 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 |
| Advanced: Raw JSON Parameters | Otomatik oluşturulan şablon bileşenlerini ham JSON ile geçersiz kılın. | İ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 önce Meta Business Manager'da oluşturulup onaylanmalıdır. Yalnızca onaylı şablonlar Select Şablon açılır menüsünde görünür — yeni bir şablonu onayladı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.
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 Send Template Message 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.
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 seçin, dili ayarlayın 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.
- Dil kodunu onaylı şablonun tam diliyle eşleştirin, aksi takdirde WhatsApp gönderimi reddeder.
- Şablonları yenileyin, Meta'da yeni bir şablon onayladıktan sonra açılır menüde görünmesi için.
İlgili
- WhatsApp tetikleyicisi — WhatsApp mesajlarından bir akış başlatın
- Instagram aracı — Instagram için eşdeğeri
- Araç node · Agent node
- Değişkenler — WhatsApp webhook yük değişkenleri