Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp-automaatioiden viitemateriaali: laukaisimet, vaiheet, muuttujat ja rajat

easyCoexistence-automaatiot WhatsApp-numerossa käynnistyvät saapuvasta viestistä, kontaktista, joka saa tunnisteen, tai järjestelmäsi kutsusta. Viestillä on neljä vastaavuutta: Jokainen viesti, Sisältää avainsanan, Ensimmäinen viesti ja Aukioloajan ulkopuolella. Sen jälkeen tulee vaiheita, enintään 30 yhdellä linjalla ja 60 yhteensä, haaroineen, kysymyksineen ja tekoälyagentteineen. Viesti saa enintään yhden automaation, ja avainsääntö tulee ensin.

30 steps

Vaiheita yhdellä linjalla, yhteensä 60, haarat sisäkkäin 4 tasoa syvälle; Lopeta ja Palaa vaiheeseen voivat vain päättää linjan.

30 keywords

Automaatiossa jokainen avainsana saa olla enintään 100 merkkiä pitkä. Yksikin riittää, eikä isoilla kirjaimilla ole merkitystä.

20,000

Vastaa tekoälyllä -vaiheen ohjeisiin sallitut merkit; vastaukset rajataan 50–2 000 tokeniin.

1,380 min

Pisin yksittäinen Odota-vaihe on 23 tuntia, jotta seuraava tekstivaihe osuu yhä Metan 24 tunnin ikkunaan.

20 seconds

Aika, jonka webhookisi saa vastata ennen kuin Kutsu omaa webhookia epäonnistuu; vastauksen kenttä reply lähetetään asiakkaalle.

30 days

Ajojen säilytysaika, mukana jokainen käynnistänyt viesti ja vastaus; viestien teksti poistuu valitsemasi säilytysajan jälkeen (30, 90 tai 365 päivää, oletuksena 90).

Mitkä laukaisimet ja vastaavuudet WhatsApp-automaatio voi käyttää?

Pääasiallinen laukaisin, ”Viesti saapuu” (message_received), käynnistyy, kun asiakas kirjoittaa numeroon: teksti, kuvat, video, dokumentit, ääni, tarrat, sijainnit, yhteystiedot, painike- ja listavastaukset sekä tilaukset. Ääniviesti kirjoitetaan tekstiksi OpenAI- tai OpenRouter-avaimellasi ja tallennetaan muodossa ”[voice message]”, jota seuraavat sanat, ja avainsana voi täsmätä niihin; ilman tällaista avainta se jää muotoon ”[voice message]”. Reaktiot, tilapäivitykset ja järjestelmäilmoitukset eivät koskaan käynnistä ajoa, eikä ryhmäkeskusteluja tavoiteta API:n kautta Coexistence-numerossa. Kaksi muuta laukaisinta ei käynnisty viestistä. ”Yhteystieto saa tunnisteen” (tag_added) käynnistyy aina, kun numerolla tavoitettava yhteystieto saa nimeämäsi tunnisteen, automaatiosta, tekoälyagentilta, sinulta Keskusteluissa tai update_contact-työkalulla. ”Järjestelmäsi kutsuu URL-osoitetta” (webhook_received) käynnistyy, kun oma järjestelmäsi lähettää JSON-muotoisen POST-pyynnön puhelinnumerolla automaation URL-osoitteeseen, automaation salaisuus Bearer-tokenina, uudesta tilauksesta tai varauksesta; runko, enintään 20 KB, on käytettävissä muodossa {{vars.webhook.*}}. Molemmissa {{message}} on tyhjä, ja henkilö, joka ei ole kirjoittanut viimeisen 24 tunnin aikana, voi saada vain send_template-viestin. Aikataululaukaisinta ei ole. Viestilaukaisimessa Aukioloaika tarkoittaa, että ”Avoinna” -kohdassa rastitut päivät ovat auki kellonaikojen Alkaa ja Päättyy välillä IANA-aikavyöhykkeellä, kuten America/Sao_Paulo. Päättyy ennen Alkaa on yön yli kestävä vuoro (22:00–06:00), ja rastittamaton päivä on kiinni koko päivän. API:ssa hours-kenttä ottaa timezone, days (1 = maanantai, 7 = sunnuntai, päivät jolloin olet auki) sekä start ja end. Ensimmäinen viesti laukeaa, kun easyCoexistence aloittaa tietueen chatille: asiakkaan ensimmäinen viesti sen jälkeen, kun automaatio on kytketty päälle numerolle, mukaan lukien pitkäaikaiset asiakkaat, tai ensimmäinen viesti 30 hiljaisen päivän jälkeen. Keskustelu, jonka avasit puhelimesta, lasketaan jo nähdyksi.

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.

Miten avainsanatilat vastaavat?

Kohdassa ”Missä sanan pitää olla” Sisältää (”Missä tahansa viestissä”) on oletus, Alkaa on ”Alussa” ja On täsmälleen on ”Koko viestinä”. API:ssa keywordMode on contains, starts_with tai exact. Vastaavuus poistaa viestin ympäriltä välilyönnit ja ei huomioi isoja kirjaimia, mutta huomioi aksentit ja välimerkit. Sisältää vastaa myös pidemmissä sanoissa. ”Testaa”-ruutu avainsanojen alla vastaa ”Ajetaan: osuu” avainsanan kanssa tai ”Ei aja: mikään avainsana ei täsmää” jokaiselle kirjoittamallesi esimerkille.

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?

Mitä kukin vaihe tekee ja mitä kenttiä se ottaa?

Vaiheet ajetaan ylhäältä alas, enintään 30 jonossa ja 60 automaatiossa haarat mukaan lukien, ja vähintään yhden on tehtävä jotain muuta kuin Odota, Lopeta, Jaa poluiksi, Tekoäly valitsee polun ja Palaa vaiheeseen. Haarautuva vaihe sisältää vaiheiden jonon jokaiselle polulle sekä Muuten-jonon, ja haarat sisäkkäistyvät 4 tasoa syvälle. ”Valitse vaihe” -valikossa jokaisella on nimi ja lyhyt rivi, jotka on lainattu alla kuudelle perusvaiheelle. Esitä kysymys (ask) lähettää Viestinsä enintään 10 painikkeella, joista 3 näkyy napautettavina painikkeina ja loput listataan ja niihin vastataan numerolla, odottaa vastausta enintään 1380 minuuttia ja tallentaa sen yhteystiedon kenttään tekstinä, sähköpostina, numerona, puhelinnumerona tai yhtenä painikkeista; väärä vastaus saa kysymyksen uudelleen enintään 3 kertaa. Agentin vastaukset (agent) antaa viestin jollekin tekoälyagenteistasi, Lähetä kuva tai tiedosto (send_file) lähettää kuvan tai PDF-tiedoston tiedostoistasi ja Siirrä ihmiselle (handoff) keskeyttää botin siinä chatissa 1–168 tunniksi, oletuksena 24, ja lähettää sinulle sähköpostia. Jaa poluiksi (condition) ja Tekoäly valitsee polun (ai_decide) haarauttavat säännöillä tai merkityksen mukaan. Tekoäly tallentaa tiedot (ai_extract), Tallenna yhteystietoon (set_field) ja Tunniste (tag) kirjoittavat yhteystiedon kenttiä ja tunnisteita, ja Kutsu rajapintaa (http_request) kutsuu mitä tahansa HTTPS-rajapintaa ja säilyttää sen JSON-vastauksen muodossa {{vars.<name>...}}. Käynnistä automaatio (start_automation) ajaa toisen automaation samalle henkilölle, enintään 3 tasoa syvälle, Palaa vaiheeseen (goto) hyppää vaiheen tunnukseen silmukkaa varten ja Ilmoita minulle (notify_owner) lähettää sinulle sähköpostia, enintään 20 tunnissa automaatiota kohden. Jos vaihe epäonnistuu, sitä seuraavat vaiheet ohitetaan ja ajo päättyy tilaan Failed. Kutsu omaa webhookia lähettää JSON-muotoisen POST-pyynnön, jossa on event ”automation.step”, dry_run, run_id, numero, yhteystieto (wa_id, name), viesti (id, type, text, at) ja enintään 10 chatin viimeisintä viestiä. Pyyntö allekirjoitetaan X-EC-Signature-otsikossa muodossa t=<unix>,v1=<HMAC-SHA256 merkkijonolle ”<t>.<body>”>, vaiheen Allekirjoitusavaimella. URL:n on oltava julkinen HTTPS, eikä uudelleenohjauksia seurata.

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.

Mitkä muuttujat vaiheet voivat täyttää?

Neljä täytetään viestistä, joka käynnisti ajon, kirjoitettuina kaksinkertaisissa aaltosulkeissa; {{contact.<field>}} lisää yhteystiedon kentän (myös contact.name ja contact.phone) ja {{vars.<path>}} aiempien vaiheiden tallentamat tiedot, kuten Kutsu rajapintaa -vaiheen vastauksen. Ne toimivat Vastaa tekstillä -vaiheen Viestissä, viestipohjan runkomuuttujissa, Vastaa tekoälyllä -vaiheen Ohjeissa ja muiden vaiheiden tekstissä, kuten Esitä kysymys -vaiheessa. Viestipohjan muuttujissa ”Lisää:”-palat lisäävät ne. Tuntematon arvo, kuten profiili ilman nimeä, tulee tyhjäksi. Viestipohjalähetykset kantavat vain runkomuuttujia sijainnin mukaan, joten viestipohjaa, jossa on nimettyjä muuttujia, otsikkokuva tai otsikkomuuttuja taikka painike muuttujalla, ei voi vielä valita, ja tyhjä muuttuja saa Metan hylkäämään lähetyksen.

  • {{first_name}}: asiakkaan WhatsApp-profiilin nimen ensimmäinen sana (”Etunimi”).
  • {{name}}: koko profiilinimi (”Koko nimi”).
  • {{message}}: viestin teksti tai sen paikkamerkki, kuten ”[image]” kuvatekstin kanssa (”Heidän viestinsä”).
  • {{phone}}: asiakkaan numero kansainvälisinä numeroina ilman plusmerkkiä, kuten 5511999998888 (”Heidän puhelin”).
  • Testissä asiakas on ”Testiasiakas” ja puhelin 15550000000.

Mitkä asetukset ja oletukset on?

Kaksi asetusta on kohdassa ”Lisäasetukset”, editorin On-kytkimen vieressä olevassa painikkeessa, ja AI-vaiheessa on kaksi omaa. Jätetty kenttä saa oletuksensa sekä editorissa että create_automation-työkalun kautta. Aikarajat ovat kiinteitä eivätkä asetettavissa: tekoälyvastaus saa 45 sekuntia ja webhook 20 sekuntia. Automaation nimi saa olla enintään 120 merkkiä. Tekoälyagentilla on omat asetuksensa: aiemmat viestit, jotka se lukee, 0–40 (oletus 20), pisin vastaus 100–4000 tokenia (oletus 800), enintään 10 työkalukutsua vastausta kohden (oletus 5) ja luovutustunnit, 1–168 (oletus 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.

Mikä automaatio vastaa, kun useampi täsmää?

Enintään yksi, valittuna kiinteässä järjestyksessä: ensin Sisältää avainsanan, sitten Ensimmäinen viesti, sitten Aukioloajan ulkopuolella, sitten Jokainen viesti, ja saman tyypin sisällä vanhin automaatio ensin. Kilpailevat vain automaatiot, jotka ovat päällä eivätkä keskeytettyjä, joten kun avainsääntö on pois päältä tai tekoälyavaimen hylkäämisen vuoksi keskeytetty, kattava sääntö vastaa sen sijaan. Kaksi seurausta yllättää ihmiset. Uusi asiakas, joka kirjoittaa yöllä, saa Ensimmäinen viesti -automaation eikä Aukioloajan ulkopuolella -automaatiota, koska Ensimmäinen viesti on korkeammalla. Ja viesti, johon avainsana-automaatio vastaa, ei koskaan saavuta tekoälyagenttia eikä Vastaa tekoälyllä -vaihetta Jokainen viesti -automaatiossa, joten lisää agentti tai tekoälyvaihe avainsana-automaatioon, jos haluat molemmat. Viesti, joka vastaa avoimeen Esitä kysymys -vaiheeseen, kuuluu tälle kysymykselle, eikä mikään muu automaatio käynnisty siitä. Tunniste- ja webhook-automaatiot käynnistyvät omista tapahtumistaan eivätkä osallistu tähän järjestykseen.

Mitkä suojaukset ovat sisäänrakennettuja?

Ajuri soveltaa näitä ilman mitään asetusta, ja Ajot-välilehden ohitussyyt nimeävät ne, kun ne pysäyttävät ajon:

  • Viesti, jonka Meta toimittaa kahdesti, käynnistää yhden ajon: kaksoiskappaleet pudotetaan viestitunnuksen perusteella.
  • Reaktiot, tilapäivitykset, automaation omat lähetykset ja omat kaikut sovelluksesta eivät koskaan käynnistä ajoa.
  • Vastaa tekstillä, Esitä kysymys, Lähetä kuva tai tiedosto, Vastaa tekoälyllä, agentin vastaus ja webhookin vastaus vaativat, että asiakkaan viimeisin viesti on alle 24 tunnin ikäinen; Lähetä viestipohja ei.
  • Vastaus, jonka kirjoitat WhatsApp Business -sovelluksessa, keskeyttää automaation kyseisessä chatissa, ja siellä odottava ajo ohittaa loput vaiheensa.
  • Uudempi viesti, joka käynnistää saman automaation chatissa, korvaa siinä Odota-vaiheessa yhä odottavan ajon; viesti, joka vastaa avoimeen kysymykseen, menee sen sijaan kyseiselle kysymykselle.
  • Numeron lähetykset ovat vähintään 100 ms välein, alle Metan 20 viestiä sekunnissa Coexistence-numeroille.
  • Epäonnistunut vaihe lähettää sinulle sähköpostia, enintään kerran automaatiota kohden 6 tunnin välein; hylätty tekoälyavain keskeyttää sen palveluntarjoajan automaatiot ja lähettää yhden sähköpostin.

Mitä create_automation-työkalu ottaa?

MCP-liittimessä on yhdeksäntoista työkalua automaatioille ja niiden käyttämille asioille. Kahdeksan on automaatioille: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs ja get_automation_run. Kahdeksan on agenteille ja tiedostoille: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge ja test_agent. Kolme on ihmisille: list_conversations, get_conversation ja update_contact. create_automation ottaa connection_id (list_numbers-työkalusta), name, enabled, trigger, steps ja settings, snake_case-muodossa, kuten keyword_mode ja max_tokens; camelCase kelpaa myös. Vaiheobjektit ovat reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} ja wait {minutes}, sitten 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} ja stop. update_automation säilyttää kentät, jotka jätät pois, ja steps korvaa koko listan, kun se annetaan. Virheet nimeävät kentän, kuten ”trigger.keywords: Add at least one keyword”, ”steps.2: Stop must be the last step of its line” tai ”steps.0: save your openai API key on the Automations page first”. AI-avaimet eivät koskaan kulje MCP:n kautta. Esimerkissä 1 minuutin Odota antaa asiakkaalle, joka lähettää useita rivejä kerralla, yhden vastauksen.

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 }
}

Yleiset virheet

  • Kaksikirjaiminen avainsana Sisältää-tilassa. ”oi” osuu myös sanoihin ”noite” ja ”boi”, joten automaatio vastaa viesteihin, joille sitä ei ollut tarkoitettu. Käytä On täsmälleen -tilaa tai pidempää avainsanaa.
  • Pelkkä aksentoitu kirjoitusasu. Vastaavuus ei huomioi isoja kirjaimia, mutta huomioi aksentit, joten ”preço” ei osu asiakkaisiin, jotka kirjoittavat ”preco”. Lisää molemmat.
  • Odotetaan, että Ensimmäinen viesti ohittaa vakioasiakkaat. Se laukeaa jokaiselle asiakkaalle, jonka chatiä easyCoexistence ei ole nähnyt 30 päivään, joten pitkäaikaiset asiakkaat saavat tervehdyksen ensimmäisellä viestillään sen jälkeen, kun kytket sen päälle.
  • Viestipohjan valitseminen, joka vaatii otsikkokuvan tai kopioi koodi -painikkeen. Automaatiot täyttävät vain runkomuuttujat, joten editori listaa pohjan mutta ei anna valita sitä. MCP:n kautta asetettuna Meta hylkää lähetyksen ja ajo epäonnistuu.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence ajaa nämä automaatiot WhatsApp Business -numerolla, jota käytät sovelluksessa, Metan Cloud API:n ja Coexistencen kautta. Rakenna ne editorissa kohdassa Automaatiot, Uusi automaatio, tai anna ChatGPT:n tai Clauden kutsua create_automation- ja test_automation-työkaluja MCP-liittimen kautta, jossa on yli 30 työkalua. US$ 9 laskien US$ 0,75:een numeroa kohden kuukaudessa, kun numeroita lisätään, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Voiko automaatio haaroittua sen mukaan, mitä asiakas sanoo?

Kyllä. Jaa poluiksi (condition) haarautuu viestin tekstin, yhteystiedon kentän, tunnisteen, aiemman API-vastauksen tai aukioloaikojesi mukaan, ja Tekoäly valitsee polun (ai_decide) valitsee merkityksen mukaan, millä kielellä tahansa, omalla mallillasi. Jokaisella polulla on oma vaiheidensa jono, ja Muuten-jono ottaa loput. Voit myös antaa päätöksen n8n:lle tai omalle backendillesi Kutsu omaa webhookia -vaiheen kautta. Se voi palauttaa eri {"reply": "..."}-vastauksen kullekin tapaukselle.

Onko automaatioille tai ajoille rajaa?

Ajoille ei ole kattoa eikä niistä peritä lisämaksua, eikä automaatioiden määrää numeroa kohden ole rajoitettu. Sovellettavat rajat ovat chatkohtaisia: tekoälyvastaukset tunnissa, Metan 24 tunnin sääntö tekstille ja tauko sen jälkeen, kun vastaat puhelimesta.

Voinko siirtää tai kopioida automaation toiselle numerolle?

Siirrä vaihtamalla sen Yhteys editorissa tai update_automation-työkalulla ja uudella connection_id:llä. Vanhalla numerolla odottavat ajot päättyvät tilaan superseded. Kopioidaksesi pyydä tekoälyä lukemaan se list_automations-työkalulla ja luomaan sama laukaisin ja vaiheet toiselle numerolle.

Mitä odottaville ajoille tapahtuu, kun muokkaan automaatiota?

Ne jatkuvat. Odotuksessa oleva ajo jatkuu automaation seuraavasta vaihenumerosta sellaisena kuin se on tallennettu, kun ajo herää, joten muokkaus voi muuttaa lähetettävää sisältöä. Pysäyttääksesi ne kytke automaatio pois päältä. Silloin ne päättyvät tilaan Skipped ja viestillä ”Automation is off”.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu