app2email API Amanani

Imibhalo

Submit-Info

Umhlahlandlela we-Submit-Info: yakha ifomu ngohlu lwemibuzo, lipublishe ku-WhatsApp nasekhasini lewebhu, sebenzisa izithunyelo ngezimo ku-inbox eyabelwanwe enezindima, zenzekelise izimpendulo nokubiza amasistimu wakho, bese usetha konke nge-API noma nge-agent ye-AI.

Ubhala ifomu njengohlu olulula lwemibuzo. I-app2email iyishintsha ibe yifomu ngaphakathi kwe-WhatsApp nekhasi lewebhu elinezinyathelo ezifanayo. Ikhasimende, noma ilungu lomsebenzi wakho wasensimini, liyigcwalisa bese lithola inkomba. Izimpendulo namafayela kuba isithunyelo ku-inbox eyabelwanwe, lapho sihamba khona ngezimo zakho futhi sivusa ama-automation akho.

Umcabango owodwa

Ifomu, bese isithunyelo, bese izimo, bese ama-automation, bese izixhumo. Isicelo sentengo, isicelo, ukufundwa kwemitha, umbiko wenkinga, umsebenzi owenziwe, ubufakazi bokulethwa nerisidi yokuchitha yonke iyinto efanayo ngemibuzo ehlukile namagama ahlukile ezimo. Yonke ifika njengethempulethi ongayifaka futhi uyishintshe.

Qala ngemizuzu emihlanu

  1. Yivule: kudashibhodi vula ikhasi le-Submit-Info (/dashboard/app/submit, ilivulwa futhi kusuka ku-Integrations). Yivule.
  2. Yenza ifomu: khetha "New form" bese ukhetha ithempulethi, noma uqale ngekhasi elingenalutho. Liniki igama bese ubhala imibuzo yakho. Umbuzo ngamunye ungumugqa oyodwa: umbhalo wawo, uhlobo lwawo, nokuthi kumele uphendulwe yini.
  3. Phublisha: "Publish to WhatsApp" ilayisha ifomu ku-WhatsApp futhi iyenze iphila. Ikhasi lewebhu elinezinyathelo ezifanayo liphila masinyane.
  4. Yabelana: ngaphansi kwe-Share uthola igama elivula ifomu kuchat yakho, isixhumanisi esivula ingxoxo yakho nalelo gama libhalwe kuyo, ikheli lekhasi lewebhu, ikhodi ye-QR, nesiqephu sokufaka ifomu ewebhusayithini yakho.
  5. Sebenza ne-inbox: izithunyelo ezintsha zifika ku-Inbox. Vula eyodwa, shintsha isimo sayo, uphendule. Mema ithimba lakho uma usulungele.

Akukho okushintshayo kunombolo engakaze ivule i-Submit-Info. Ifomu elingakapublishwa ku-WhatsApp okwamanje lisasebenza: igama lalo lipendula ngesixhumanisi sekhasi lewebhu.

Umakhi wefomu

Ifomu linezinyathelo ezi-1 kuya kwezi-12, nesinyathelo ngasinye sinesihloko nemibuzo engu-1 kuya kwengu-12. Akukho canvas nokudweba: uhlu oluyinhloko olufanayo luqhuba ifomu ku-WhatsApp, ikhasi lewebhu, ukuhlola kwezimpendulo, amakholomu ombono wethebula, ukukhipha nge-API. Ukubuka okuseceleni komhleli kukhombisa ifomu njengoba umuntu elibona.

