Referensi otomasi WhatsApp: pemicu, langkah, variabel, dan batas
Otomasi easyCoexistence pada nomor WhatsApp dimulai dari pesan yang masuk, kontak yang mendapat tag, atau panggilan dari sistem Anda. Sebuah pesan memiliki empat kecocokan: “Setiap pesan”, “Ada kata kunci”, “Pesan pertama”, dan “Di luar jam kerja”. Setelah itu ada langkah, hingga 30 dalam satu jalur dan 60 secara keseluruhan, dengan cabang, pertanyaan, dan agen AI. Satu pesan mendapat paling banyak satu otomasi, dengan aturan kata kunci didahulukan.
Langkah dalam satu jalur, 60 secara keseluruhan, cabang bersarang hingga 4 tingkat; Berhenti dan Kembali ke sebuah langkah hanya bisa mengakhiri sebuah jalur.
Per otomasi, hingga 100 karakter untuk setiap kata kunci; satu saja sudah cukup, dan huruf besar tidak berpengaruh.
Karakter yang diizinkan dalam Instruksi langkah Balas dengan AI, yang jawabannya dibatasi 50 hingga 2,000 token.
Langkah Tunggu terpanjang 23 jam, agar langkah teks berikutnya tetap berada dalam jendela layanan pelanggan 24 jam milik Meta.
Waktu yang dimiliki webhook Anda untuk menjawab sebelum Panggil webhook saya gagal; field reply dalam jawaban dikirim ke pelanggan.
Retensi eksekusi, beserta pesan yang memulai tiap eksekusi dan balasannya; teks pesan dihapus setelah retensi yang Anda pilih (30, 90, atau 365 hari, default 90).
Pemicu dan kecocokan apa saja yang bisa dipakai otomasi WhatsApp?
Pemicu utama, “Pesan masuk” (message_received), aktif saat pelanggan menulis ke nomor: teks, foto, video, dokumen, audio, stiker, lokasi, kartu kontak, balasan tombol dan daftar, serta pesanan. Pesan suara ditulis ulang menjadi teks dengan kunci OpenAI atau OpenRouter Anda dan disimpan sebagai “[voice message]” diikuti kata-katanya, yang bisa dicocokkan oleh kata kunci; tanpa kunci tersebut tetap “[voice message]”. Reaksi, status, dan notifikasi sistem tidak pernah memulai eksekusi, dan obrolan grup tidak sampai ke API pada nomor Coexistence. Dua pemicu lain tidak dimulai dari pesan. “Kontak mendapat tag” (tag_added) aktif setiap kali kontak yang terjangkau di nomor mendapat tag yang Anda sebutkan, dari alur, agen AI, Anda di Conversations, atau update_contact. “Sistem Anda memanggil sebuah URL” (webhook_received) aktif saat sistem Anda sendiri melakukan POST JSON berisi nomor telepon ke URL otomasi, dengan secret otomasi sebagai Bearer token, untuk pesanan baru atau pemesanan; isi body, hingga 20 KB, tersedia sebagai {{vars.webhook.*}}. Pada keduanya, {{message}} kosong dan orang yang tidak menulis dalam 24 jam terakhir hanya bisa mendapat send_template. Tidak ada pemicu jadwal. Pada pemicu pesan, Di luar jam kerja memperlakukan hari yang dicentang di “Buka pada” sebagai buka antara Dari dan Sampai, dalam zona waktu IANA seperti America/Sao_Paulo; Sampai yang lebih awal daripada Dari berarti shift malam (22:00 hingga 06:00), dan hari yang tidak dicentang dihitung tutup seharian. Di API, hours berisi timezone, days (1 = Senin hingga 7 = Minggu, hari saat Anda buka), serta start dan end. Pesan pertama aktif saat easyCoexistence membuat catatan untuk obrolan: pesan pertama pelanggan sejak otomasi diaktifkan untuk nomor, termasuk pelanggan lama, atau pesan pertama setelah 30 hari tidak aktif. Obrolan yang Anda buka dari ponsel sudah dihitung sebagai telah dilihat.
Bagaimana mode kata kunci mencocokkan?
Di bawah “Letak kata harus berada”, Mengandung (“Di mana saja dalam pesan”) adalah default, Diawali dengan adalah “Di awal”, dan Sama persis adalah “Seluruh pesan”; di API, keywordMode berisi contains, starts_with, atau exact. Pencocokan memangkas spasi di sekitar pesan dan mengabaikan huruf besar, tetapi tidak mengabaikan aksen atau tanda baca, dan Mengandung juga cocok di dalam kata yang lebih panjang. Kotak “Coba” di bawah Kata kunci menjawab “Dijalankan: cocok” dengan kata kuncinya, atau “Tidak dijalankan: tidak ada kata kunci yang cocok”, untuk contoh apa pun yang Anda ketik.
| 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? |
Apa yang dilakukan tiap langkah, dan field apa yang diterimanya?
Langkah dijalankan dari atas ke bawah, hingga 30 dalam satu jalur dan 60 dalam satu otomasi, termasuk cabang, dan minimal satu harus melakukan sesuatu selain Tunggu, Berhenti, Bagi jalur, AI memilih jalur, dan Kembali ke langkah. Langkah bercabang memiliki satu jalur langkah untuk setiap jalur ditambah jalur Lainnya, dan cabang bisa bersarang hingga 4 tingkat. Pada menu “Pilih langkah”, tiap langkah menampilkan nama dan satu baris singkat, keduanya dikutip di bawah untuk enam langkah dasar. Ajukan pertanyaan (ask) mengirim Pesan-nya dengan hingga 10 tombol, dengan 3 di antaranya tampil sebagai tombol yang bisa diketuk dan sisanya dicantumkan dan dijawab dengan nomor, menunggu jawaban hingga 1.380 menit dan menyimpannya di field kontak sebagai teks, email, angka, nomor telepon, atau salah satu tombol; jawaban yang salah membuat pertanyaan diajukan lagi hingga 3 kali. Jawaban agen (agent) menyerahkan pesan ke salah satu agen AI Anda, Kirim gambar atau file (send_file) mengirim gambar atau PDF dari file Anda, dan Serahkan ke orang (handoff) menjeda bot pada obrolan itu selama 1 hingga 168 jam, 24 jam secara default, dan mengirim email kepada Anda. Bagi jalur (condition) dan AI memilih jalur (ai_decide) bercabang berdasarkan aturan atau berdasarkan makna. AI menyimpan detail (ai_extract), Simpan ke kontak (set_field), dan Tag (tag) menulis field kontak dan tag, dan Panggil API (http_request) memanggil API HTTPS apa pun dan menyimpan jawaban JSON-nya sebagai {{vars.<name>...}}. Mulai otomasi (start_automation) menjalankan otomasi lain untuk orang yang sama, paling dalam 3 tingkat, Kembali ke langkah (goto) melompat ke id langkah untuk mengulang, dan Beri tahu saya (notify_owner) mengirim email kepada Anda, paling banyak 20 per jam per otomasi. Jika sebuah langkah gagal, langkah setelahnya dilewati dan eksekusi berakhir Gagal. Panggil webhook saya mengirim POST JSON dengan event “automation.step”, dry_run, run_id, nomor, kontak (wa_id, name), pesan (id, type, text, at), dan hingga 10 pesan terbaru dari obrolan, ditandatangani di X-EC-Signature sebagai t=<unix>,v1=<HMAC-SHA256 dari “<t>.<body>”> dengan “Signing secret” langkah tersebut. URL-nya harus HTTPS publik, dan pengalihan tidak diikuti.
Variabel apa yang bisa diisi langkah?
Empat diisi dari pesan yang memulai eksekusi, ditulis dalam kurung kurawal ganda; {{contact.<field>}} menambahkan field kontak (juga contact.name dan contact.phone) dan {{vars.<path>}} menambahkan apa yang disimpan langkah sebelumnya, seperti jawaban langkah Panggil API. Variabel ini berfungsi di Pesan pada Balas dengan teks, di variabel body template, di Instruksi Balas dengan AI, dan di teks langkah lain seperti Ajukan pertanyaan; pada variabel template, chip “Sisipkan:” menambahkannya. Nilai yang tidak diketahui, misalnya profil tanpa nama, menjadi kosong. Pengiriman template hanya membawa variabel body, berdasarkan posisi, sehingga template dengan variabel bernama, gambar atau variabel header, atau tombol dengan variabel belum bisa dipilih, dan variabel yang kosong membuat Meta menolak pengiriman.
- {{
first_name}}: kata pertama dari nama profil WhatsApp pelanggan (“Nama depan”). - {{name}}: nama profil lengkap (“Nama lengkap”).
- {{message}}: teks pesan, atau penanda seperti “[image]” ditambah keterangannya (“Pesan mereka”).
- {{phone}}: nomor pelanggan sebagai digit internasional tanpa tanda plus, seperti 5511999998888 (“Telepon mereka”).
- Dalam uji coba, pelanggan adalah “Pelanggan uji” dan telepon adalah 15550000000.
Apa saja pengaturan dan nilai bawaannya?
Dua pengaturan berada di bawah “Lanjutan”, yaitu tombol di samping sakelar Aktif pada editor, dan langkah AI membawa dua pengaturan lagi miliknya sendiri. Field yang dibiarkan kosong mengambil nilai bawaannya, baik di editor maupun lewat create_automation. Batas waktu bersifat tetap, bukan diatur: balasan AI mendapat 45 detik dan webhook 20 detik. Nama otomasi maksimal 120 karakter. Agen AI memiliki pengaturannya sendiri: pesan sebelumnya yang dibaca, 0 hingga 40 (bawaan 20), balasan terpanjang 100 hingga 4.000 token (bawaan 800), hingga 10 panggilan alat per jawaban (bawaan 5), dan jam serah-terima, 1 hingga 168 (bawaan 24).
Otomasi mana yang menjawab bila beberapa cocok?
Paling banyak satu, dipilih dengan urutan tetap: Ada kata kunci lebih dulu, lalu Pesan pertama, lalu Di luar jam kerja, lalu Setiap pesan, dan otomasi tertua lebih dulu dalam jenis yang sama. Hanya otomasi yang Aktif dan tidak dijeda yang bersaing, sehingga jika aturan kata kunci Nonaktif, atau dijeda karena kunci AI ditolak, otomasi tangkap-semua yang menjawab. Dua akibat ini sering mengejutkan. Pelanggan baru yang menulis di malam hari mendapat otomasi Pesan pertama, bukan Di luar jam kerja, karena Pesan pertama berada di peringkat lebih tinggi. Dan pesan yang dijawab otomasi kata kunci tidak pernah sampai ke agen AI atau langkah Balas dengan AI pada Setiap pesan, jadi pasang agen atau langkah AI di dalam otomasi kata kunci jika Anda menginginkan keduanya. Pesan yang menjawab langkah Ajukan pertanyaan yang sedang terbuka menjadi milik pertanyaan itu, dan tidak ada otomasi lain yang dimulai olehnya. Otomasi tag dan webhook dimulai dari peristiwanya sendiri dan tidak ikut dalam urutan ini.
Penjaga apa yang sudah bawaan?
Runner menerapkan ini tanpa pengaturan apa pun, dan alasan dilewati di tab Eksekusi menyebutkannya ketika menghentikan eksekusi:
- Pesan yang dikirim Meta dua kali hanya memulai satu eksekusi: duplikat dibuang berdasarkan id pesan.
- Reaksi, status, pengiriman otomasi itu sendiri, dan gema dari aplikasi Anda tidak pernah memulai eksekusi.
- Balas dengan teks, Ajukan pertanyaan, Kirim gambar atau file, Balas dengan AI, jawaban agen, dan balasan webhook membutuhkan pesan terakhir pelanggan berumur kurang dari 24 jam; Kirim template tidak.
- Balasan yang Anda ketik di aplikasi WhatsApp Business menjeda otomasi pada obrolan itu, dan eksekusi yang menunggu di sana melewati langkah sisanya.
- Pesan baru yang memulai otomasi yang sama pada obrolan menggantikan eksekusi yang masih menunggu di langkah Tunggu pada obrolan itu; pesan yang menjawab pertanyaan yang sedang terbuka masuk ke pertanyaan itu.
- Pengiriman dari sebuah nomor diberi jarak minimal 100 ms, di bawah batas 20 per detik Meta untuk nomor Coexistence.
- Langkah yang gagal mengirim email kepada Anda, paling banyak sekali per otomasi setiap 6 jam; kunci AI yang ditolak menjeda otomasi yang memakai penyedia itu dan mengirim satu email.
Apa yang diterima alat create_automation?
Konektor MCP memiliki sembilan belas alat untuk otomasi dan apa yang digunakannya. Delapan untuk otomasi: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs, dan get_automation_run. Delapan untuk agen dan file: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge, dan test_agent. Tiga untuk orang: list_conversations, get_conversation, dan update_contact. create_automation menerima connection_id (dari list_numbers), name, enabled, trigger, steps, dan settings, dalam snake_case seperti keyword_mode dan max_tokens; camelCase juga diterima. Objek langkahnya adalah reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url}, dan wait {minutes}, lalu 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}, dan stop. update_automation mempertahankan field yang Anda tinggalkan, dan steps, jika diberikan, menggantikan seluruh daftar. Kesalahan menyebut field, seperti “trigger.keywords: Add at least one keyword”, “steps.2: Stop must be the last step of its line”, atau “steps.0: save your openai API key on the Automations page first”. Kunci AI tidak pernah melewati MCP. Dalam contoh, Tunggu 1 menit membuat pelanggan yang mengirim beberapa baris sekaligus mendapat satu jawaban.
{
"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 }
}Kesalahan umum
- Memakai kata kunci dua huruf dengan Mengandung. “oi” juga cocok dengan “noite” dan “boi”, sehingga otomasi menjawab pesan yang tidak dimaksudkan untuknya; gunakan Sama persis, atau kata kunci yang lebih panjang.
- Hanya menulis ejaan dengan aksen. Pencocokan mengabaikan huruf besar tetapi tidak aksen, sehingga “preço” tidak cocok dengan pelanggan yang mengetik “preco”; tambahkan keduanya.
- Mengira Pesan pertama akan melewati pelanggan lama. Pemicu ini aktif untuk pelanggan mana pun yang obrolannya belum dilihat easyCoexistence selama 30 hari, sehingga pelanggan lama mendapat sambutan pada pesan pertama mereka setelah Anda mengaktifkannya.
- Memilih template yang membutuhkan gambar header atau tombol salin kode. Otomasi hanya mengisi variabel body, sehingga editor menampilkannya tetapi tidak membiarkan Anda memilihnya, dan jika diatur lewat MCP, pengiriman ditolak Meta dan eksekusi gagal.
easyCoexistence menjalankan otomasi ini pada nomor WhatsApp Business yang Anda pakai di aplikasi, melalui Cloud API Meta dan Coexistence. Buat di editor pada menu Otomasi, Otomasi baru, atau biarkan ChatGPT atau Claude memanggil create_automation dan test_automation lewat konektor MCP, yang memiliki lebih dari 30 alat. US$ 9 turun hingga US$ 0.75 per nomor per bulan, turun seiring Anda menambah nomor, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah otomasi bercabang berdasarkan apa yang dikatakan pelanggan?
Bisa. Bagi jalur (condition) bercabang berdasarkan teks pesan, field kontak, tag, jawaban API sebelumnya, atau jam buka Anda, dan AI memilih jalur (ai_decide) memutuskan berdasarkan makna, dalam bahasa apa pun, dengan model Anda sendiri. Setiap jalur memiliki jalur langkahnya sendiri, dan jalur Lainnya menangkap sisanya. Anda juga bisa menyerahkan keputusan ke n8n atau backend Anda dengan Panggil webhook saya, yang bisa mengembalikan {"reply": "..."} berbeda untuk tiap kasus.
Apakah ada batas jumlah otomasi atau eksekusi?
Tidak ada batas eksekusi dan tidak ada biaya tambahan untuknya, serta tidak ada batas jumlah otomasi per nomor. Batas yang berlaku bersifat per obrolan: balasan AI per jam, aturan 24 jam Meta untuk teks, dan jeda setelah Anda membalas dari ponsel.
Bisakah saya memindahkan atau menyalin otomasi ke nomor lain?
Pindahkan dengan mengubah Koneksinya di editor, atau dengan update_automation dan connection_id baru; eksekusi yang masih menunggu di nomor lama berakhir sebagai digantikan. Untuk menyalin, minta AI Anda membacanya dengan list_automations lalu membuat pemicu dan langkah yang sama di nomor lain.
Apa yang terjadi pada eksekusi yang menunggu saat saya mengedit otomasi?
Eksekusi itu tetap berjalan. Eksekusi yang berhenti di langkah Tunggu dilanjutkan ke nomor langkah berikutnya dari otomasi sebagaimana tersimpan saat eksekusi bangun, sehingga suntingan dapat mengubah apa yang dikirim. Untuk menghentikannya, nonaktifkan otomasi: eksekusi itu kemudian berakhir Dilewati dengan “Automation is off”.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada