WhatsApp otomasyon referansı: tetikleyiciler, adımlar, değişkenler ve sınırlar
Bir WhatsApp numarasındaki easyCoexistence otomasyonları, gelen bir mesajla, etiket alan bir kişiyle ya da sisteminizden gelen bir çağrıyla başlar. Bir mesajın dört eşleşmesi vardır: Her mesaj, Anahtar kelime var, İlk mesaj ve Mesai dışı. Ardından adımlar gelir: bir hatta en fazla 30, toplamda 60; dallar, sorular ve yapay zekâ ajanlarıyla. Bir mesaj en fazla bir otomasyon tarafından karşılanır; önce anahtar kelime kuralları gelir.
Bir hattaki adımlar, toplamda 60, iç içe 4 dala kadar; Dur ve Bir adıma dön yalnızca bir hattı bitirebilir.
Otomasyon başına her biri en fazla 100 karakter; bunlardan herhangi biri yeterlidir ve büyük harfler önemli değildir.
Yapay zekâ ile yanıtla adımının Talimatlarında izin verilen karakterler; yanıtlar 50 ila 2,000 token ile sınırlıdır.
Tek bir Bekle adımının en uzun süresi 23 saattir; böylece sonraki metin adımı hâlâ Meta'nın 24 saatlik penceresi içinde kalır.
Webhook'unuzun, Webhook'umu çağır adımı başarısız sayılmadan önce yanıt vermesi gereken süre; yanıttaki reply alanı müşteriye gönderilir.
Çalıştırmaların saklama süresi; her birini başlatan mesaj ve yanıtla birlikte. Mesaj metni, seçtiğiniz saklama süresinin sonunda silinir (30, 90 veya 365 gün, varsayılan 90).
Bir WhatsApp otomasyonu hangi tetikleyicileri ve eşleşmeleri kullanabilir?
Ana tetikleyici şudur: “Bir mesaj geldiğinde” (message_received). Müşteri numaraya yazdığında çalışır: metin, fotoğraf, video, belge, ses, çıkartma, konum, kişi kartları, düğme ve liste yanıtları ile siparişler. Sesli mesaj, OpenAI veya OpenRouter anahtarınızla metne dökülür ve “[voice message]” ardından sözcükler olarak saklanır; bir anahtar kelime bununla eşleşebilir. Böyle bir anahtar yoksa “[voice message]” olarak kalır. Tepkiler, durumlar ve sistem bildirimleri hiçbir çalıştırmayı başlatmaz; Coexistence numarasında grup sohbetleri API'ye ulaşmaz. Diğer iki tetikleyici bir mesajdan başlamaz. “Bir kişi etiket aldığında” (tag_added), numaradan ulaşılabilen bir kişi, adını verdiğiniz etiketi her aldığında çalışır; etiket bir akıştan, bir yapay zekâ ajanından, Konuşmalar içinde sizden ya da update_contact ile gelebilir. “Sisteminiz bir URL'yi çağırdığında” (webhook_received), kendi sisteminiz otomasyonun URL'sine telefon numarası içeren bir JSON'u POST ettiğinde çalışır; otomasyonun sırrı Bearer token olarak gönderilir, örneğin yeni bir sipariş ya da rezervasyon için; en fazla 20 KB olan gövde {{vars.webhook.*}} olarak kullanılabilir. İkisinde de {{message}} boştur ve son 24 saatte yazmamış bir kişi yalnızca send_template alabilir. Zamanlama tetikleyicisi yoktur. Mesaj tetikleyicisinde Mesai dışı eşleşmesi, “Açık olduğu günler” altında işaretlenen günleri Başlangıç ile Bitiş arasında açık sayar; saat dilimi America/Sao_Paulo gibi bir IANA saat dilimidir. Bitiş, Başlangıç'tan önceyse gece vardiyası sayılır (22:00 ila 06:00); işaretlenmeyen bir gün tüm gün kapalı kabul edilir. API'de hours alanı timezone, days (1 = Pazartesi, 7 = Pazar; açık olduğunuz günler) ile start ve end alır. İlk mesaj, easyCoexistence bir sohbet için kayıt oluşturduğunda çalışır: numara için bir otomasyon açıldıktan sonra müşterinin gönderdiği ilk mesaj, uzun süredir müşteri olanlar dahil, ya da 30 gün sessiz kaldıktan sonraki ilk mesaj. Telefondan açtığınız bir sohbet zaten görülmüş sayılır.
Anahtar kelime modları nasıl eşleşir?
“Kelimenin nerede olması gerektiği” altında varsayılan İçerir'dir (“Mesajın herhangi bir yerinde”). Başında seçeneği “Başta”, Tam eşleşme ise “Tüm mesaj” anlamına gelir. API'de keywordMode değeri contains, starts_with ya da exact olur. Eşleşme, mesajın çevresindeki boşlukları kırpar ve büyük harfleri yok sayar; ancak aksan ve noktalama işaretlerini yok saymaz. İçerir ayrıca daha uzun kelimelerin içinde de eşleşir. Anahtar Kelimeler altındaki “Test et” kutusu, yazdığınız her örnek için “Çalışır: eşleşti” (anahtar kelimeyle birlikte) ya da “Çalışmaz: hiçbir anahtar kelime eşleşmedi” yanıtını verir.
| Matches | Does not match | |
|---|---|---|
| Contains "price" | What is the price? · PRICES please | How much is it? |
| Contains "oi" | Oi! · Boa noite (inside noite) | Olá |
| Starts with "menu" | Menu please | Can I see the menu? |
| Is exactly "menu" | Menu · menu with spaces around it | menu? · the menu |
| Contains "preço" | Qual o preço? | Qual o preco? |
Her adım ne yapar ve hangi alanları alır?
Adımlar yukarıdan aşağıya çalışır; bir hatta en fazla 30, bir otomasyonda dallar dahil en fazla 60 adım olabilir ve en az biri Bekle, Dur, Yollara ayır, Yapay zekâ yolu seçer ve Bir adıma geri dön dışında bir iş yapmalıdır. Dallanan bir adım, her yol için bir adım hattı ve bir de Aksi halde hattı taşır; dallar 4 seviye iç içe geçebilir. “Bir adım seçin” menüsünde her adımın bir adı ve kısa bir satırı vardır; altı temel adım için ikisi de aşağıda alıntılanmıştır. Soru sor (ask), Mesajını en fazla 10 düğmeyle gönderir; bunlardan 3'ü dokunulabilir düğme olarak görünür, fazlası liste olarak yazılır ve numarayla yanıtlanır; yanıt için en fazla 1380 dakika bekler ve yanıtı bir kişi alanına metin, e-posta, sayı, telefon ya da düğmelerden biri olarak kaydeder; yanlış bir yanıt gelirse soru en fazla 3 kez yeniden sorulur. Ajan yanıtlar (agent), mesajı yapay zekâ ajanlarınızdan birine devreder, Görsel veya dosya gönder (send_file) dosyalarınızdan bir görsel ya da PDF gönderir, Bir kişiye devret (handoff) ise o sohbette botu 1 ila 168 saat, varsayılan 24, duraklatır ve size e-posta gönderir. Yollara ayır (condition) ile Yapay zekâ yolu seçer (ai_decide) kurallara ya da anlama göre dallanır. Yapay zekâ ayrıntıları kaydeder (ai_extract), Kişiye kaydet (set_field) ve Etiket (tag) kişi alanlarını ve etiketlerini yazar; API çağır (http_request) herhangi bir HTTPS API'sini çağırır ve JSON yanıtını {{vars.<name>...}} olarak tutar. Otomasyon başlat (start_automation) aynı kişi için başka bir otomasyonu çalıştırır, en fazla 3 seviye derinlikte; Bir adıma geri dön (goto) döngü kurmak için bir adım kimliğine atlar, Beni bilgilendir (notify_owner) size e-posta gönderir, otomasyon başına saatte en fazla 20. Bir adım başarısız olursa sonraki adımlar atlanır ve çalıştırma Başarısız olarak biter. Webhook'umu çağır, event değeri “automation.step”, dry_run, run_id, numara, kişi (wa_id, name), mesaj (id, type, text, at) ve sohbetteki en fazla 10 son mesajı içeren bir JSON'u POST eder. Bu istek X-EC-Signature başlığında t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> biçiminde imzalanır; imza, adımın “İmzalama sırrı” ile oluşturulur. URL'si herkese açık HTTPS olmalıdır ve yönlendirmeler takip edilmez.
Hangi değişkenler adımları doldurabilir?
Dördü, çift süslü parantez içinde yazılır ve çalıştırmayı başlatan mesajdan doldurulur; {{contact.<field>}} bir kişi alanı ekler (contact.name ve contact.phone da dahil), {{vars.<path>}} ise önceki adımların kaydettiğini, örneğin bir API çağır adımının yanıtını. Metinle yanıtla adımının Mesajında, şablonun gövde değişkenlerinde, Yapay zekâ ile yanıtla adımının Talimatlarında ve Soru sor gibi diğer adımların metninde çalışırlar; şablon değişkenlerinde “Ekle:” çipleri bunları ekler. Bilinmeyen bir değer, örneğin adı olmayan bir profil, boş olur. Şablon gönderimleri yalnızca gövde değişkenlerini, konumlarına göre taşır; bu nedenle adlandırılmış değişkenleri, başlık görselini ya da başlık değişkenini ya da değişken içeren bir düğmeyi olan şablonlar henüz seçilemez. Boş bırakılan bir değişken ise Meta'nın gönderimi reddetmesine yol açar.
- {{
first_name}}: müşterinin WhatsApp profil adındaki ilk kelime (“İlk ad”). - {{name}}: tam profil adı (“Tam ad”).
- {{message}}: mesajın metni ya da “[image]” gibi yer tutucusu ile varsa altyazısı (“Müşterinin mesajı”).
- {{phone}}: müşterinin numarası, başında artı olmadan uluslararası rakamlar olarak, örneğin 5511999998888 (“Müşterinin telefonu”).
- Bir testte müşteri “Test müşterisi” ve telefon 15550000000'dır.
Ayarlar ve varsayılanları nelerdir?
İki ayar “Gelişmiş” altında bulunur; bu düğme düzenleyicide Açık anahtarının yanındadır. Yapay zekâ adımının kendine ait iki ayarı daha vardır. Doldurulmayan bir alan varsayılan değerini alır; bu hem düzenleyicide hem de create_automation üzerinden geçerlidir. Zaman aşımları ayarlanmaz, sabittir: bir yapay zekâ yanıtı 45 saniye, bir webhook ise 20 saniye süre tanınır. Bir otomasyonun adı en fazla 120 karakter olabilir. Bir yapay zekâ ajanının kendi ayarları vardır: okuduğu önceki mesajlar, 0 ila 40 (varsayılan 20), en uzun yanıt 100 ila 4000 token (varsayılan 800), yanıt başına en fazla 10 araç çağrısı (varsayılan 5) ve devir saati, 1 ila 168 (varsayılan 24).
Birden fazla eşleşme olduğunda hangi otomasyon yanıt verir?
Aynı anda en fazla biri yanıt verir; sabit bir sırayla seçilir: önce Anahtar kelime var, sonra İlk mesaj, sonra Mesai dışı, en son Her mesaj; aynı türde olanlarda en eski otomasyon önce gelir. Yalnızca Açık ve duraklatılmamış otomasyonlar yarışır; bu nedenle anahtar kelime kuralı Kapalıysa ya da reddedilmiş bir yapay zekâ anahtarı yüzünden duraklatılmışsa, genel Her mesaj otomasyonu yanıt verir. İki sonuç insanları şaşırtır. Gece yazan yeni bir müşteri, Mesai dışı yerine İlk mesaj otomasyonunu alır, çünkü İlk mesaj daha yüksek sıradadır. Ayrıca bir anahtar kelime otomasyonunun yanıtladığı mesaj hiçbir zaman bir yapay zekâ ajanına ya da Her mesaj üzerindeki Yapay zekâ ile yanıtla adımına ulaşmaz; hem bunu hem de diğerini istiyorsanız, ajanı ya da yapay zekâ adımını anahtar kelime otomasyonunun içine koyun. Açık bir Soru sor adımını yanıtlayan mesaj o soruya aittir ve onun üzerinden başka hiçbir otomasyon başlamaz. Etiket ve webhook otomasyonları kendi olaylarından başlar ve bu sıraya katılmaz.
Hangi korumalar yerleşiktir?
Çalıştırıcı bunları herhangi bir ayar olmadan uygular; Çalıştırmalar sekmesindeki atlama nedenleri, bunlar bir çalıştırmayı durdurduğunda adlarını verir:
- Meta'nın iki kez ilettiği bir mesaj tek bir çalıştırma başlatır: yinelenenler mesaj kimliğine göre atılır.
- Tepkiler, durumlar, otomasyonun kendi gönderimleri ve uygulamadan gelen yankılarınız hiçbir çalıştırmayı başlatmaz.
- Metinle yanıtla, Soru sor, Görsel veya dosya gönder, Yapay zekâ ile yanıtla, bir ajanın yanıtı ve bir webhook yanıtı, müşterinin son mesajının 24 saatten yeni olmasını gerektirir; Şablon gönder bunu gerektirmez.
- WhatsApp Business uygulamasında yazdığınız bir yanıt, o sohbetteki otomasyonu duraklatır ve orada bekleyen bir çalıştırma kalan adımlarını atlar.
- Aynı otomasyonu aynı sohbette başlatan daha yeni bir mesaj, o sohbette bir Bekle adımında hâlâ bekleyen çalıştırmanın yerini alır; açık bir soruyu yanıtlayan mesaj ise onun yerine o soruya gider.
- Bir numaradan yapılan gönderimler en az 100 ms arayla yapılır; bu, Coexistence numaraları için Meta'nın saniyede 20 sınırının altındadır.
- Başarısız bir adım sizi e-postayla bilgilendirir; bu, her otomasyon için 6 saatte en fazla bir kez olur. Reddedilen bir yapay zekâ anahtarı, o sağlayıcıyı kullanan otomasyonları duraklatır ve bir e-posta gönderir.
create_automation aracı neleri alır?
MCP bağlayıcısının otomasyonlar ve onların kullandıkları için on dokuz aracı vardır. Sekizi otomasyonlar içindir: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs ve get_automation_run. Sekizi ajanlar ve dosyalar içindir: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge ve test_agent. Üçü kişiler içindir: list_conversations, get_conversation ve update_contact. create_automation; connection_id (list_numbers ile alınır), name, enabled, trigger, steps ve settings alanlarını alır; keyword_mode ve max_tokens gibi snake_case ile, camelCase da kabul edilir. Adım nesneleri şunlardır: reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} ve wait {minutes}, ardından ask {text, buttons, save_to, expect, retry_text, wait_minutes}, agent {agent_id, wait_seconds}, send_file {file_id, caption}, condition {paths, otherwise}, ai_decide {provider, model, instructions, paths, otherwise}, ai_extract {provider, model, fields}, set_field {key, value}, tag {action, tag}, http_request {method, url, headers, body, save_as}, start_automation {automation_id}, handoff {hours, note}, notify_owner {text}, goto {to} ve stop. update_automation, bıraktığınız alanları korur; steps verildiğinde tüm listeyi değiştirir. Hatalar alanı adlandırır, örneğin “trigger.keywords: En az bir anahtar kelime ekleyin”, “steps.2: Dur hattın son adımı olmalıdır” ya da “steps.0: önce Otomasyonlar sayfasında openai API anahtarınızı kaydedin”. Yapay zekâ anahtarları MCP üzerinden hiçbir zaman geçmez. Örnekte 1 dakikalık Bekle, birden fazla satır gönderen bir müşterinin tek bir yanıt almasını sağlar.
{
"connection_id": "<connection_id from list_numbers>",
"name": "After-hours assistant",
"enabled": false,
"trigger": {
"type": "message_received",
"match": "outside_hours",
"hours": {
"timezone": "America/Sao_Paulo",
"days": [1, 2, 3, 4, 5, 6],
"start": "08:00",
"end": "18:00"
}
},
"steps": [
{ "type": "wait", "minutes": 1 },
{
"type": "ai_reply",
"provider": "openrouter",
"model": "google/gemini-omni-1.2-flash",
"prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
"history": 10,
"max_tokens": 600
}
],
"settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}Yaygın hatalar
- İçerir ile iki harfli bir anahtar kelime kullanmak. “oi” kelimesi “noite” ve “boi” içinde de eşleşir; bu nedenle otomasyon hiç hedeflenmemiş mesajlara yanıt verir. Tam eşleşme kullanın ya da daha uzun bir anahtar kelime seçin.
- Yalnızca aksanlı yazımı listelemek. Eşleşme büyük harfleri yok sayar ama aksanları saymaz; bu nedenle “preço” yazan müşteriler “preco” yazdığında kaçırılır. İkisini de ekleyin.
- İlk mesajın düzenli müşterileri atlayacağını sanmak. Bu otomasyon, easyCoexistence'in 30 gündür görmediği her sohbet için tetiklenir; bu nedenle uzun süredir müşteri olanlar, otomasyonu açtıktan sonraki ilk mesajlarında karşılama mesajı alır.
- Başlık görseli ya da kod kopyalama düğmesi gerektiren bir şablon seçmek. Otomasyonlar yalnızca gövde değişkenlerini doldurur; bu nedenle düzenleyici şablonu listeler ama seçmenize izin vermez. MCP üzerinden ayarlanırsa Meta gönderimi reddeder ve çalıştırma başarısız olur.
easyCoexistence bu otomasyonları, uygulamada kullanmaya devam ettiğiniz WhatsApp Business numarasında, Meta'nın Cloud API'si ve Coexistence üzerinden çalıştırır. Düzenleyicide Otomasyonlar altında Yeni otomasyon ile oluşturun ya da ChatGPT ya da Claude'un MCP bağlayıcısı üzerinden create_automation ve test_automation çağırmasına izin verin; bağlayıcı 30'dan fazla araca sahiptir. Numara başına ayda US$ 9'dan US$ 0.75'e kadar, numara ekledikçe düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
Bir otomasyon müşterinin söylediğine göre dallanabilir mi?
Evet. Yollara ayır (condition) mesaj metnine, bir kişi alanına, bir etikete, önceki bir API yanıtına ya da çalışma saatlerinize göre dallanır; Yapay zekâ yolu seçer (ai_decide) ise kendi modelinizle, her dilde, anlama göre seçer. Her yol kendi adım hattını taşır ve bir Aksi halde hattı geri kalanı karşılar. Kararı ayrıca Webhook'umu çağır ile n8n'e ya da kendi backend'inize bırakabilirsiniz; bu sistem her durum için farklı bir {"reply": "..."} döndürebilir.
Otomasyonlara ya da çalıştırmalara bir sınır var mı?
Çalıştırmalar için sınır yoktur, ekstra ücret de alınmaz; bir numaranın kaç otomasyonu olabileceği konusunda da sınır yoktur. Geçerli sınırlar sohbet bazındadır: saatteki yapay zekâ yanıtları, metin için Meta'nın 24 saat kuralı ve telefondan yanıt verdikten sonra uygulanan duraklatma.
Bir otomasyonu başka bir numaraya taşıyabilir ya da kopyalayabilir miyim?
Taşımak için düzenleyicide Bağlantı'yı değiştirin ya da update_automation ile yeni bir connection_id verin; eski numarada bekleyen çalıştırmalar “yerine geçildi” olarak sona erer. Kopyalamak için yapay zekânızdan list_automations ile okumasını ve aynı tetikleyiciyi ve adımları diğer numarada oluşturmasını isteyin.
Düzenleme yaptığımda bekleyen çalıştırmalara ne olur?
Devam ederler. Bir Bekle adımında bekleyen çalıştırma, uyandığında kaydedilmiş haliyle otomasyonun bir sonraki adım numarasından devam eder; bu nedenle bir düzenleme gönderilen içeriği değiştirebilir. Onları durdurmak için otomasyonu Kapalı konumuna getirin; bu durumda “Otomasyon kapalı” nedeniyle Atlandı olarak sona ererler.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi