Log masukMulakan percubaan percuma
Meta Tech Provider

Rujukan automasi WhatsApp: pencetus, langkah, pembolehubah dan had

Automasi easyCoexistence pada nombor WhatsApp bermula daripada mesej yang tiba, kenalan yang mendapat tag, atau panggilan daripada sistem anda. Satu mesej mempunyai empat padanan: Setiap mesej, Ada kata kunci, Mesej pertama dan Di luar waktu operasi. Kemudian diikuti langkah, sehingga 30 dalam satu baris dan 60 keseluruhannya, dengan cabang, soalan dan ejen AI. Satu mesej hanya mendapat paling banyak satu automasi, dengan peraturan kata kunci didahulukan.

30 steps

Langkah dalam satu baris, 60 keseluruhannya, cabang bersarang sedalam 4; Berhenti dan Go back to a step hanya boleh menamatkan sesebuah baris.

30 keywords

Bagi setiap automasi, sehingga 100 aksara setiap kata kunci; mana-mana satu sudah memadai dan huruf besar tidak diambil kira.

20,000

Aksara yang dibenarkan dalam Arahan langkah Balas dengan AI, dengan jawapan dihadkan kepada 50 hingga 2,000 token.

1,380 min

Langkah Tunggu terpanjang ialah 23 jam, supaya langkah teks seterusnya masih berada dalam tetingkap 24 jam Meta.

20 seconds

Masa webhook anda perlu menjawab sebelum Panggil webhook saya gagal; medan balasan dalam jawapan dihantar kepada pelanggan.

30 days

Tempoh simpanan larian, dengan setiap mesej permulaan dan balasan; teks mesej dipadam selepas tempoh simpanan yang anda pilih (30, 90 atau 365 hari, lalai 90).

Apakah pencetus dan padanan yang boleh digunakan oleh automasi WhatsApp?

Pencetus utama, “Mesej tiba” (message_received), dicetuskan apabila pelanggan menulis kepada nombor: teks, foto, video, dokumen, audio, pelekat, lokasi, kad kenalan, balasan butang dan senarai, serta pesanan. Nota suara ditulis keluar menggunakan kunci OpenAI atau OpenRouter anda dan disimpan sebagai “[voice message]” diikuti perkataannya, yang boleh dipadankan oleh kata kunci; tanpa kunci sedemikian ia kekal “[voice message]”. Reaksi, status dan notis sistem tidak pernah memulakan larian, dan sembang kumpulan tidak sampai ke API pada nombor Coexistence. Dua pencetus lagi tidak bermula daripada mesej. “Kenalan mendapat tag” (tag_added) dicetuskan setiap kali kenalan yang boleh dihubungi pada nombor mendapat tag yang anda namakan, daripada aliran, ejen AI, anda dalam Conversations atau update_contact. “Sistem anda memanggil URL” (webhook_received) dicetuskan apabila sistem anda sendiri melakukan POST JSON dengan nombor telefon ke URL automasi, dengan rahsia automasi sebagai token Bearer, bagi pesanan baharu atau tempahan; badannya, sehingga 20 KB, tersedia sebagai {{vars.webhook.*}}. Dalam kedua-duanya, {{message}} kosong dan orang yang tidak menulis dalam tempoh 24 jam lepas hanya boleh mendapat send_template. Tiada pencetus jadual. Pada pencetus mesej, Di luar waktu operasi menganggap hari yang ditandai di bawah “Buka pada” sebagai dibuka antara Dari dan Hingga, dalam zon waktu IANA seperti America/Sao_Paulo; Hingga yang lebih awal daripada Dari ialah syif malam (22:00 hingga 06:00), dan hari yang tidak ditanda dikira tertutup sepanjang hari. Dalam API, hours mengambil timezone, days (1 = Isnin hingga 7 = Ahad, hari anda dibuka) serta start dan end. Mesej pertama dicetuskan apabila easyCoexistence memulakan rekod bagi sembang itu: mesej pertama pelanggan sejak automasi diaktifkan pada nombor, termasuk pelanggan lama, atau mesej pertama selepas 30 hari senyap. Sembang yang anda buka dari telefon sudah dikira sebagai telah dilihat.

Every message (any)Runs on whatever the customer writes, when no more specific automation matched.
Has keyword (keyword)Runs when the message holds one of up to 30 keywords, in one of three modes.
First message (first_message)Runs on a chat easyCoexistence has not seen, or after 30 days without a message from that customer.
After hours (outside_hours)Runs while you are closed: Timezone, Open on days, and From and To in 24-hour HH:MM.

Bagaimana mod padanan kata kunci berfungsi?

Di bawah “Di mana perkataan mesti berada”, Mengandungi (“Di mana-mana dalam mesej”) ialah lalai, Bermula dengan ialah “Di awal”, dan Sama tepat ialah “Seluruh mesej”; dalam API, keywordMode ialah contains, starts_with atau exact. Padanan memangkas ruang di sekeliling mesej dan mengabaikan huruf besar, tetapi tidak mengabaikan aksen atau tanda baca, dan Mengandungi juga padan di dalam perkataan yang lebih panjang. Kotak “Uji” di bawah Kata kunci menjawab “Berjalan: sepadan” dengan kata kunci, atau “Tidak berjalan: tiada kata kunci sepadan”, untuk mana-mana contoh yang anda taip.

MatchesDoes not match
Contains "price"What is the price? · PRICES pleaseHow much is it?
Contains "oi"Oi! · Boa noite (inside noite)Olá
Starts with "menu"Menu pleaseCan I see the menu?
Is exactly "menu"Menu · menu with spaces around itmenu? · the menu
Contains "preço"Qual o preço?Qual o preco?

Apa yang dilakukan setiap langkah, dan medan apa yang diambil?

Langkah dijalankan dari atas ke bawah, sehingga 30 dalam satu baris dan 60 dalam satu automasi, termasuk cabang, dan sekurang-kurangnya satu mesti melakukan sesuatu selain Tunggu, Berhenti, Pisahkan kepada laluan, AI memilih laluan dan Kembali ke langkah. Langkah bercabang mempunyai satu baris langkah bagi setiap laluan serta satu baris Jika tidak, dan cabang bersarang sedalam 4 peringkat. Dalam menu “Pilih langkah”, setiap satu memaparkan nama dan baris ringkas, kedua-duanya dipetik di bawah bagi enam langkah asas. Tanya soalan (ask) menghantar Mesej-nya dengan sehingga 10 butang, yang mana 3 dipaparkan sebagai butang yang boleh diketik dan selebihnya disenaraikan serta dijawab dengan nombor, menunggu sehingga 1,380 minit untuk jawapan dan menyimpannya dalam medan kenalan sebagai teks, e-mel, nombor, telefon atau salah satu butang; jawapan yang salah mendapat soalan itu semula sehingga 3 kali. Jawapan ejen (agent) menyerahkan mesej kepada salah satu ejen AI anda, Hantar gambar atau fail (send_file) menghantar gambar atau PDF daripada fail anda, dan Serahkan kepada orang (handoff) menjeda bot pada sembang itu selama 1 hingga 168 jam, 24 secara lalai, dan menghantar e-mel kepada anda. Pisahkan kepada laluan (condition) dan AI memilih laluan (ai_decide) bercabang mengikut peraturan atau mengikut makna. AI menyimpan butiran (ai_extract), Simpan ke kenalan (set_field) dan Tag (tag) menulis medan kenalan dan tag, dan Panggil API (http_request) memanggil mana-mana API HTTPS serta menyimpan jawapan JSON-nya sebagai {{vars.<name>...}}. Mulakan automasi (start_automation) menjalankan automasi lain bagi orang yang sama, sedalam 3 peringkat paling banyak, Kembali ke langkah (goto) melompat ke id langkah untuk berulang, dan Maklumkan saya (notify_owner) menghantar e-mel kepada anda, paling banyak 20 sejam bagi setiap automasi. Jika satu langkah gagal, langkah selepasnya dilangkau dan larian berakhir sebagai Gagal. Panggil webhook saya menghantar POST JSON dengan event “automation.step”, dry_run, run_id, nombor, kenalan (wa_id, name), mesej (id, type, text, at) dan sehingga 10 mesej terkini bagi sembang, ditandatangani dalam X-EC-Signature sebagai t=<unix>,v1=<HMAC-SHA256 bagi “<t>.<body>”> dengan “Rahsia tandatangan” langkah itu. URL-nya mesti HTTPS awam, dan ubah hala tidak diikuti.

Reply with text (reply_text)"Send a fixed message": a Message of up to 4,096 characters, with variables.
Send a template (send_template)"Send an approved template": Template name, Language code, up to 20 body variables by position.
Reply with AI (ai_reply)"Your AI writes the reply": Provider, Model, Instructions, Earlier messages it reads, Longest reply (tokens).
Call my webhook (call_webhook)"Hand off to n8n or your backend": a Webhook URL; {"reply": "..."} returned within 20 seconds is sent.
Wait (wait)"Pause before the next step": 1 to 1,380 Minutes; your reply from the phone skips the rest.
Stop (stop)"End the automation": allowed only as the last step of its line.

Pembolehubah apa yang boleh diisi oleh langkah?

Empat diisi daripada mesej yang memulakan larian, ditulis dalam kurungan berkembar; {{contact.<field>}} menambah medan kenalan (juga contact.name dan contact.phone) dan {{vars.<path>}} menambah apa yang disimpan oleh langkah terdahulu, seperti jawapan langkah Panggil API. Ia berfungsi dalam Mesej bagi Balas dengan teks, dalam pembolehubah badan template, dalam Arahan Balas dengan AI dan dalam teks langkah lain seperti Tanya soalan; dalam pembolehubah template, cip “Masukkan:” menambahkannya. Nilai yang tidak diketahui, seperti profil tanpa nama, menjadi kosong. Penghantaran template hanya membawa pembolehubah badan, mengikut kedudukan, jadi template dengan pembolehubah bernama, gambar pengepala atau pembolehubah pengepala, atau butang yang mempunyai pembolehubah belum boleh dipilih, dan pembolehubah yang kosong menyebabkan Meta menolak penghantaran.

  • {{first_name}}: perkataan pertama nama profil WhatsApp pelanggan (“Nama pertama”).
  • {{name}}: nama profil penuh (“Nama penuh”).
  • {{message}}: teks mesej, atau placeholder-nya seperti “[image]” ditambah kapsyen (“Mesej mereka”).
  • {{phone}}: nombor pelanggan sebagai digit antarabangsa tanpa tanda tambah, seperti 5511999998888 (“Telefon mereka”).
  • Dalam ujian, pelanggan ialah “Pelanggan ujian” dan telefon ialah 15550000000.

Apakah tetapan dan nilai lalainya?

Dua tetapan terletak di bawah “Lanjutan”, butang di sebelah suis Hidup dalam editor, dan langkah AI membawa dua lagi milik sendiri. Medan yang ditinggalkan mengambil nilai lalainya, sama ada dalam editor atau melalui create_automation. Had masa ditetapkan tetap dan tidak boleh diubah: balasan AI mendapat 45 saat dan webhook 20 saat. Nama automasi boleh mengandungi sehingga 120 aksara. Ejen AI mempunyai tetapan sendiri: mesej terdahulu yang dibacanya, 0 hingga 40 (lalai 20), balasan terpanjang 100 hingga 4,000 token (lalai 800), sehingga 10 panggilan alat bagi setiap jawapan (lalai 5) dan jam serahan kepada orang, 1 hingga 168 (lalai 24).

Pause on a chat after I answer it (hours)takeoverHours, 0 to 168, default 4. 0 turns the pause off; a reply still ends a waiting step.
AI replies per chat per hour, at mostaiMaxPerHour, 1 to 60, default 10, counted per chat in a one-hour window.
Earlier messages it readshistory, 0 to 20, default 10, from the messages kept for that chat.
Longest reply (tokens)maxTokens, 50 to 2,000, default 600. An answer that reaches it stops there.
The On and Off switchenabled, default true: a new automation saves On, in the editor and through create_automation.
Try itSamples of up to 2,000 characters, 60 tests per hour in the dashboard.

Automasi mana yang menjawab apabila beberapa padanan berlaku?

Paling banyak satu, dipilih dalam susunan tetap: Ada kata kunci dahulu, kemudian Mesej pertama, kemudian Di luar waktu operasi, kemudian Setiap mesej, dan automasi tertua dahulu dalam jenis yang sama. Hanya automasi yang Hidup dan tidak dijeda yang bersaing, jadi apabila peraturan kata kunci Mati, atau dijeda oleh kunci AI yang ditolak, automasi tangkap semua menjawab sebaliknya. Dua akibat mengejutkan orang. Pelanggan baharu yang menulis pada waktu malam mendapat automasi Mesej pertama, bukan Di luar waktu operasi, kerana Mesej pertama berada di kedudukan lebih tinggi. Dan mesej yang dijawab oleh automasi kata kunci tidak sampai kepada ejen AI atau langkah Balas dengan AI pada Setiap mesej, jadi letakkan ejen atau langkah AI itu di dalam automasi kata kunci jika anda mahu kedua-duanya. Mesej yang menjawab langkah Tanya soalan yang terbuka menjadi milik soalan itu, dan tiada automasi lain bermula daripadanya. Automasi tag dan webhook bermula daripada peristiwa masing-masing dan tidak mengambil bahagian dalam susunan ini.

Apakah pengawal terbina dalam?

Pelari menggunakannya tanpa sebarang tetapan, dan sebab langkau dalam tab Larian menamakannya apabila ia menghentikan larian:

  • Mesej yang dihantar dua kali oleh Meta hanya memulakan satu larian: pendua digugurkan mengikut id mesej.
  • Reaksi, status, penghantaran automasi itu sendiri dan gema anda daripada aplikasi tidak pernah memulakan larian.
  • Balas dengan teks, Tanya soalan, Hantar gambar atau fail, Balas dengan AI, jawapan ejen dan balasan webhook memerlukan mesej terakhir pelanggan berusia kurang daripada 24 jam; Hantar template tidak.
  • Balasan yang anda taip dalam aplikasi WhatsApp Business menjeda automasi pada sembang itu, dan larian yang menunggu di situ melangkau baki langkahnya.
  • Mesej baharu yang memulakan automasi yang sama pada sembang menggantikan larian yang masih menunggu dalam langkah Tunggu; mesej yang menjawab soalan yang terbuka pergi kepada soalan itu sebaliknya.
  • Penghantaran daripada satu nombor diberi jarak sekurang-kurangnya 100 ms, di bawah had 20 sesaat Meta bagi nombor Coexistence.
  • Langkah yang gagal menghantar e-mel kepada anda, paling banyak sekali bagi setiap automasi setiap 6 jam; kunci AI yang ditolak menjeda automasi yang menggunakan pembekal itu dan menghantar satu e-mel.

Apakah yang diambil oleh alat create_automation?

Penyambung MCP mempunyai sembilan belas alat untuk automasi dan apa yang digunakannya. Lapan untuk automasi: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs dan get_automation_run. Lapan untuk ejen dan fail: 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 mengambil connection_id (daripada list_numbers), name, enabled, trigger, steps dan settings, dalam snake_case seperti keyword_mode dan max_tokens; camelCase juga diterima. Objek langkah ialah reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} dan wait {minutes}, kemudian 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 mengekalkan medan yang anda tinggalkan, dan steps, jika diberikan, menggantikan keseluruhan senarai. Ralat menamakan medan, seperti “trigger.keywords: Tambah sekurang-kurangnya satu kata kunci”, “steps.2: Berhenti mesti menjadi langkah terakhir pada barisnya” atau “steps.0: simpan kunci API openai anda di halaman Automasi dahulu”. Kunci AI tidak pernah melalui MCP. Dalam contoh, Tunggu 1 minit membolehkan pelanggan yang menghantar beberapa baris sekaligus mendapat satu jawapan.

create_automation arguments: an after-hours AI assistant, saved Off to test first
{
  "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 }
}

Kesilapan biasa

  • Menggunakan kata kunci dua huruf dengan Mengandungi. “oi” juga padan dengan “noite” dan “boi”, jadi automasi menjawab mesej yang tidak sepatutnya dijawabnya; gunakan Sama tepat, atau kata kunci yang lebih panjang.
  • Hanya menyenaraikan ejaan dengan aksen. Padanan mengabaikan huruf besar tetapi tidak aksen, jadi “preço” terlepas pelanggan yang menaip “preco”; tambah kedua-duanya.
  • Menjangka Mesej pertama melangkau pelanggan tetap. Ia dicetuskan untuk mana-mana pelanggan yang sembangnya tidak pernah dilihat oleh easyCoexistence dalam 30 hari, jadi pelanggan lama mendapat ucapan alu-aluan pada mesej pertama mereka selepas anda mengaktifkannya.
  • Memilih template yang memerlukan gambar pengepala atau butang salin kod. Automasi hanya mengisi pembolehubah badan, jadi editor menyenaraikannya tetapi tidak membenarkan anda memilihnya, dan jika ditetapkan melalui MCP, penghantaran ditolak oleh Meta dan larian gagal.
Menggunakan EasyCoexistence untuk ini

easyCoexistence menjalankan automasi ini pada nombor WhatsApp Business yang anda terus gunakan dalam aplikasi, melalui Cloud API Meta dan Coexistence. Bina dalam editor di bawah Automasi, Automasi baharu, atau biarkan ChatGPT atau Claude memanggil create_automation dan test_automation melalui penyambung MCP, yang mempunyai lebih 30 alat. US$ 9 hingga US$ 0.75 setiap nombor sebulan, menurun apabila anda menambah nombor, dengan 3 hari pertama percuma.

Soalan lazim

Bolehkah automasi bercabang mengikut apa yang pelanggan katakan?

Boleh. Pisahkan kepada laluan (condition) bercabang mengikut teks mesej, medan kenalan, tag, jawapan API terdahulu atau waktu operasi anda, dan AI memilih laluan (ai_decide) memilih mengikut makna, dalam mana-mana bahasa, pada model anda sendiri. Setiap laluan mempunyai barisan langkahnya sendiri, dan satu baris Jika tidak menampung selebihnya. Anda juga boleh menyerahkan keputusan kepada n8n atau pelayan anda melalui Panggil webhook saya, yang boleh memulangkan {"reply": "..."} yang berbeza bagi setiap kes.

Adakah had pada automasi atau larian?

Tiada had pada larian dan tiada caj tambahan untuk larian tersebut, serta tiada had berapa banyak automasi yang boleh dimiliki sesuatu nombor. Had yang terpakai ialah bagi setiap sembang: balasan AI sejam, peraturan 24 jam Meta untuk teks, dan jeda selepas anda membalas daripada telefon.

Bolehkah saya memindahkan atau menyalin automasi ke nombor lain?

Pindahkan dengan menukar Sambungannya dalam editor, atau dengan update_automation dan connection_id baharu; larian yang masih menunggu pada nombor lama tamat sebagai digantikan. Untuk menyalin, mintalah AI anda membaca automasi itu dengan list_automations dan mencipta pencetus serta langkah yang sama pada nombor lain.

Apakah yang berlaku kepada larian yang menunggu apabila saya mengedit automasi?

Ia diteruskan. Larian yang diparkir pada Tunggu disambung semula pada nombor langkah berikutnya bagi automasi seperti yang disimpan apabila larian itu bangun, jadi suntingan boleh mengubah apa yang dihantarnya. Untuk menghentikannya, matikan automasi: mereka kemudian tamat sebagai Dilangkau dengan “Automasi dimatikan”.

Teruskan membaca

Sedia untuk bermula?

Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.

Mulakan Percubaan Percuma

Disahkan pada