UhloboLokho umuntu akunikezayoOkungasethwa
textImpendulo emfushaneubude obuncane nobude obukhulu kakhulu, ipatheni
textareaImpendulo endeubude obuncane nobude obukhulu kakhulu
numberInomboloinani eliphansi nelikhulu kakhulu, izinhlamvu zedesimali, iyunithi njenge-kWh
emailIkheli le-e-mail
phoneInombolo yocingo
dateUsukuizinsuku ezingakanani emuva noma phambili okuvunyelwe
selectOkukhethwa kukodwaokukhethwayo (2 kuya ku-200), noma uhlu lwakho
multiselectOkukhethwa okuningiokukhethwayo (2 kuya ku-20), okuncane nokukhulu kakhulu okungakhethwa
yesnoYebo noma Cha
ratingAmamaki kusuka ku-1 kuya ku-3-10ibanga eliphezulu kakhulu
consentIsisho sokuvumaukuthi kumele siqokwe yini
photoIsithombe esisodwa noma ezimbalwazingaki (1 kuya ku-10); ikhamera, igalari noma kokubili
documentIfayela elisodwa noma ezimbalwazingaki (1 kuya ku-10); noma yiliphi ifayela, i-PDF, izithombe noma amafayela ehhovisi
locationLapho umuntu ekhonaku-WhatsApp isicelo sendawo; kuwebhu inkinobho nomugqa wekheli
infoUmbhalo obonisiweakukho okubuzwayo noma okugcinwayo
hiddenInani elifika nesixhumanisinjengenombolo yomsebenzi; akukho okuboniswayo
  • Umbhalo wosizo nokuzenzakalelayo: umbuzo ngamunye ungaba nesiphakamiso esifushane, nenani elizenzakalelayo. Inani elizenzakalelayo lingasebenzisa lokho osukwazi kakade, njenge-{contact.name}.
  • Bonisa kuphela uma: isinyathelo noma umbuzo kungancika empendulweni yangaphambili ("bonisa lesi sinyathelo kuphela uma Inkinga ingu-Yes"). I-WhatsApp nekhasi lewebhu zilandela umthetho ofanayo.
  • Amasimu angaphakathi: amasimu angaze abuzwe. Ithimba lakho noma i-automation iwagcwalisa: inani lentengo, isizathu sesinqumo, i-id ebuyile kolunye uhlelo. Abonakala ku-inbox nasekukhipheni kuphela.
  • Izinhlu: umbuzo wokukhetha ungathatha okukhethwayo kuhlu lwakho (amasayithi, imisebenzi, imikhiqizo namanani ayo). Shintsha uhlu ledashibhodi noma nge-API, nefomu liyalandela, kungadingeki ukuphublisha futhi.
  • Amanani abalwayo: ifomula phezu kwezimpendulo, ukuze uthole isilinganiso esisheshayo noma ukuhlola. Bona ifomula.
  • Ngemva kokuthumela: isikrini sokubuyekeza ngaphambi kokuthumela, impendulo enenkomba, inkinobho ethi "Add more" eyengeza imilayezo elandelayo (umbhalo, izithombe, amafayela) esithunyelweni imizuzu eyi-10, nesixhumanisi sekhasi lesimo somuntu siqu.
  • Ukuphublisha: i-app2email ibhalela ifomu le-WhatsApp, ihlukanisa isinyathelo eside ibe izikrini eziningi uma imikhawulo ye-WhatsApp idinga lokho, futhi igcina izinguqulo ezi-5 zokugcina ezipublishiwe ukuze umlayezo omdala usavula ifomu obuthunyelwe ngalo.

Ikhasi lewebhu. Izinyathelo ezifanayo ku-/form/your-code/form-key. Libuza igama nenombolo ye-WhatsApp ekugcineni. Ngemva kokuthumela, umuntu ubona inkomba futhi angathepha "Get updates on WhatsApp", okuqinisekisa inombolo yakhe ngomlayezo owodwa; ifomu lingasethwa ukuthi lidinge lokho. Isixhumanisi somuntu siqu (osithumele wena) sesivele sazi ukuthi ungubani umuntu. Ukuze ufake ifomu ewebhusayithini yakho, sebenzisa isiqephu esingaphansi kwe-Share; uma ifomu libuza indawo, engeza allow="geolocation" ku-iframe. Izithombe ziyancishiswa ebhrawzeni ngaphambi kokulayishwa; ifayela lingaba ngu-10 MB.

Indlela abantu abafinyelela ngayo ifomu

  • Igama: ifomu ngalinye linamagama alo. Amagama form, forms, report nosubmit (ungawashintsha) akhombisa amafomu akho njengemenyu uma kunamafomu amaningi. Igama libalwa kuphela emlayezweni omfushane: owaneminye amagama angaphansi kwangu-10 (Settings, "Ignore the words in long messages"), ngakho umlayezo omude onalo akuqali lutho.
  • Isixhumanisi noma ikhodi ye-QR: isixhumanisi esivula ingxoxo yakho ye-WhatsApp negama lefomu, noma ikheli lekhasi lewebhu.
  • Uthunyelwe nguwe: "Send form" ku-inbox, noma i-API, ithumela ifomu kunombolo eyodwa, inamanani asevele egcwele (inombolo yomsebenzi, i-akhawunti, amadokhumenti ofuna wona).
  • Ukulandelela: i-automation noma ilungu lethimba icela okwengeziwe ngefomu lesibili. Lokho okubuyayo kuxhunyelwa esithunyelweni sokuqala.
  • Ikhasi lewebhu, nokuthi i-API yezinhlelo ezivele zinedatha.

Ubani ongathumela. Noma ubani (okuvame ukukhethwa), noma kuphela izinombolo ozidwebele uhlu noma oxhumana nabo abanethegi yakho. Yilokho okwenza ifomu lihlale nabasebenzi bakho basensimini. Igama status liphendula umuntu ngesimo sezithunyelo zakhe zakamuva.

Izimo

Izimo zibhekisela kufomu. Ifomu elisha liqala nge-New, In progress kanye ne-Done; zishintshe igama, ungeze ezakho (2 kuya ku-12), bese ukhetha umbala. Isimo ngasinye sisodwa kwezintathu: evulekile, eqediwe noma ekhanseliwe.

  • Ubani angakhetha kona: gcina isimo sezindima ezithile. I-Agent ilungiselela, i-Manager kuphela ayigunyaza.
  • Inothi iyadingeka: cela isizathu lapho isithunyelo sidluliselwa khona (kwenqatshiwe, kwalahlwa, kubuzwa).
  • Umlayezo: umbhalo othunyelwa emuntwini uma isithunyelo sakhe sifika kulesi simo, nezindawo ezibambayo.
  • Izinkinobho zomuntu: impendulo ingaba nezinkinobho ezi-3 (Accept, Decline, "Not fixed yet"), nganye iyashintsha isimo. Lolu hlobo olulodwa lunikeza ukwamukelwa kwentengo, ukuqinisekiswa kokuvakasha nokuthi "ulungisiwe yini?".

Impendulo ebhalwe ngaphandle kwesikhathi sokuphendula se-WhatsApp iyagcinwa futhi iyalethwa lapho umuntu esabhala kabusha. I-inbox iyakutshela lokho kwimpendulo.

I-inbox nezindima

I-Inbox ibonisa Open, Mine, Unassigned, Done kanye ne-All, kanye nemibono oyigcinile. Sesha futhi uhlunge ngefomu, isimo, umuthathi, ithegi, indlela nosuku. Izakhiwo ezintathu: uhlu, ithebula (ifomu eyodwa: umbuzo ngamunye uyikholomu) kanye nebhodi (ifomu eyodwa: ikholomu yesimo ngasinye). Khetha imigqa eminingi ukushintsha isimo, ukugabela, ukuthegisa, ukukhipha noma ukususa ndawonye.

Isithunyelo ngasinye sibonisa izimpendulo zaso, amafayela, lapho sathunyelwa khona, nomlando owodwa wakho konke okwenzeke kuso: izinguquko zesimo nomuntu nesizathu sazo, amanothi, izimpendulo ngombili izindlela, amafayela, nezinyathelo zonke ze-automation nemiphumela yazo. Ekugcineni ubhala inothi langaphakathi noma impendulo ye-WhatsApp. Khipha noma yiliphi ibuka njenge-CSV, Excel noma JSON, nesithunyelo esisodwa njenge-PDF.

Ithimba lakho. Mema abantu nge-e-mail ku-inbox kuphela. Bathola uhlelo lwabo oluncane ku-/desk futhi abasoze babone okunye e-akhawunti yakho. Indima iyisethi yokuqala yamakhono, futhi ikhono ngalinye lingavulwa noma livalwe komuntu oyedwa.

IndimaIqala ngalokhu
Owner, AdminKonke, okuhlanganisa namafomu, ama-automation, izixhumo nethimba
ManagerAmanothi, izimpendulo, ukuhlela izimpendulo, ukushintsha isimo, ukugabela, amafayela, ukukhipha, ukususa, ukusebenzisa izenzo ezisesandleni
AgentAmanothi, izimpendulo, ukuhlela izimpendulo, ukushintsha isimo, amafayela, ukusebenzisa izenzo ezisesandleni. Ingazithathela isithunyelo sayo
ViewerIngafunda kuphela, akukho okunye

Ungaphinde unciphise ukuthi umuntu ubona ini: amafomu athile kuphela, okugabelwe kuye kuphela (nokungagabelwanga ukuze akhethe), kanye nemininingwane yoxhumana naye ifihliwe. Yonke into umuntu wethimba ayenzayo ibhalwa emlandweni wesithunyelo.

Ikhasi lomuntu siqu. Isithunyelo ngasinye sinekhasi eliyimfihlo ku-/s/a-long-code, ngaphandle kokungena: isimo, imilayezo nezinguquko zesimo kuze kube manje, umbuzo wakho ovulekile namakhinobho alo, kanye ne-"Add information" uma ifomu livumela lokho. Amanothi angaphakathi namasimu angaphakathi akusoze akhombe lapho.

Ubumfihlo. Ukususa oxhumana naye kususa izithunyelo zakhe namafayela akhe. Ifomu lingaba nesikhathi sokugcina, ngemva kwaso izithunyelo ezivaliwe ziyasulwa.

Ama-automation

I-automation ifundeka njengesisho: uma kwenzeka okuthile, uma izinto ezithile ziqinile, yenza lezi zinto ngokulandelana. "Uma isicelo sentengo sithunyelwe, uma inani lingu-20 noma ngaphezulu, ulinikeze abaphathi bese uletha i-e-mail kumnikazi."

LaphoIyasebenza lapho
submittedisithunyelo sesiphelele namafayela aso sewafika
status_changedisimo sishintshile (ngokukhetha: kuya noma kusuka kwezinye izimo)
assignedumuntu okugabelwe kuye ushintshile
updatedizimpendulo noma amasimu angaphakathi ahleliwe
note_addedilungu lethimba libhalile inothi
file_addedifayela lengezwe kamuva
customer_repliedumuntu owathumela wengeze umbhalo noma amafayela
buttonumuntu ucindezele inkinobho yenye yezimpendulo zakho
overdueisasesimweni esifanayo ngemva kwamaminithi athile
dueisikhathi sokufika sadlula ngesikhathi sivulekile
manualilungu lethimba licindezela inkinobho yesenzo esithunyelweni

Uma: imithetho yezimpendulo, amanani abalwayo, isimo, indlela, amathegi kanye nomuthathi. Umthetho ungumsimu, isisebenzi nenani: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Hlanganisa imithetho nge-all (futhi) noma nge-any (noma).

YenzaYenza ntoni
set_statusilethe esimweni, nenothi
assignkulungu, ngokuphendukela kwendima, kowendima ongasebenzi kakhulu, noma kubani
set_field, calculateibhale insimu yangaphakathi, noma iyibale ngefomula
tag, set_priority, set_dueamathegi, ukubaluleka, isikhathi sokufika
replyumlayezo we-WhatsApp womuntu, nezinkinobho ezi-3 ngayinye eshintsha isimo, ifayela, noma isixhumanisi sekhasi lesimo lakhe
ask_locationcela umuntu ukuthi abelane ngokuthi usaphi
send_formthumela ifomu lokulandelela; lokho okubuyayo kuxhunyelwa kulesi sithunyelo
emailkumnikazi, kumuthathi, kumuntu, noma kunoma yiliphi ikheli, namafayela ehlanganiswe
notifyi-e-mail kumuthathi, kwendima, noma kubo bonke ethimbeni
http, openapi, mcpbiza uxhumo bese ugcina izingxenye zempendulo emasimini
waitqhubeka kamuva, kuphela uma izimo zisekhona
stopyima lapha

Yonke ukusebenza kulotshwa isinyathelo ngesinyathelo: okuthunyelwe, okubuyile, nesikhathi esithathe. "Zama ngesithunyelo" isebenzisa i-automation esithunyelweni sangempela ngaphandle kokushintsha noma ukuthumela lutho. Ukubiza isistimu yangaphandle okuhlulekile kuzanywa futhi emva kwemizuzu eyi-1, emizuzu eyi-10 nehora eli-1; ngemva kwalokho i-automation imakwa njengehlulekile futhi ama-webhook akho athola submit.automation_failed. Ama-automation abizana omunye nomunye aphazanyiswa emazingeni amathathu.

Iresiphi 1: izintengo ezinkulu ziya kumphathi

{
  "name": "Large quotes go to a manager",
  "form": "quote_request",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "all": [
      {
        "field": "quantity",
        "gte": 20
      }
    ]
  },
  "actions": [
    {
      "type": "assign",
      "to": "role:manager"
    },
    {
      "type": "set_priority",
      "priority": "high"
    },
    {
      "type": "email",
      "to": [
        "owner"
      ],
      "subject": "Large quote {reference}",
      "body": "{contact.name} asked for a quote.\n\n{answers}\n\n{desk_link}",
      "attach_files": true
    }
  ]
}

Iresiphi 2: thumela intengo, cela impendulo, ukhumbuze emva kwezinsuku ezintathu

quote_amount ingumsimu wangaphakathi ithimba lakho elikugcwalisa ngaphambi kokuhambisa isithunyelo ku-Quoted. Isikhumbuzo siphuma kuphela uma isithunyelo sisasesimweni se-Quoted.

{
  "name": "Send the quote and ask for an answer",
  "form": "quote_request",
  "enabled": true,
  "trigger": "status_changed",
  "options": {
    "to": [
      "quoted"
    ],
    "from": []
  },
  "conditions": {
    "field": "status",
    "equals": "quoted"
  },
  "actions": [
    {
      "type": "reply",
      "text": "Your quote {reference}: {quote_amount}. Would you like to go ahead?",
      "link": true,
      "buttons": [
        {
          "id": "accept",
          "title": "Accept",
          "set_status": "accepted"
        },
        {
          "id": "decline",
          "title": "Decline",
          "set_status": "declined"
        }
      ]
    },
    {
      "type": "wait",
      "minutes": 4320
    },
    {
      "type": "reply",
      "text": "A reminder about your quote {reference}. Tap Accept or Decline, or write to us with any question."
    }
  ]
}

Iresiphi 3: beka eceleni ukufundwa kwemitha okubonakala kungalungile

usage yinani elibaliwe: reading - previous('reading').

{
  "name": "Query a reading that looks wrong",
  "form": "meter_reading",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "any": [
      {
        "field": "usage",
        "lt": 0
      },
      {
        "field": "usage",
        "gt": 2000
      }
    ]
  },
  "actions": [
    {
      "type": "set_status",
      "status": "queried",
      "note": "Usage {usage} kWh is outside the usual range."
    },
    {
      "type": "notify",
      "to": "role:manager",
      "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
    }
  ]
}

Izixhumo

Uxhumo yisistimu yangaphandle ukuthi i-automation ingayibiza. Ama-webhook e-akhawunti yakho awadingi lutho: azuza wonke amacala ezithunyelweni njengoba enzeka (bona izenzakalo). Kwokunye konke kukhona izinhlobo ezintathu. "Test" kuxhumo, ne-"Zama ngesithunyelo" kwesenzo, zibonisa isicelo sangempela nempendulo yangempela ngaphambi kokuvula noma yini.

Isicelo se-HTTP

Ikheli eliyisisekelo nendlela yokungena (akukho, i-bearer token, i-header, igama lomsebenzisi nephasiwedi, noma ukhiye ekheleni). Isenzo sitshela indlela, indlela ephelele, nebhodi le-JSON. save igcina izingxenye zempendulo emasimini esithunyelo.

{
  "key": "billing",
  "name": "Billing",
  "kind": "http",
  "base_url": "https://billing.example.com/api",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_BILLING_TOKEN"
  },
  "enabled": true
}
{
  "type": "http",
  "connection": "billing",
  "method": "POST",
  "path": "/readings",
  "body": {
    "meter": "{meter_no}",
    "reading": "{reading}",
    "usage": "{usage}",
    "reference": "{reference}",
    "photo": "{files.photo}"
  },
  "save": {
    "billing_id": "$.id"
  },
  "on_fail": "retry"
}

Idokhumenti ye-OpenAPI

Nikeza ikheli ledokhumenti ye-OpenAPI 3 nge-JSON, noma uyiphastele. I-app2email ifunda izinsebenzi zayo; isenzo sikhetha eyodwa ngesi-id sayo bese sigcwalisa izipharamitha zayo. Amadokhumenti e-YAML nango-Swagger 2 awafundwa.

{
  "key": "helpdesk",
  "name": "Helpdesk",
  "kind": "openapi",
  "base_url": "https://helpdesk.example.com/api",
  "spec_url": "https://helpdesk.example.com/openapi.json",
  "auth": {
    "type": "header",
    "name": "X-Api-Token",
    "secret": "YOUR_HELPDESK_TOKEN"
  },
  "enabled": true
}
{
  "type": "openapi",
  "connection": "helpdesk",
  "operation": "createTicket",
  "params": {
    "title": "Problem {reference}: {category}",
    "description": "{description}",
    "reporter": "{contact.phone}"
  },
  "save": {
    "ticket_id": "$.id"
  },
  "on_fail": "retry"
}

I-MCP server

Nikeza ikheli le-MCP server (streamable HTTP) nethokheni yayo. I-app2email ibhala amathuluzi e-server; isenzo sikhetha eyodwa bese sigcwalisa izimpikiswano zayo. $text igcina impendulo yonke yethuluzi njengombhalo.

{
  "key": "dispatch",
  "name": "Dispatch",
  "kind": "mcp",
  "base_url": "https://dispatch.example.com/mcp",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_DISPATCH_TOKEN"
  },
  "enabled": true
}
{
  "type": "mcp",
  "connection": "dispatch",
  "tool": "close_job",
  "arguments": {
    "job_id": "{job}",
    "summary": "{work_done}",
    "minutes": "{time_spent}",
    "photos": "{files.photos}"
  },
  "save": {
    "dispatch_answer": "$text"
  },
  "on_fail": "continue"
}

Okufanele wazi. Inani elingumbambi-sisodwa oqondile ligcina uhlobo lwalo (inombolo ihlala inombolo, uhlu luhlala luyuhlu). Izimfihlo zigcinwa zibethelwe, azisoze zibonakale futhi azisoze zibuyiselwe yi-API. Amakheli kufanele abe ngu-https futhi abe esidlangalaleni: amakheli angasese, endawo nangaphakathi ayenqatshwa, nokuqondisa kabusha akulandelwa. Ukubiza kungathatha amasekhondi angu-15 nempendulo ingaba ngu-256 KB. Ku-save, indlela ingu-$ (impendulo yonke) noma indlela elula njenge-$.data.items[0].id.

Ama-placeholder

Umbhalo ngamunye nepharamitha ngayinye yesenzo ingasebenzisa ama-placeholder ngamabhulaketi agobile. Igama elingaziwa lihlala njengoba ulibhalile.

PlaceholderIbe
{<field key>}impendulo yalowo mbuzo (nasemasimini angaphakathi, namanani abalwayo nezinto ezigciniwe ze-automation)
{reference}inkomba, njengokuthi MR-7Q3M2A
{form} {form_key}igama lefomu nokhiye walo
{status} {status_name}ukhiye wesimo negama laso
{channel}whatsapp, web, api noma staff
{priority} {tags}ukubaluleka namathegi
{created} {updated} {due}izikhathi
{contact.name} {contact.phone} {contact.email}umuntu owathumela
{assignee.name} {assignee.email}ilungu lethimba okugabelwe kuye
{link}ikhasi lesimo somuntu siqu
{desk_link}isithunyelo ku-inbox yethimba lakho
{answers}zonke izimpendulo njengemigqa ethi "Label: value"
{files} {files.<field key>}izixhumanisi zawo wonke amafayela, noma wamafayela wombuzo owodwa; enye isistimu ingawathola izinsuku ezingama-7
{note}inothi lokushintsha isimo, noma inothi elisethe i-automation
{button}inkinobho umuntu ayicindezele
{business}igama lebhizinisi lakho
{submission}esicelweni se-JSON: sonke isithunyelo njengento
{= formula }ifomula esebenza lapho, njengokuthi {= round(qty * 1.1, 2) }

Ifomula

Isetshenziswa ngamanani abalwayo, yisenzo se-calculate, nangaphakathi kwe-{= ... } kunoma yimuphi umbhalo. Ifomula isebenza ngezinombolo, imibhalo ephakathi kwezinkamisa ezisodwa namakhiye emibuzo yakho. Ingaba yizinhlamvu ezingu-500. Ukuhlukanisa ngo-zero, noma inombolo engekho, kunika inani elingenalutho esikhundleni sephutha.

UbhalaKusho
+ - * / %izibalo zezinombolo nezimpendulo
== != > >= < <=ukuqhathanisa
and or not ( )ukucabanga namabhulaketi
if(condition, a, b)a uma imo iqinile, kungenjalo b
min(a, b, ...) max(a, b, ...)okuncane kakhulu, okukhulu kakhulu
round(x, n) abs(x)ukuzungeza kumadesimali angu-n, ubukhulu benombolo ngaphandle kophawu
num(x) len(x)umbhalo njengenombolo; ubude bombhalo noma bohlu
coalesce(a, b)a, noma b uma a ingenalutho
lower(x) upper(x) concat(a, b, ...)imibhalo
lookup('list', id, 'column')ikholomu yomugqa woyedwa wohlu lwakho, njengentengo
previous('field')impendulo yokugcina yalowo muntu kulowo mbuzo
count_files('field')amafayela angaki umbuzo ogcinayo
days_since(date)izinsuku kusuka kusuku kuze kube namuhla

Izibonelo: qty * lookup('prices', product, 'price') ukuze uthole isilinganiso esisheshayo; reading - previous('reading') ukusetshenziswa; if(amount > 500, 'manager', 'agent') ukuze unqume ubani ogunyaza.

Kubathuthukisi nama-agent e-AI

Konke okungenhla kusemhlahlandlweni we-REST API ngaphansi kwe-/v1/{number}/submit, lapho i-{number} iyinombolo yakho ye-WhatsApp enekhodi lezwe, izinombolo kuphela. Thumela ukhiye wakho we-API njenge-Authorization: Bearer YOUR_API_KEY (i-header ethi X-API-KEY nayo iyamukelwa). Ukhiye udinga imvume submissions:manage; okhiye abanokufinyelela okugcwele bayinayo, i-Default key ayinayo. Okhiye be-sandbox abakwazi ukubhala.

  1. GET /submit/guide: idokhumenti eyodwa ye-JSON enegama lonke: izinhlobo zemibuzo namakhetho azo nemikhawulo yazo, imithetho yezimo, izimbangela, izenzo namapharamitha azo, ama-placeholder, imisebenzi yefomula, amathempulethi, nezibonelo ezisebenzayo.
  2. POST /submit/setup nge-"dry_run": true: akukho okubhalwayo; yonke inkinga iyabuyiswa nendlela yayo nomusho ochaza ukuthi ungayilungisa kanjani.
  3. POST /submit/setup ngaphandle kwe-dry_run: uhlu, izixhumo, amafomu nama-automation kusetshenziswa ndawonye. Uma kukhona inkinga, akukho okubhalwayo.
  4. POST /submit/forms/{key}/publish, noma qamba amafomu ku-"publish" yedokhumenti yokusetha.
  5. Yabelana ngezixhumanisi zefomu (GET /submit/forms/{key} ziyazibuyisa), bese ufunda GET /submit/submissions noma ulalele izenzakalo ze-webhook.

Ukubiza konke ukusetha

Gcina idokhumenti engezansi njenge-setup.json bese uyithumela. Shintsha u-61400000000 ube yinombolo yakho. Ihlola isixazululo sokufundwa kwemitha: uhlu lwamasayithi, uxhumo lwesistimu yokubhilisa, ifomu elinezimo ezintathu kanye nokusetshenziswa okubaliwe, namazenzo amabili. Susa "dry_run": true ukuze usebenzise. Amafomu, izinhlu nezixhumo ezinokhiye ofanayo ayathathelwa indawo; ama-automation ahlanganiswa ngegama ngaphakathi kwefomu. "preset": "..." esikhundleni sezingxenye ifaka enye yamathempulethi (GET /submit/presets iwabala).

curl -X POST "https://api.app2email.com/v1/61400000000/submit/setup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @setup.json
{
  "dry_run": true,
  "settings": {
    "enabled": true,
    "config": {
      "business_name": "Northside Energy",
      "default_prefix": "NE"
    }
  },
  "lists": [
    {
      "key": "sites",
      "name": "Sites",
      "items": [
        {
          "id": "north",
          "title": "North depot"
        },
        {
          "id": "south",
          "title": "South depot"
        }
      ]
    }
  ],
  "connections": [
    {
      "key": "billing",
      "name": "Billing",
      "kind": "http",
      "base_url": "https://billing.example.com/api",
      "auth": {
        "type": "bearer",
        "secret": "YOUR_BILLING_TOKEN"
      },
      "enabled": true
    }
  ],
  "forms": [
    {
      "key": "meter_reading",
      "name": "Meter reading",
      "definition": {
        "title": "Meter reading",
        "description": "Send us your reading. It takes about a minute.",
        "prefix": "MR",
        "steps": [
          {
            "key": "reading",
            "title": "Your reading",
            "text": "",
            "show_if": null,
            "fields": [
              {
                "key": "site",
                "type": "select",
                "label": "Site",
                "required": true,
                "list": "sites"
              },
              {
                "key": "meter_no",
                "type": "text",
                "label": "Meter number",
                "help": "Printed on the front of the meter",
                "required": true,
                "max_length": 30
              },
              {
                "key": "reading",
                "type": "number",
                "label": "Reading",
                "required": true,
                "min": 0,
                "decimals": 0,
                "unit": "kWh"
              },
              {
                "key": "photo",
                "type": "photo",
                "label": "Photo of the meter",
                "required": false,
                "max_files": 1,
                "source": "any"
              },
              {
                "key": "billing_id",
                "type": "text",
                "label": "Billing record",
                "internal": true
              }
            ]
          }
        ],
        "stages": [
          {
            "key": "received",
            "name": "Received",
            "kind": "open",
            "color": "blue",
            "set_by": [],
            "require_note": false,
            "message": ""
          },
          {
            "key": "queried",
            "name": "Queried",
            "kind": "open",
            "color": "amber",
            "set_by": [],
            "require_note": true,
            "message": "We have a question about your reading {reference}. We will be in touch."
          },
          {
            "key": "checked",
            "name": "Checked",
            "kind": "done",
            "color": "green",
            "set_by": [],
            "require_note": false,
            "message": ""
          }
        ],
        "who": {
          "mode": "anyone",
          "numbers": [],
          "tag": ""
        },
        "trigger": {
          "words": [
            "meter",
            "reading"
          ],
          "header": "",
          "body": "Tap the button to send your reading.",
          "button": "Open form",
          "footer": ""
        },
        "after": {
          "review_step": true,
          "reply": "Thanks {contact.name}. We have your reading - reference {reference}.",
          "allow_additions": false,
          "status_page": true
        },
        "web": {
          "enabled": true,
          "verify": "optional",
          "ask_email": false,
          "success_text": "Thank you. We have your reading."
        },
        "notify": {
          "email": true,
          "to": [],
          "attach_files": true
        },
        "calculated": [
          {
            "key": "usage",
            "label": "Usage",
            "formula": "reading - previous('reading')",
            "unit": "kWh",
            "decimals": 0
          }
        ],
        "retention_days": 0
      }
    }
  ],
  "automations": [
    {
      "name": "Query a reading that looks wrong",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "any": [
          {
            "field": "usage",
            "lt": 0
          },
          {
            "field": "usage",
            "gt": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "set_status",
          "status": "queried",
          "note": "Usage {usage} kWh is outside the usual range."
        },
        {
          "type": "notify",
          "to": "role:manager",
          "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
        }
      ]
    },
    {
      "name": "Send good readings to billing",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "all": [
          {
            "field": "usage",
            "gte": 0
          },
          {
            "field": "usage",
            "lte": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "http",
          "connection": "billing",
          "method": "POST",
          "path": "/readings",
          "body": {
            "meter": "{meter_no}",
            "reading": "{reading}",
            "usage": "{usage}",
            "reference": "{reference}",
            "photo": "{files.photo}"
          },
          "save": {
            "billing_id": "$.id"
          },
          "on_fail": "retry"
        },
        {
          "type": "set_status",
          "status": "checked",
          "note": "Sent to billing as {billing_id}."
        }
      ]
    }
  ],
  "publish": [
    "meter_reading"
  ]
}

Impendulo yesicelo sangempela (ngaphandle kwe-dry_run):

{
  "success": true,
  "request_id": "req_...",
  "applied": {
    "lists": [
      "sites"
    ],
    "connections": [
      "billing"
    ],
    "forms": [
      "meter_reading"
    ],
    "automations": [
      "Query a reading that looks wrong",
      "Send good readings to billing"
    ],
    "published": [
      "meter_reading"
    ]
  },
  "problems": []
}

