Nkuzi Submit-Info: wuo fom site na ndepụta ajụjụ, bipụta ya na WhatsApp na ibe weebụ, rụọ ndabanye site na ọkwa n'igbe ozi a kekọrịtara nwere ọrụ, mee ka azịza na oku gaa na sistemụ gị akpaaka, ma hazie ihe niile site na API ma ọ bụ onye nnọchi AI.
Ị na-ede fom dị ka ndepụta ajụjụ dị mfe. app2email na-agbanwe ya ka ọ bụrụ fom n'ime WhatsApp na ibe weebụ nwere otu nzọụkwụ. Onye ahịa, ma ọ bụ otu n'ime ndị ọrụ ubi gị, na-ejuputa ya ma nata nkeji nchọta. Azịza na faịlụ ndị ahụ na-aghọ ndabanye n'igbe ozi a kekọrịtara, ebe ọ na-aga n'ọkwa gị ma na-akpali akpaaka gị.
Arịrịọ ego, ngwa ọrụ ma ọ bụ ngwa ọrụ ọhụrụ ọ bụla, nke ọ bụla dị ka otu ihe nwere ajụjụ dị iche na aha ọkwa dị iche. Ọ bụla n'ime ha dị dị ka template ị nwere ike iwube ma gbanwee.
Otu echiche
Fom, mgbe ahụ ndabanye, mgbe ahụ ọkwa, mgbe ahụ akpaaka, mgbe ahụ njikọ. Arịrịọ maka ọnụahịa, akwụkwọ ịnata, ọkọlọtọ mmefu, akụkọ nsogbu, ọrụ e mechara, akwụkwọ nnyefe, na akwụkwọ ego ndị a bụ otu ihe ahụ nwere ajụjụ dị iche na aha ọkwa dị iche.
Ọ dịghị ihe na-agbanwe maka nọmba na-enweghị mmeghe Submit-Info. Fom nke a na-ebipụtaghị na WhatsApp ka na-arụ ọrụ: okwu ya na-azaghachi site na njikọ ibe weebụ ahụ.
Fom nwere nzọụkwụ 1 ruo 12, nzọụkwụ ọ bụla nwere aha na ajụjụ 1 ruo 12. Enweghị canvas na enweghị ihe ị ga-adọrọ: otu ndepụta ahụ na-achịkwa fom n'WhatsApp, ibe weebụ, nlele azịza, ahịrị nke mbipụta tebụl, mbupụ na API. Ihe nlele n'akụkụ ihe ndezi na-egosi fom dịka mmadụ si ahụ ya.
| Ụdị | Ihe onye ahụ na-enye | Ihe ị nwere ike ịtọ |
|---|---|---|
text | Azịza mkpụmkpụ | ogologo kasị nta na kasị ukwuu, ụkpụrụ ederede |
textarea | Azịza ogologo karị | ogologo kasị nta na kasị ukwuu |
number | Nọmba | ụkpụrụ kasị nta na kasị ukwuu, ọkwa decimal, otu dịka kWh |
email | Adreesị email | |
phone | Nọmba ekwentị | |
date | Ụbọchị | ole ụbọchị azụ ma ọ bụ n'ihu ka ọ nwere ike ịbụ |
select | Otu nhọrọ | nhọrọ (2 ruo 200), ma ọ bụ ndepụta nke gị |
multiselect | Ọtụtụ nhọrọ | nhọrọ (2 ruo 20), kasị nta na kasị ukwuu a ga-apịa |
yesno | Ee ma ọ bụ Mba | |
rating | Akara site na 1 ruo 3-10 | akara kasị elu |
consent | Okwu a ga-ekwenye | ma a ga-apịa ya ka ọ dị mkpa |
photo | Foto otu ma ọ bụ karịa | ole ọ bụla (1 ruo 10); igwe ọkụ, galeri ma ọ bụ nke ọ bụla |
document | Faịlụ otu ma ọ bụ karịa | ole ọ bụla (1 ruo 10); faịlụ ọ bụla, PDF, foto ma ọ bụ faịlụ ọfịs |
location | Ebe onye ahụ nọ | na WhatsApp, arịrịọ ọnọdụ; na ibe weebụ, bọtịnụ na ahịrị adreesị |
info | Ederede ị na-egosi | a naghị ajụ ma ọ naghị echekwa ihe ọ bụla |
hidden | Uru na-abịa na njikọ | dịka nọmba ọrụ; a naghị egosi ihe ọ bụla |
{contact.name}.Ibe weebụ. Otu nzọụkwụ ahụ na /form/your-code/form-key. Ọ na-arịọ aha na nọmba WhatsApp n'ikpeazụ. Mgbe izipu, onye ahụ na-ahụ nkeji nchọta wee nwee ike ịpị "Get updates on WhatsApp", nke na-ekwenye nọmba ya site na otu ozi; a ga-ahọrọ fom ka ọ chọọ nke a. Njikọ onwe (nke ị zipụrụ) already maara onye ahụ ọ bụ. Iji tinye fom ahụ n'weebụsaịtị gị, jiri ihe a na-etinye n'okpuru Share; ọ bụrụ na fom na-arịọ ọnọdụ, tinye allow="geolocation" na iframe. A na-eme foto ka ha dị obere n'ụzụ ntanetị tupu a bulite ha; faịlụ nwere ike ịbụ ruo 10 MB.
Onye nwere ike izipu. Onye ọ bụla (nhọrọ a na-ahọrọ nke ukwuu), ma ọ bụ naanị nọmba ndị ị depụtara ma ọ bụ kọntaktị nwere tag nke gị. Nke a bụ otu fom ji nọgide na ndị ọrụ ubi gị. Okwu status na-azaghachi onye ahụ site na ọkwa ndabanye ya nke ọ bụla nke na-adịbeghị anya.
Ọkwa bụ nke fom. Fom ọhụrụ na-amalite na New, In progress na Done; gbanwee aha ha, tinye nke gị (2 ruo 12), ma họrọ agba. Ọkwa ọ bụla bụ otu n'ime ụdị atọ: open, done ma ọ bụ cancelled.
Azịza a dere n'èzí oge azịza WhatsApp na-echekwa ma na-enyefe mgbe onye ahụ dere ọzọ. Igbe ozi na-ekwu otu ihe ahụ na azịza ahụ.
Inbox na-egosi Open, Mine, Unassigned, Done na All, yana echiche ị chekwara. Chọọ ma sịfụta site na fom, ọkwa, onye e kenyere, tag, ụzọ na ụbọchị. Ụdị atọ: ndepụta, tebụl (otu fom: ajụjụ ọ bụla bụ kolụm) na board (otu fom: kolụm maka ọkwa ọ bụla). Mkpọrọ ọtụtụ ahịrị iji gbanwee ọkwa, kenye, tag, bupụta ma ọ bụ hichapụ ha n'otu oge.
Ndabanye ọ bụla na-egosi azịza ya, faịlụ ya, ebe a si ziga ya, na otu akụkọ nke ihe niile mere ya: mgbanwe ọkwa na onye na ihe kpatara ya, ndetu, azịza n'akụkụ abụọ, faịlụ, na nzọụkwụ akpaaka ọ bụla na nsonaazụ ya. N'ala, ị na-ede ma ndetu dị n'ime ma ọ bụ azịza WhatsApp. Bupụta echiche ọ bụla dị ka CSV, Excel ma ọ bụ JSON, na otu ndabanye dị ka PDF.
Ndị otu gị. Kpọọ ndị mmadụ site na email ka ha nwee naanị igbe ozi. Ha na-enweta app dị mfe nke nwere onwe ya n'ebe /desk ma ọ hụghị akaụntụ gị ndị ọzọ. Ọrụ bụ otu ọdịnala nke ikike, ma e nwere ike ịgbanwe ikike ọ bụla maka otu onye.
| Ọrụ | Na-amalite na |
|---|---|
| Onye nwe, Admin | Ihe niile, gụnyere fom, akpaaka, njikọ na ndị otu |
| Manager | Ndetu, azịza, ndezi azịza, mgbanwe ọkwa, ikenye, faịlụ, bupụta, hichapụ, ịgba akpaaka n'aka |
| Agent | Ndetu, azịza, ndezi azịza, mgbanwe ọkwa, faịlụ, ịgba akpaaka n'aka. Nwere ike iwere ndabanye maka onwe ya |
| Viewer | Nwere ike ịgụ, naanị nke ahụ |
Ị nwere ikwu ihe onye ọ bụla hụrụ: naanị fom ụfọdụ, naanị ihe e kenyere ya (na ma ọ bụ na-enweghị ndị e kenyeghị ka ha nwee ike ịnara), na nzọụkwụ kọntaktị zoro. Onye otu ọ bụla na-ekwu ihe ọ bụla na akụkọ ndabanye.
Ibe nke onye ahụ. Ndabanye ọ bụla nwere ibe nzuzo na /s/a-long-code, enweghị ịbanye: ọkwa, ozi na mgbanwe ọkwa ruo ugbu a, ajụjụ gị meghere nwere bọtịnụ ya, na "Add information" mgbe fom kwere ka ọ dị. Ndetu dị n'ime na ubi dị n'ime adịghị mgbe na-anọ n'ibe a.
Nzuzo. Ihichapụ kọntaktị na-ehichapụ ndabanye na faịlụ ya. Fom nwere ike nwee oge echekwa, mgbe ahụ a na-ehichapụ ndabanye emechiri.
Akpaaka ọ bụla na-agụ dị ka ahịrịokwu: mgbe ihe ụfọdụ mere, ọ bụrụ ihe ụfọdụ bụ eziokwu, mee ihe ndị a n'usoro. "Mgbe a na-ezipu Quote request, ọ bụrụ na quantity bụ 20 ma ọ bụ karịa, kenye ya Managers wee zipu email gaa onye nwe."
| Mgbe | Na-agba ọsọ mgbe |
|---|---|
submitted | ndabanye zuru ezu ma faịlụ ya abataala |
status_changed | ọkwa gbanwere (nhọrọ: gaa na ma ọ bụ site n'ọkwa ụfọdụ) |
assigned | onye a kenyere ya gbanwere |
updated | azịza ma ọ bụ ubi dị n'ime dezigharịrị |
note_added | otu n'ime ndị otu dere ndetu |
file_added | e tinyere faịlụ mgbe e mesịrị |
customer_replied | onye zigara ya tinyere ederede ma ọ bụ faịlụ |
button | onye ahụ pịarịrị otu bọtịnụ nke azịza ị nyere |
overdue | ọ ka nọ n'otu ọkwa mgbe oge nke ọnụọgụgụ nkeji gasịrị |
due | oge ya ruru mgbe ọ na-emeghe |
manual | otu n'ime ndị otu pịrị bọtịnụ omume ahụ na ndabanye ahụ |
Ọ bụrụ: iwu maka azịza, uru a gbakọtara, ọkwa, ụzọ, tag na onye a kenyere ya. Iwu bụ ubi, onye ọrụ na uru: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Jikọọ iwu site na all (na) ma ọ bụ any (ma ọ bụ).
| Mee | Ihe ọ na-eme |
|---|---|
set_status | bufere ya gaa n'ọkwa, na ndetu |
assign | gaa n'otu onye, n'usoro site n'ọrụ, gaa n'onye na-enwe obere ọrụ nke ọrụ, ma ọ bụ gaa n'onye ọ bụla |
set_field, calculate | dee ubi dị n'ime, ma ọ bụ gbakọta ya site na usoro |
tag, set_priority, set_due | tags, mkpa, oge ịga |
reply | ozi WhatsApp gaa onye ahụ, nwere bọtịnụ ruo 3 nke ọ bụla na-agbanwe ọkwa, faịlụ, ma ọ bụ njikọ ibe ọkwa ya |
ask_location | jụọ onye ahụ ka ọ kekọrịta ebe ọ nọ |
send_form | zipu fom nke ọzọ; ihe na-alaghachi na-esonyere ndabanye a |
email | gaa onye nwe, onye e kenyere ya, onye ahụ, ma ọ bụ adreesị ọ bụla, faịlụ na-esonyere |
notify | email gaa onye e kenyere ya, ọrụ, ma ọ bụ ndị otu niile |
http, openapi, mcp | kpọọ njikọ ma debe akụkụ azịza n'ubi |
wait | gaa n'ihu mgbe e mesịrị, naanị ọ bụrụ na ọnọdụ ka dị |
stop | kwụsị ebe a |
A na-edekọ onye ọ bụla n'usoro: ihe ezipụrụ, ihe laghachiri, ogologo oge ọ were. "Try with a submission" na-agba akpaaka n'ime ndabanye n'ezie na-enweghị ịgbanwe ma ọ bụ izipu ihe ọ bụla. Oku gaa sistemụ a na-adịghị mma na-anwale ọzọ mgbe nkeji 1, nkeji 10 na awa 1; mgbe ahụ akpaaka ahụ bụ ihe na-adaghị ma webhook gị natakwa submit.automation_failed. Akpaaka ndị na-akpali onwe ha na-akwụsị mgbe ọkwa atọ.
{
"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
}
]
}quote_amount bụ ubi dị n'ime ndị otu gị na-ejuputa tupu ha ebufee ndabanye ahụ gaa Quoted. Ndetu ahụ na-apụta naanị ma ọ bụrụ na ndabanye ka nọ na 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."
}
]
}usage bụ uru a gbakọtara: 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."
}
]
}Njikọ bụ sistemu a na-èwe ịga nke akpaaka nwere ike ịkpọ. Webhook nke akaụntụ gị achọghị ya: ha na-anata ihe omume ndabanye ọ bụla ka ọ na-eme (lee ihe omume). Maka ihe ndị ọzọ, enwere ụdị atọ. "Test" na njikọ, na "Try with a submission" na omume, na-egosi arịrịọ n'ezie na azịza n'ezie tupu a tinye ihe ọ bụla.
Adreesị isi na ụzọ ịbanye (enweghị, bearer token, akara, aha onye ọrụ na paswọọdụ, ma ọ bụ igodo n'adreesị). Omume ahụ na-akọ usoro (method), ụzọ (path), na ahụ JSON. save na-echekwa akụkụ azịza n'ubi nke ndabanye.
{
"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"
}Nye adreesị nke akwụkwọ OpenAPI 3 n'ụdị JSON, ma ọ bụ tinye ya. app2email na-agụ ọrụ ya; omume ahụ na-ahọrọ otu site na id ya wee tinye parameters ya. A naghị agụ akwụkwọ YAML na Swagger 2.
{
"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"
}Nye adreesị nke MCP server (streamable HTTP) na token ya. app2email na-edepụta ngwa ọrụ server ahụ; omume ahụ na-ahọrọ otu n'ime ha wee tinye arguments ya. $text na-echekwa azịza zuru ezu nke ngwa ọrụ ahụ dịka ederede.
{
"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"
}Ihe ị kwesịrị ịma. Uru nke nwere naanị otu placeholder na-echekwa ụdị ya (nọmba na-anọgide nọmba, ndepụta na-anọgide ndepụta). A na-echekwa nzuzo n'ụzọ nzuzo, a naghị egosi ya ọzọ ma API anaghị eweta ya. Adreesị ga-abụ https na nke ọha: adreesị nke ime, nke mpaghara na nke ndị ọzọ a na-ajụ, a naghịkwa agbasọ mgbanaka. Oku nwere ike were sekọnd 15 ma azịza nwere ike ịbụ 256 KB. Na save, ụzọ bụ $ (azịza niile) ma ọ bụ ụzọ dị mfe dịka $.data.items[0].id.
Ederede ọ bụla na parameter ọ bụla nke omume nwere ike iji placeholders n'akpụkpọ ọnụ ọkwa. Aha a na-amaghị ka ọ na-anọgide dịka ị dere ya.
| Placeholder | Ọ na-aghọ |
|---|---|
{<field key>} | azịza nke ajụjụ ahụ (ubi dị n'ime, uru a gbakọtara na uru akpaaka chekwara) |
{reference} | nkeji nchọta, dịka MR-7Q3M2A |
{form} {form_key} | aha fom na key ya |
{status} {status_name} | key ọkwa na aha ya |
{channel} | whatsapp, web, api ma ọ bụ staff |
{priority} {tags} | mkpa na tags |
{created} {updated} {due} | oge |
{contact.name} {contact.phone} {contact.email} | onye zigara ya |
{assignee.name} {assignee.email} | onye otu e kenyere ya |
{link} | ibe nke onye ahụ nwere onwe ya |
{desk_link} | ndabanye n'igbe ozi ndị otu gị |
{answers} | azịza niile dịka ahịrị "Label: value" |
{files} {files.<field key>} | njikọ nke faịlụ niile, ma ọ bụ nke faịlụ otu ajụjụ; sistemụ ọzọ nwere ike ịchọta ha ruo ụbọchị 7 |
{note} | ndetu mgbanwe ọkwa, ma ọ bụ ndetu nke kpalitere akpaaka ahụ |
{button} | bọtịnụ onye ahụ pịrị |
{business} | aha azụmahịa gị |
{submission} | n'ahụ JSON: ndabanye niile dịka object |
{= formula } | usoro a na-agbakọta n'ebe ahụ, dịka {= round(qty * 1.1, 2) } |
A na-eji ya maka uru a gbakọtara, maka omume calculate, na n'ime {= ... } n'ederede ọ bụla. Usoro na-arụ ọrụ na nọmba, ederede n'etiti single quotes na key nke ajụjụ gị. Ọ nwere ike ịdị ogologo mkpụrụedemede 500. Ikewa site na efu, ma ọ bụ nọmba na-efu, na-enye uru efu kama njehie.
| Ihe ị dere | Ihe ọ pụtara |
|---|---|
+ - * / % | mgbakọ na nọmba na azịza |
== != > >= < <= | ntụnyere |
and or not ( ) | mgbagha na mgbanaka |
if(condition, a, b) | a mgbe ọnọdụ ahụ bụ eziokwu, ma ọ bụghị b |
min(a, b, ...) max(a, b, ...) | nke kacha nta, nke kacha ukwuu |
round(x, n) abs(x) | mgbakọ na n decimal, ibu nke nọmba na-enweghị akara |
num(x) len(x) | ederede dịka nọmba; ogologo nke ederede ma ọ bụ ndepụta |
coalesce(a, b) | a, ma ọ bụ b mgbe a efu |
lower(x) upper(x) concat(a, b, ...) | ederede |
lookup('list', id, 'column') | kolụm nke otu ahịrị nke otu ndepụta gị, dịka ọnụahịa |
previous('field') | azịza ikpeazụ onye ahụ nyere maka ajụjụ ahụ |
count_files('field') | ole faịlụ ajụjụ ahụ nwere |
days_since(date) | ụbọchị site na ụbọchị ruo taa |
Ihe atụ: qty * lookup('prices', product, 'price') maka nlele ngwa ngwa; reading - previous('reading') maka ojiji; if(amount > 500, 'manager', 'agent') iji kpebie onye ga-anabata.
Ihe niile dị n'elu dị na REST API n'okpuru /v1/{number}/submit, ebe {number} bụ nọmba WhatsApp gị nwere koodu mba, naanị ọnụọgụgụ. Zipu igodo API gị dịka Authorization: Bearer YOUR_API_KEY (a na-anabatakwa isi X-API-KEY). Igodo chọrọ ikike submissions:manage; igodo nwere ohere zuru ezu nwere ya, igodo Default enweghị ya. Igodo sandbox enweghị ike ide ihe.
GET /submit/guide: akwụkwọ JSON otu ihe nke okwu niile: ụdị ajụjụ na nhọrọ ha na oke, iwu ọkwa, ihe kpalitere, ọrụ, parameters ha, placeholders, ọrụ usoro, template, na ihe atụ ndị e mere.POST /submit/setup na "dry_run": true: a naghị ede ihe ọ bụla; nsogbu niile na-alaghachi na path ya na otu ahịrịokwu na-akọwa otu esi edozi ya.POST /submit/setup na-enweghị dry_run: ndepụta, njikọ, fom na akpaaka na-etinye ọnụ. Ọ bụrụ na nsogbu ọ bụla dị, a naghị ede ihe ọ bụla.POST /submit/forms/{key}/publish, ma ọ bụ kpọọ fom ndị ahụ n'ime "publish" nke akwụkwọ nhazi.GET /submit/forms/{key} na-alaghachi ha), mgbe ahụ gụọ GET /submit/submissions ma ọ bụ gee ntị n'ihe omume webhook.Chekwaa akwụkwọ dị n'okpuru dịka setup.json wee zipu ya. Dochie 61400000000 ka nọmba gị. Ọ na-enyocha ngwọta ọkọlọtọ ọnụọgụgụ ọkwa ọrụ: ndepụta saịtị, njikọ gaa sistemu ịpụta ego, otu fom nwere ọkwa atọ na usage agbakọtara, na akpaaka abụọ. Wepụ "dry_run": true iji tinye ya. Fom, ndepụta na njikọ ndị nwere otu key ga-edochi ndị ochie; akpaaka a na-atụnyere site na aha n'ime fom. "preset": "..." n'ọnọdụ akụkụ ahụ na-etinye otu n'ime template (GET /submit/presets na-edepụta ha).
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"
]
}Azịza nke oku n'ezie (na-enweghị 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 iji zipu fom gaa nọmba ọ bụla na uru ejuputara.PUT /submit/lists/{key} na-edochi ahịrị nke ndepụta.updated_after maka mmekọrita; CSV site na ?format=csv), mepụta, gụọ site na id ma ọ bụ reference, melite (ọkwa, ndetu, mkpa, onye e kenyere, oge ịga, tags, azịza, ubi dị n'ime), tinye ndetu, zaghachi na bọtịnụ, tinye faịlụ, hichapụ.POST /submit/automations/try, na akụkọ ndị na-agba ọsọ.Webhook ọ bụla nke akaụntụ gị na-anata ihe omume ọ bụla. Ọ bụla n'ime ha na-ebu ndabanye dịka ọ dị n'oge ahụ: njikọ faịlụ nọ na ya na-arụ ọrụ ruo ụbọchị 7.
| Ihe omume | Mgbe |
|---|---|
submission.created | ndabanye adịla (faịlụ ya nwere ike ka na-abata) |
submission.files_ready | a debere faịlụ ya |
submission.updated | azịza, uru dị n'ime, mkpa, tags ma ọ bụ oge ịga gbanwere |
submission.status_changed | ọkwa gbanwere |
submission.assigned | onye e kenyere ya gbanwere |
submission.note_added | a dere ndetu |
submission.customer_replied | onye ahụ tinyere ederede, faịlụ ma ọ bụ ihe na-esochi, ma ọ bụ pịa bọtịnụ |
submission.deleted | ehichapụrụ ya ma ọ bụ ehichapụrụ ya n'ụzọ ọ bụla |
submit.automation_failed | akpaaka kwụsịrị mgbe nnwale ọzọ gasịrị |
Ọrụ ọ bụla bụkwa ngwa ọrụ na MCP server a na-enyere app2email, ya mere onye enyemaka nwere ike ime nhazi zuru ezu n'okwu: 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 na ndị ọzọ. Ozi mbụ dị mma gaa onye enyemaka: "Gụọ nkuzi Submit-Info, mgbe ahụ hazie fom akụkọ nsogbu nwere foto na ebe, gwa ndị manager m ihe ndị mkpa."
claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Ọzọ gbasara ijikọ ndị enyemaka na ngwa ọrụ akpaaka: Automation tools and agents.
| Oke | Uru |
|---|---|
| Fom na nọmba | 100 |
| Nzọụkwụ na fom, ajụjụ na nzọụkwụ | 12 na 12 (ajụjụ 60 na fom, otu ajụjụ ebe) |
| Ndepụta | 50, ọ bụla ruo 1,000 ahịrị |
| Akpaaka, njikọ, ndị otu | 200, 30, 200 |
| Faịlụ n'otu ndabanye | 60 |
| Ogo faịlụ | 25 MB site na WhatsApp, 10 MB site na ibe weebụ ma ọ bụ API |
| Ndetu ma ọ bụ azịza | mkpụrụedemede 4,000 |
| Tags na ndabanye | 20 |
| Oku gaa sistemụ ọzọ | 60 kwa nkeji na 2,000 kwa ụbọchị kwa nọmba; sekọnd 15 na 256 KB kwa oku |
| Akụkọ ịgba ọsọ | a na-echekwa ya ụbọchị 30 |
Ihe niile dị n'elu a na-edozi na ibe Submit-Info nke dashboard (/dashboard/app/submit). Ajụjụ: support@app2email.com.