Ang gabay sa Submit-Info: gumawa ng form mula sa listahan ng mga tanong, ilathala ito sa WhatsApp at sa web page, iproseso ang mga submission sa mga yugto sa shared na inbox na may mga tungkulin, mag-automate ng mga sagot at tawag sa sarili ninyong mga sistema, at i-set up ang lahat sa pamamagitan ng API o ng AI agent.
Isinusulat ninyo ang form bilang simpleng listahan ng mga tanong. Ginagawa ito ng app2email na form sa loob ng WhatsApp at isang web page na may parehong mga hakbang. Ang customer, o isang miyembro ng sarili ninyong field staff, ang nagpupuno nito at nakakakuha ng reference. Ang mga sagot at file ay nagiging submission sa shared na inbox, kung saan ito dumadaan sa mga yugto ninyo at nagpapatakbo ng mga automation ninyo.
Isang ideya
Form, pagkatapos submission, pagkatapos mga yugto, pagkatapos automation, pagkatapos koneksyon. Ang kahilingan ng quote, aplikasyon, pagbabasa ng metro, ulat ng problema, natapos na trabaho, patunay ng paghahatid at resibo ng gastos ay iisang bagay lang na magkakaiba ang mga tanong at pangalan ng yugto. Bawat isa ay dumarating bilang template na maaari ninyong i-install at baguhin.
Walang nagbabago para sa numerong hindi kailanman nagbubukas ng Submit-Info. Gumagana pa rin ang form na hindi pa nailalathala sa WhatsApp: ang salita nito ay sumasagot ng link ng web page.
Ang form ay may 1 hanggang 12 hakbang, at ang hakbang ay may pamagat at 1 hanggang 12 tanong. Walang canvas at walang iguguhit: ang parehong listahan ang nagpapatakbo ng form sa WhatsApp, ng web page, ng mga pagsusuri sa mga sagot, ng mga hanay ng table view, ng mga export, at ng API. Ang preview sa tabi ng editor ay nagpapakita ng form gaya ng pagkakita ng tao rito.
| Uri | Ang ibinibigay ng tao | Ano ang maitatakda ninyo |
|---|---|---|
text | Maikling sagot | pinakamaikli at pinakamahabang haba, isang pattern |
textarea | Mas mahabang sagot | pinakamaikli at pinakamahabang haba |
number | Isang numero | pinakamababa at pinakamataas na halaga, decimal, isang yunit gaya ng kWh |
email | Isang email address | |
phone | Isang numero ng telepono | |
date | Isang petsa | ilang araw pabalik o pasulong ito maaaring |
select | Isang pagpipilian | ang mga pagpipilian (2 hanggang 200), o isang listahan ninyo |
multiselect | Maraming pagpipilian | ang mga pagpipilian (2 hanggang 20), pinakakaunti at pinakamaraming maaaring piliin |
yesno | Oo o Hindi | |
rating | Isang marka mula 1 hanggang 3-10 | ang pinakamataas na marka |
consent | Isang pangungusap na sasang-ayunan | kung kailangang lagyan ng tsek |
photo | Isa o higit pang larawan | ilan (1 hanggang 10); camera, gallery o alinman |
document | Isa o higit pang file | ilan (1 hanggang 10); anumang file, PDF, mga larawan o office file |
location | Kung nasaan ang tao | sa WhatsApp ang hiling ng lokasyon; sa web ay isang button at linya ng address |
info | Tekstong ipinapakita ninyo | walang tinatanong o itinatago |
hidden | Halagang kasama ng link | gaya ng numero ng trabaho; walang ipinapakita |
{contact.name}.Ang web page. Ang parehong mga hakbang sa /form/your-code/form-key. Hinihingi nito ang pangalan at numero ng WhatsApp sa huli. Pagkatapos magpadala, makikita ng tao ang reference at maaaring mag-tap ng "Get updates on WhatsApp", na nagkukumpirma ng numero nila sa pamamagitan ng isang mensahe; maaaring itakda ang form na hingin ito. Ang personal na link (ipinadala ninyo) ay alam na kung sino ang tao. Para ilagay ang form sa sarili ninyong site, gamitin ang snippet sa ilalim ng Share; kung humihingi ang form ng lokasyon, idagdag ang allow="geolocation" sa iframe. Pinaliliit ang mga larawan sa browser bago i-upload; hanggang 10 MB ang laki ng file.
Sino ang maaaring magpadala. Sinuman (ang karaniwang pinipili), o ang mga numerong inilista ninyo o mga contact na may tag ninyo lamang. Sa ganitong paraan nananatili ang form sa field staff ninyo. Ang salitang status ay sumasagot sa tao ng yugto ng kanilang mga kamakailang submission.
Ang mga yugto ay pag-aari ng form. Ang bagong form ay nagsisimula sa New, In progress at Done; palitan ang pangalan nila, magdagdag ng sarili ninyo (2 hanggang 12), at pumili ng kulay. Bawat yugto ay isa sa tatlong uri: open, done o cancelled.
Ang reply na isinulat sa labas ng oras ng sagot ng WhatsApp ay itinatabi at ihahatid kapag muling sumulat ang tao. Sinasabi ito ng inbox sa reply.
Ipinapakita ng Inbox ang Open, Mine, Unassigned, Done at All, kasama ang mga view na sine-save ninyo. Maghanap at mag-filter ayon sa form, yugto, assignee, tag, channel at petsa. Tatlong layout: listahan, table (isang form: bawat tanong ay isang hanay), at board (isang form: isang hanay para sa bawat yugto). Lagyan ng tsek ang ilang hilera para sabay-sabay baguhin ang yugto, italaga, lagyan ng tag, i-export o burahin ang mga ito.
Ang submission ay nagpapakita ng mga sagot nito, mga file nito, kung saan ito ipinadala, at isang kasaysayan ng lahat ng nangyari dito: mga pagbabago ng yugto kasama kung sino at bakit, mga note, mga reply sa magkabilang direksyon, mga file, at bawat hakbang ng automation kasama ang resulta nito. Sa ibaba, sumusulat kayo ng internal na note o ng reply sa WhatsApp. Maaaring i-export ang anumang view bilang CSV, Excel o JSON, at ang isang submission bilang PDF.
Ang inyong team. Mag-imbita ng mga tao sa pamamagitan ng e-mail sa inbox lamang. Makakakuha sila ng magaan na app na sarili nila sa /desk at hindi nila makikita ang iba pa ng account ninyo. Ang tungkulin ay panimulang hanay ng mga kakayahan, at bawat kakayahan ay maaaring i-on o i-off para sa isang tao.
| Tungkulin | Nagsisimula sa |
|---|---|
| Owner, Admin | Lahat, kasama ang mga form, automation, koneksyon at team |
| Manager | Mga note, reply, pag-edit ng sagot, pagpapalit ng yugto, pag-assign, mga file, pag-export, pagburá, at pagpapatakbo ng mga manual na aksyon |
| Agent | Mga note, reply, pag-edit ng sagot, pagpapalit ng yugto, mga file, at pagpapatakbo ng mga manual na aksyon. Maaaring kunin ng agent ang isang submission para sa sarili |
| Viewer | Makakabasa, wala nang iba |
Maaari ninyo ring paliitin kung ano ang nakikita ng isang tao: ilang form lamang, tanging ang naka-assign sa kanila (kasama o walang mga walang assignee na mapupulot nila), at nakatagong detalye ng contact. Bawat aksyon ng miyembro ng team ay naitatala sa kasaysayan ng submission.
Ang sariling pahina ng tao. Bawat submission ay may pribadong pahina sa /s/a-long-code, nang walang login: ang yugto, ang mga mensahe at pagbabago ng yugto hanggang ngayon, ang bukas ninyong tanong kasama ang mga button nito, at "Add information" kapag pinapayagan ito ng form. Hindi kailanman lumalabas doon ang mga internal na note at internal na field.
Privacy. Ang pagburá ng contact ay bumubura rin ng kanilang mga submission at file. Maaaring magkaroon ng keep-for na oras ang form, pagkatapos nito ay binubura ang mga sarado nang submission.
Ang automation ay binabasa bilang isang pangungusap: kapag may nangyari, kung totoo ang ilang bagay, gawin ang mga ito nang sunud-sunod. "Kapag isinumite ang Quote request, kung ang quantity ay 20 o higit pa, italaga ito sa mga Manager at i-e-mail ang owner."
| Kapag | Tumatakbo kapag |
|---|---|
submitted | kumpleto na ang submission at dumating na ang mga file nito |
status_changed | nagbago ang yugto (opsyonal: patungo o mula sa ilang yugto) |
assigned | nagbago ang taong naka-assign dito |
updated | na-edit ang mga sagot o internal na field |
note_added | may sinulat na note ang miyembro ng team |
file_added | may idinagdag na file pagkatapos |
customer_replied | nagdagdag ng teksto o file ang taong nagpadala |
button | pinindot ng tao ang button ng isa sa mga reply ninyo |
overdue | nasa parehong yugto pa rin ito pagkatapos ng ilang minuto |
due | lumipas na ang takdang oras nito habang bukas ito |
manual | pinipindot ng miyembro ng team ang button ng aksyon sa submission |
Kung: mga tuntunin sa mga sagot, mga kinakalkula na halaga, ang yugto, ang channel, mga tag at ang assignee. Ang tuntunin ay isang field, isang operator at isang halaga: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Pagsamahin ang mga tuntunin gamit ang all (at) o any (o).
| Gawin | Ano ang ginagawa nito |
|---|---|
set_status | ilipat sa isang yugto, may note |
assign | sa isang miyembro, salitan sa isang tungkulin, sa pinakahindi-abalang miyembro ng tungkulin, o sa wala |
set_field, calculate | sumulat ng internal na field, o kalkulahin ito gamit ang pormula |
tag, set_priority, set_due | mga tag, prayoridad, takdang oras |
reply | mensaheng WhatsApp sa tao, may hanggang 3 button na bawat isa ay naglilipat ng yugto, isang file, o ang link sa kanilang status page |
ask_location | hingin sa tao na ibahagi kung nasaan sila |
send_form | magpadala ng follow-up na form; ang ibinalik nito ay ikinakabit sa submission na ito |
email | sa owner, sa assignee, sa tao, o sa anumang address, kasama ang mga naka-attach na file |
notify | e-mail sa assignee, sa isang tungkulin, o sa lahat sa team |
http, openapi, mcp | tumawag sa isang koneksyon at itago ang ilang bahagi ng sagot sa mga field |
wait | magpatuloy mamaya, kung totoo pa rin ang mga kondisyon |
stop | tapusin dito |
Bawat takbo ay naitatala hakbang-hakbang: ano ang ipinadala, ano ang bumalik, at gaano katagal ito inabot. Ang "Try with a submission" ay nagpapatakbo ng automation laban sa totoong submission nang hindi binabago o ipinapadala ang anuman. Ang tawag sa labas na sistemang pumalya ay susubukan ulit pagkatapos ng 1 minuto, 10 minuto at 1 oras; pagkatapos nito, mamarkahang pumalya ang automation at makakatanggap ang mga webhook ninyo ng submit.automation_failed. Ang mga automation na nagpapagana sa isa't isa ay pinapahinto pagkatapos ng tatlong antas.
{
"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
}
]
}Ang quote_amount ay isang internal na field na pinupuno ng team ninyo bago ilipat ang submission sa Quoted. Lalabas lamang ang paalala kung nasa Quoted pa rin ang submission.
{
"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."
}
]
}Ang usage ay kinakalkulang halaga: 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."
}
]
}Ang koneksyon ay isang panlabas na sistemang maaaring tawagan ng automation. Hindi nangangailangan ng anuman ang mga webhook ng account ninyo: tumatanggap sila ng bawat event ng submission habang nangyayari ito (tingnan ang mga event). Para sa lahat ng iba pa, may tatlong uri. Ang "Test" sa isang koneksyon, at ang "Try with a submission" sa isang aksyon, ay nagpapakita ng totoong request at totoong sagot bago may anumang i-on.
Isang base address at isang paraan ng pag-sign in (wala, isang bearer token, isang header, user name at password, o isang key sa address). Sinasabi ng aksyon ang method, ang path, at isang JSON body. Itinatago ng save ang ilang bahagi ng sagot sa mga field ng submission.
{
"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"
}Ibigay ang address ng isang OpenAPI 3 document sa JSON, o i-paste ito. Binabasa ng app2email ang mga operation nito; pinipili ng aksyon ang isa ayon sa id nito at pinupuno ang mga parameter nito. Hindi binabasa ang YAML at Swagger 2 na document.
{
"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"
}Ibigay ang address ng isang MCP server (streamable HTTP) at ang token nito. Inililista ng app2email ang mga tool ng server; pinipili ng aksyon ang isa at pinupuno ang mga argumento nito. Itinatago ng $text ang buong sagot ng tool bilang teksto.
{
"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"
}Magandang malaman. Ang halagang eksaktong isang placeholder ay pinananatili ang uri nito (ang numero ay nananatiling numero, ang listahan ay nananatiling listahan). Ang mga secret ay naka-imbak nang naka-encrypt, hindi na muling ipinapakita at hindi kailanman ibinabalik ng API. Dapat https at pampubliko ang mga address: tinatanggihan ang pribado, lokal at panloob na address, at hindi sinusundan ang mga redirect. Maaaring tumagal ng 15 segundo ang isang tawag at 256 KB ang laki ng sagot nito. Sa save, ang path ay $ (ang buong sagot) o isang simpleng path gaya ng $.data.items[0].id.
Bawat teksto at bawat parameter ng isang aksyon ay maaaring gumamit ng mga placeholder sa mga kulot na bracket. Ang pangalang hindi kilala ay mananatili gaya ng pagkakasulat ninyo rito.
| Placeholder | Nagiging |
|---|---|
{<field key>} | ang sagot sa tanong na iyon (pati internal na field, kinalkulang halaga at mga halagang na-save ng automation) |
{reference} | ang reference, halimbawa MR-7Q3M2A |
{form} {form_key} | ang pangalan ng form at ang key nito |
{status} {status_name} | ang key at pangalan ng yugto |
{channel} | whatsapp, web, api o staff |
{priority} {tags} | ang prayoridad at mga tag |
{created} {updated} {due} | ang mga oras |
{contact.name} {contact.phone} {contact.email} | ang taong nagpadala |
{assignee.name} {assignee.email} | ang miyembro ng team na naka-assign dito |
{link} | ang sariling status page ng tao |
{desk_link} | ang submission sa inbox ng team ninyo |
{answers} | lahat ng sagot bilang mga linyang "Label: halaga" |
{files} {files.<field key>} | mga link sa lahat ng file, o sa mga file ng isang tanong; maaaring kunin ng ibang sistema ang mga ito sa loob ng 7 araw |
{note} | ang note ng pagbabago ng yugto, o ang note na nagpasimula sa automation |
{button} | ang button na pinindot ng tao |
{business} | ang pangalan ng negosyo ninyo |
{submission} | sa JSON body: ang buong submission bilang isang object |
{= formula } | isang pormulang kinakalkula sa lugar, halimbawa {= round(qty * 1.1, 2) } |
Ginagamit ng mga kinakalkulang halaga, ng aksyong calculate, at sa loob ng {= ... } sa anumang teksto. Gumagana ang pormula sa mga numero, mga teksto sa single quote, at mga key ng inyong mga tanong. Maaari itong hanggang 500 karakter ang haba. Ang paghahati sa zero, o numerong nawawala, ay nagbibigay ng walang laman na halaga sa halip na error.
| Isusulat ninyo | Kahulugan |
|---|---|
+ - * / % | aritmetika sa mga numero at sagot |
== != > >= < <= | paghahambing |
and or not ( ) | lohika at mga bracket |
if(condition, a, b) | a kapag totoo ang kondisyon, kung hindi ay b |
min(a, b, ...) max(a, b, ...) | ang pinakamaliit, ang pinakamalaki |
round(x, n) abs(x) | pagbilog sa n decimal, ang laki ng numero nang walang sign |
num(x) len(x) | isang teksto bilang numero; ang haba ng teksto o listahan |
coalesce(a, b) | a, o b kapag walang laman ang a |
lower(x) upper(x) concat(a, b, ...) | mga teksto |
lookup('list', id, 'column') | isang hanay ng isang hilera ng isa sa inyong listahan, halimbawa isang presyo |
previous('field') | ang huling sagot ng parehong tao sa tanong na iyon |
count_files('field') | ilang file ang hawak ng isang tanong |
days_since(date) | ilang araw mula sa isang petsa hanggang ngayon |
Mga halimbawa: qty * lookup('prices', product, 'price') para sa agarang tantiya; reading - previous('reading') para sa paggamit; if(amount > 500, 'manager', 'agent') para magpasya kung sino ang mag-aaprubar.
Ang lahat ng nasa itaas ay nasa REST API sa ilalim ng /v1/{number}/submit, kung saan ang {number} ay ang numero ninyo sa WhatsApp na may country code, mga digit lang. Ipadala ang API key ninyo bilang Authorization: Bearer YOUR_API_KEY (tinatanggap din ang header na X-API-KEY). Kailangan ng key ang scope na submissions:manage; mayroon nito ang mga key na may full access, wala ang Default key. Hindi makakasulat ang sandbox key.
GET /submit/guide: isang JSON document na may buong bokabularyo: mga uri ng tanong kasama ang mga pagpipilian at limitasyon nito, mga tuntunin ng yugto, mga trigger, operator, aksyon kasama ang mga parameter nito, mga placeholder, mga function ng pormula, ang mga template, at mga halimbawang gawa.POST /submit/setup na may "dry_run": true: walang nasusulat; ibinabalik ang bawat problema kasama ang path nito at isang pangungusap kung paano ito ayusin.POST /submit/setup nang walang dry_run: ang mga listahan, koneksyon, form at automation ay sabay-sabay na inilalapat. Kapag may anumang problema, walang nasusulat.POST /submit/forms/{key}/publish, o pangalanan ang mga form sa "publish" ng setup document.GET /submit/forms/{key} ang mga ito), saka basahin ang GET /submit/submissions o makinig sa mga webhook event.I-save ang dokumentong nasa ibaba bilang setup.json at i-post ito. Palitan ang 61400000000 ng numero ninyo. Sinusuri nito ang isang solusyon para sa pagbabasa ng metro: isang listahan ng mga site, isang koneksyon sa billing system, isang form na may tatlong yugto at kinalkulang usage, at dalawang automation. Alisin ang "dry_run": true para ilapat ito. Ang mga umiiral na form, listahan at koneksyon na may parehong key ay papalitan; ang mga automation ay itinutugma ayon sa pangalan sa loob ng form. Ang "preset": "..." sa halip na mga bahagi ay nag-i-install ng isa sa mga template (inililista ng GET /submit/presets ang mga ito).
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"
]
}Ang sagot ng totoong tawag (nang walang 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": []
}GET / PUT /submit/settings.POST /submit/forms/{key}/send para magpadala ng form sa isang numero na may nakapunang mga halaga.PUT /submit/lists/{key} ang mga hilera ng isang listahan.updated_after para sa pag-sync; CSV gamit ang ?format=csv), gumawa, basahin ayon sa id o reference, i-update (yugto, note, prayoridad, assignee, takdang oras, mga tag, sagot, internal na field), magdagdag ng note, mag-reply na may mga button, magdagdag ng file, magburá.POST /submit/automations/try, at ang log ng takbo.Bawat webhook ng account ninyo ay tumatanggap ng bawat event. Bawat isa ay may dalang submission gaya ng pagkakaroon nito sa sandaling iyon; gumagana ang mga link ng file dito sa loob ng 7 araw.
| Event | Kailan |
|---|---|
submission.created | may submission na (maaaring dumarating pa ang mga file nito) |
submission.files_ready | naitabi na ang mga file nito |
submission.updated | nagbago ang mga sagot, internal na halaga, prayoridad, tag o takdang oras |
submission.status_changed | nagbago ang yugto |
submission.assigned | nagbago ang assignee |
submission.note_added | may sinulat na note |
submission.customer_replied | nagdagdag ang tao ng teksto, file o follow-up, o pinindot ang button |
submission.deleted | nabura o nabura nang tuluyan |
submit.automation_failed | sumuko ang isang automation pagkatapos ng mga pag-ulit nito |
Ang bawat route ay isa ring tool sa hosted MCP server ng app2email, kaya kayang gawin ng isang assistant ang buong setup sa isang usapan: 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 at marami pang iba. Magandang unang mensahe sa assistant: "Basahin ang gabay ng Submit-Info, saka mag-set up ng form ng ulat ng problema na may mga larawan at lokasyon, at sabihan ang mga manager ko tungkol sa mga agarang problema."
claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Higit pa sa pagkonekta ng mga assistant at mga tool ng automation: Mga tool at agent ng automation.
| Limitasyon | Halaga |
|---|---|
| Mga form bawat numero | 100 |
| Mga hakbang sa isang form, mga tanong sa isang hakbang | 12 at 12 (60 tanong sa isang form, isang tanong sa lokasyon) |
| Mga listahan | 50, hanggang 1,000 hilera bawat isa |
| Mga automation, koneksyon, miyembro ng team | 200, 30, 200 |
| Mga file sa isang submission | 60 |
| Laki ng file | 25 MB mula sa WhatsApp, 10 MB mula sa web page o API |
| Isang note o reply | 4,000 karakter |
| Mga tag sa isang submission | 20 |
| Mga tawag sa mga sistemang panlabas | 60 kada minuto at 2,000 kada araw bawat numero; 15 segundo at 256 KB bawat tawag |
| Log ng takbo | 30 araw na itinatago |
Ang lahat ng nasa itaas ay itinatakda sa dashboard page ng Submit-Info (/dashboard/app/submit). Mga tanong: support@app2email.com.