Ezinye izindlela

  • Settings: GET / PUT /submit/settings.
  • Forms: uhlu, dala (ngencazelo noma ngethempulethi), funda, buyekeza, susa, phublisha, kanye POST /submit/forms/{key}/send ukuthumela ifomu kunombolo ngamanani agcwele.
  • Lists: PUT /submit/lists/{key} ithatha indawo yemigqa yohlu.
  • Submissions: uhlu (hlunga ngefomu, isimo, umuthathi, ithegi, indlela, oxhumana naye, umbhalo nezinsuku; updated_after ukuvumelanisa; i-CSV nge-?format=csv), dala, funda ngesi-id noma ngenkomba, buyekeza (isimo, inothi, ukubaluleka, umuthathi, isikhathi sokufika, amathegi, izimpendulo, amasimu angaphakathi), engeza inothi, phendula ngezinkinobho, engeza ifayela, susa.
  • Automations and runs: uhlu, dala, funda, buyekeza, susa, POST /submit/automations/try, nelogi yokusebenza.
  • Connections: uhlu, setha, susa, hlola, vuselela, nemisebenzi isenzo esingayibiza.
  • Team and report: mema, buyekeza nesuse amalungu ethimba; izibalo ngefomu, isimo, usuku nomuthathi.

Izenzakalo ze-webhook

Yonke i-webhook ye-akhawunti yakho ithola yonke izenzakalo. Ngayinye ifaka isithunyelo njengoba sinjalo ngalesi sikhathi; izixhumanisi zamafayela kuso zisebenza izinsuku ezingama-7.

IsenzakaloLapho
submission.createdisithunyelo sikhona (amafayela aso angase asafika)
submission.files_readyamafayela aso agciniwe
submission.updatedizimpendulo, amanani angaphakathi, ukubaluleka, amathegi noma isikhathi sokufika sishintshile
submission.status_changedisimo sishintshile
submission.assignedumuthathi ushintshile
submission.note_addedinothi libhalwe
submission.customer_repliedumuntu ungezile umbhalo, amafayela noma ifomu lokulandelela, noma ucindezele inkinobho
submission.deletedkususiwe noma kucinyiwe
submit.automation_failedi-automation iyeke ngemva kwemizamo yayo

Amathuluzi e-MCP

Yonke indlela nayo ingethuluzi kwi-MCP server esiphethwe yi-app2email, ukuze umsizi wenze konke ukusetha engxoxweni eyodwa: get_submit_guide, apply_submit_setup, list_submit_presets, create_form, publish_form, send_form, list_submissions, get_submission, update_submission, reply_to_submission, create_automation, try_automation, set_connection, test_connection nokunye. Umyalezo wokuqala omuhle kumsizi: "Funda umhlahlandlela we-Submit-Info, bese usetha ifomu lombiko wenkinga elinezithombe nendawo, bese utshela abaphathi bami ngezinkinga ezisheshayo."

claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Okwengeziwe ngokuxhumanisa abasizi nezinsiza ze-automation: Amathuluzi e-automation nama-agent.

Imikhawulo

UmkhawuloInani
Amafomu ngenombolo100
Izinyathelo kufomu, imibuzo esinyathelweni12 kanye no-12 (imibuzo engu-60 kufomu, umbuzo wendawo owodwa)
Izinhlu50, ngayinye kuya kumigqa engu-1,000
Ama-automation, izixhumo, amalungu ethimba200, 30, 200
Amafayela esithunyelweni esisodwa60
Usayizi wefayela25 MB kusuka ku-WhatsApp, 10 MB kusuka ekhasini lewebhu noma ku-API
Inothi noma impenduloizinhlamvu ezingu-4,000
Amathegi esithunyelweni20
Ukubiza izinhlelo zangaphandle60 ngomzuzu nama-2,000 ngosuku ngenombolo; amasekhondi angu-15 kanye no-256 KB ngokubiza ngakunye
Logi yokusebenzaigcinwa izinsuku ezingama-30

Akukatholakali okwamanje

  • Ukukhokha esithunyelweni (intengo iyamukelwa, ayikhokhwa).
  • Ukuthumela ifomu kumuntu ongakabhali kuwe emahoreni angama-24 adlule njengefomu le-WhatsApp: esikhundleni salokho uthola isixhumanisi sakhe sewebhu siqu, ukuze usithumele nganoma yiliphi ithempulethi evunyiwe.
  • Izinsayini.
  • Amaqembu aphindwayo ("engeza enye into").
  • Ukudlulela kwelinye ifomu phakathi.
  • Ukugcwalisa ifomu ngaphandle kowexhumo.
  • Ezinye izilimi emibhalweni eqinile yekhasi lewebhu (yonke imibhalo yefomu lakho ngowakho ukuyibhala).
  • Amadokhumenti e-OpenAPI ku-YAML noma Swagger 2, namaseva e-MCP akhuluma kuphela i-transport endala ye-SSE.
  • Ukufunda amanani ezithombeni.

Konke okungenhla kusethwa ku-dashibhodi, ekhasini le-Submit-Info (/dashboard/app/submit). Imibuzo: support@app2email.com.