Panduan Submit-Info: bina borang daripada senarai soalan, terbitkannya ke WhatsApp dan halaman web, uruskan penyerahan melalui peringkat dalam peti masuk kongsi dengan peranan, automasikan balasan dan panggilan ke sistem anda sendiri, dan sediakan semuanya melalui API atau ejen AI.
Anda menulis borang sebagai senarai soalan biasa. app2email menukarnya menjadi borang dalam WhatsApp dan halaman web dengan langkah yang sama. Pelanggan, atau ahli kakitangan lapangan anda sendiri, mengisinya dan menerima rujukan. Jawapan dan fail menjadi satu penyerahan dalam peti masuk kongsi, tempat ia bergerak melalui peringkat anda dan mencetuskan automasi anda.
Satu idea
Borang, kemudian penyerahan, kemudian peringkat, kemudian automasi, kemudian sambungan. Permintaan sebut harga, permohonan, bacaan meter, laporan masalah, kerja yang siap, bukti penghantaran dan resit perbelanjaan semuanya perkara yang sama dengan soalan dan nama peringkat yang berbeza. Setiap satu datang sebagai templat yang boleh anda pasang dan ubah.
Tiada apa yang berubah bagi nombor yang tidak pernah membuka Submit-Info. Borang yang belum diterbitkan ke WhatsApp masih berfungsi: perkataannya akan menjawab dengan pautan halaman web.
Borang mempunyai 1 hingga 12 langkah, dan setiap langkah mempunyai tajuk serta 1 hingga 12 soalan. Tiada kanvas dan tiada apa yang perlu dilukis: senarai yang sama memacu borang di WhatsApp, halaman web, semakan jawapan, lajur paparan jadual, eksport dan API. Pratonton di sebelah editor menunjukkan borang seperti yang dilihat oleh seseorang.
| Jenis | Apa yang diberikan oleh orang itu | Apa yang boleh anda tetapkan |
|---|---|---|
text | Jawapan pendek | panjang terpendek dan terpanjang, corak |
textarea | Jawapan yang lebih panjang | panjang terpendek dan terpanjang |
number | Nombor | nilai terendah dan tertinggi, perpuluhan, unit seperti kWh |
email | Alamat e-mel | |
phone | Nombor telefon | |
date | Tarikh | berapa hari ke belakang atau ke hadapan yang dibenarkan |
select | Satu pilihan | pilihan (2 hingga 200), atau senarai anda sendiri |
multiselect | Beberapa pilihan | pilihan (2 hingga 20), bilangan minimum dan maksimum untuk ditanda |
yesno | Ya atau Tidak | |
rating | Markah dari 1 hingga 3-10 | markah tertinggi |
consent | Ayat untuk dipersetujui | sama ada ia mesti ditanda |
photo | Satu atau lebih gambar | berapa banyak (1 hingga 10); kamera, galeri atau mana-mana |
document | Satu atau lebih fail | berapa banyak (1 hingga 10); mana-mana fail, PDF, gambar atau fail pejabat |
location | Di mana orang itu berada | pada WhatsApp, permintaan lokasi; pada web, butang dan baris alamat |
info | Teks yang anda tunjukkan | tiada yang ditanya atau disimpan |
hidden | Nilai yang datang bersama pautan | seperti nombor kerja; tiada yang dipaparkan |
{contact.name}.Halaman web. Langkah yang sama di /form/your-code/form-key. Ia meminta nama dan nombor WhatsApp pada akhir. Selepas menghantar, orang itu melihat rujukan dan boleh ketik "Get updates on WhatsApp", yang mengesahkan nombornya dengan satu mesej; borang boleh ditetapkan supaya memerlukannya. Pautan peribadi (dihantar oleh anda) sudah tahu siapa orang itu. Untuk meletakkan borang di laman web anda sendiri, gunakan kod di bawah Share; jika borang meminta lokasi, tambahkan allow="geolocation" pada iframe. Gambar dikecilkan dalam pelayar sebelum dimuat naik; fail boleh mencecah 10 MB.
Siapa boleh menghantar. Sesiapa sahaja (pilihan biasa), atau hanya nombor yang anda senaraikan atau kenalan dengan tag anda. Dengan cara itu borang kekal bersama kakitangan lapangan anda. Perkataan status menjawab orang itu dengan peringkat penyerahan terkini mereka.
Peringkat tergolong pada borang. Borang baharu bermula dengan New, In progress dan Done; namakan semula, tambah sendiri (2 hingga 12), dan pilih warna. Setiap peringkat ialah salah satu daripada tiga jenis: terbuka, selesai atau dibatalkan.
Balasan yang ditulis di luar masa balas WhatsApp disimpan dan dihantar apabila orang itu menulis lagi. Peti masuk memberitahu perkara itu pada balasan tersebut.
Inbox menunjukkan Open, Mine, Unassigned, Done dan All, serta paparan yang anda simpan. Cari dan tapis mengikut borang, peringkat, penerima tugas, tag, saluran dan tarikh. Tiga susun atur: senarai, jadual (satu borang: setiap soalan ialah satu lajur) dan papan (satu borang: satu lajur bagi setiap peringkat). Tanda beberapa baris untuk menukar peringkat, menugaskan, menanda, mengeksport atau memadamkannya sekaligus.
Sesuatu penyerahan memaparkan jawapannya, failnya, dari mana ia dihantar, dan satu sejarah semua yang berlaku kepadanya: pertukaran peringkat dengan siapa dan sebabnya, nota, balasan dalam kedua-dua arah, fail, dan setiap langkah automasi beserta hasilnya. Di bahagian bawah anda menulis sama ada nota dalaman atau balasan WhatsApp. Eksport mana-mana paparan sebagai CSV, Excel atau JSON, dan satu penyerahan sebagai PDF.
Pasukan anda. Jemput orang melalui e-mel ke peti masuk sahaja. Mereka mendapat aplikasi ringan sendiri di /desk dan tidak pernah melihat selebihnya akaun anda. Peranan ialah set keupayaan permulaan, dan setiap keupayaan boleh dihidup atau dimatikan untuk seorang individu.
| Peranan | Bermula dengan |
|---|---|
| Owner, Admin | Semuanya, termasuk borang, automasi, sambungan dan pasukan |
| Manager | Nota, balasan, mengedit jawapan, menukar peringkat, menugaskan, fail, eksport, memadam, menjalankan tindakan manual |
| Agent | Nota, balasan, mengedit jawapan, menukar peringkat, fail, menjalankan tindakan manual. Boleh mengambil penyerahan untuk diri sendiri |
| Viewer | Boleh membaca, tiada yang lain |
Anda juga boleh mengehadkan apa yang dilihat seseorang: hanya sebahagian borang, hanya apa yang ditugaskan kepada mereka (dengan atau tanpa yang belum ditugaskan untuk diambil), dan butiran hubungan disembunyikan. Setiap tindakan ahli pasukan dicatat dalam sejarah penyerahan.
Halaman peribadi orang itu. Setiap penyerahan mempunyai halaman peribadi di /s/a-long-code, tanpa log masuk: peringkat, mesej dan pertukaran peringkat setakat ini, soalan terbuka anda dengan butangnya, dan "Add information" apabila borang membenarkannya. Nota dalaman dan medan dalaman tidak pernah ada di situ.
Privasi. Memadam kenalan akan memadam penyerahan dan failnya. Sesuatu borang boleh mempunyai masa simpan, selepas itu penyerahan yang ditutup akan dipadam.
Automasi dibaca sebagai satu ayat: apabila sesuatu berlaku, jika perkara tertentu benar, lakukan langkah ini mengikut urutan. "Apabila Quote request dihantar, jika kuantiti 20 atau lebih, tugaskan kepada Managers dan e-mel pemilik."
| Apabila | Ia berjalan apabila |
|---|---|
submitted | penyerahan lengkap dan failnya sudah tiba |
status_changed | peringkat bertukar (pilihan: kepada atau daripada peringkat tertentu) |
assigned | orang yang ditugaskan bertukar |
updated | jawapan atau medan dalaman diedit |
note_added | ahli pasukan menulis nota |
file_added | fail ditambah kemudian |
customer_replied | orang yang menghantarnya menambah teks atau fail |
button | orang itu menekan butang pada salah satu balasan anda |
overdue | ia masih berada di peringkat yang sama selepas beberapa minit |
due | masa tamatnya berlalu semasa ia masih terbuka |
manual | ahli pasukan menekan butang tindakan pada penyerahan |
Jika: peraturan ke atas jawapan, nilai yang dikira, peringkat, saluran, tag dan penerima tugas. Satu peraturan terdiri daripada medan, operator dan nilai: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Gabungkan peraturan dengan all (dan) atau any (atau).
| Lakukan | Apa yang dibuatnya |
|---|---|
set_status | pindahkan ke satu peringkat, dengan nota |
assign | kepada seorang ahli, secara giliran dalam satu peranan, kepada yang paling kurang sibuk dalam peranan, atau kepada tiada siapa |
set_field, calculate | tulis medan dalaman, atau kira dengan formula |
tag, set_priority, set_due | tag, keutamaan, masa tamat |
reply | mesej WhatsApp kepada orang itu, dengan sehingga 3 butang yang setiap satunya memindahkan peringkat, satu fail, atau pautan ke halaman status mereka |
ask_location | minta orang itu berkongsi di mana mereka berada |
send_form | hantar borang susulan; apa yang dikembalikan dilampirkan pada penyerahan ini |
email | kepada pemilik, penerima tugas, orang itu, atau sebarang alamat, dengan fail dilampirkan |
notify | e-mel kepada penerima tugas, satu peranan, atau semua ahli pasukan |
http, openapi, mcp | panggil satu sambungan dan simpan sebahagian jawapan dalam medan |
wait | teruskan kemudian, hanya jika syaratnya masih benar |
stop | tamatkan di sini |
Setiap larian dilog langkah demi langkah: apa yang dihantar, apa yang dikembalikan, berapa lama ia mengambil masa. "Try with a submission" menjalankan automasi terhadap penyerahan sebenar tanpa mengubah atau menghantar apa-apa. Panggilan ke sistem luar yang gagal akan dicuba semula selepas 1 minit, 10 minit dan 1 jam; selepas itu automasi ditandakan gagal dan webhook anda menerima submit.automation_failed. Automasi yang saling mencetuskan dihentikan selepas tiga peringkat.
{
"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 ialah medan dalaman yang diisi pasukan anda sebelum memindahkan penyerahan ke Quoted. Peringatan hanya dihantar jika penyerahan masih berada dalam 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 ialah nilai yang dikira: 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."
}
]
}Sambungan ialah sistem luar yang boleh dipanggil oleh automasi. Webhook akaun anda tidak memerlukan sambungan: ia menerima setiap peristiwa penyerahan semasa ia berlaku (lihat peristiwa). Untuk yang lain ada tiga jenis. "Test" pada sambungan, dan "Try with a submission" pada tindakan, menunjukkan permintaan sebenar dan jawapan sebenar sebelum apa-apa diaktifkan.
Alamat asas dan cara untuk log masuk (tiada, token pembawa, header, nama pengguna dan kata laluan, atau kunci dalam alamat). Tindakan menamakan kaedah, laluan dan badan JSON. save menyimpan sebahagian jawapan dalam medan penyerahan.
{
"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"
}Beri alamat dokumen OpenAPI 3 dalam JSON, atau tampalnya. app2email membaca operasinya; tindakan memilih satu mengikut id-nya dan mengisi parameternya. Dokumen YAML dan Swagger 2 tidak dibaca.
{
"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"
}Beri alamat pelayan MCP (streamable HTTP) dan tokennya. app2email menyenaraikan alat pelayan itu; tindakan memilih satu dan mengisi argumennya. $text menyimpan keseluruhan jawapan alat sebagai teks.
{
"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"
}Perlu diketahui. Nilai yang tepat satu tempat letak mengekalkan jenisnya (nombor kekal sebagai nombor, senarai kekal sebagai senarai). Rahsia disimpan dengan penyulitan, tidak pernah dipaparkan semula dan tidak pernah dikembalikan oleh API. Alamat mesti https dan awam: alamat persendirian, tempatan dan dalaman ditolak, dan ubah hala tidak diikuti. Satu panggilan boleh mengambil masa 15 saat dan jawapannya boleh mencecah 256 KB. Dalam save, laluan ialah $ (seluruh jawapan) atau laluan biasa seperti $.data.items[0].id.
Setiap teks dan setiap parameter tindakan boleh menggunakan tempat letak dalam kurungan kerawang. Nama yang tidak dikenali kekal seperti yang anda taip.
| Tempat letak | Menjadi |
|---|---|
{<field key>} | jawapan kepada soalan itu (juga medan dalaman, nilai yang dikira dan nilai yang disimpan automasi) |
{reference} | rujukan, contohnya MR-7Q3M2A |
{form} {form_key} | nama borang dan kuncinya |
{status} {status_name} | kunci peringkat dan namanya |
{channel} | whatsapp, web, api atau staff |
{priority} {tags} | keutamaan dan tag |
{created} {updated} {due} | masa-masa |
{contact.name} {contact.phone} {contact.email} | orang yang menghantarnya |
{assignee.name} {assignee.email} | ahli pasukan yang ditugaskan kepadanya |
{link} | halaman status peribadi orang itu |
{desk_link} | penyerahan dalam peti masuk pasukan anda |
{answers} | semua jawapan sebagai baris "Label: value" |
{files} {files.<field key>} | pautan kepada semua fail, atau kepada fail bagi satu soalan; sistem lain boleh mengambilnya selama 7 hari |
{note} | nota pertukaran peringkat, atau nota yang mencetuskan automasi |
{button} | butang yang ditekan oleh orang itu |
{business} | nama perniagaan anda |
{submission} | dalam badan JSON: seluruh penyerahan sebagai objek |
{= formula } | formula yang dikira di tempatnya, contohnya {= round(qty * 1.1, 2) } |
Digunakan oleh nilai yang dikira, oleh tindakan calculate, dan di dalam {= ... } dalam mana-mana teks. Formula berfungsi dengan nombor, teks dalam petik tunggal dan kunci soalan anda. Ia boleh mencapai 500 aksara. Pembahagian dengan sifar, atau nombor yang tiada, memberikan nilai kosong dan bukannya ralat.
| Anda tulis | Maksudnya |
|---|---|
+ - * / % | aritmetik pada nombor dan jawapan |
== != > >= < <= | perbandingan |
and or not ( ) | logik dan kurungan |
if(condition, a, b) | a apabila syarat benar, jika tidak b |
min(a, b, ...) max(a, b, ...) | yang terkecil, yang terbesar |
round(x, n) abs(x) | pembundaran kepada n perpuluhan, saiz nombor tanpa tanda |
num(x) len(x) | teks sebagai nombor; panjang teks atau senarai |
coalesce(a, b) | a, atau b apabila a kosong |
lower(x) upper(x) concat(a, b, ...) | teks |
lookup('list', id, 'column') | satu lajur bagi satu baris daripada salah satu senarai anda, contohnya harga |
previous('field') | jawapan terakhir orang yang sama kepada soalan itu |
count_files('field') | berapa banyak fail yang dimiliki sesuatu soalan |
days_since(date) | bilangan hari dari satu tarikh hingga hari ini |
Contoh: qty * lookup('prices', product, 'price') untuk anggaran serta-merta; reading - previous('reading') untuk penggunaan; if(amount > 500, 'manager', 'agent') untuk menentukan siapa yang meluluskan.
Semua di atas terdapat dalam REST API di bawah /v1/{number}/submit, dengan {number} ialah nombor WhatsApp anda dengan kod negara, digit sahaja. Hantar kunci API anda sebagai Authorization: Bearer YOUR_API_KEY (header X-API-KEY juga diterima). Kunci memerlukan skop submissions:manage; kunci akses penuh memilikinya, kunci Default tidak. Kunci sandbox tidak boleh menulis.
GET /submit/guide: satu dokumen JSON dengan keseluruhan perbendaharaan kata: jenis soalan dengan pilihan dan hadnya, peraturan peringkat, pencetus, operator, tindakan dengan parameternya, tempat letak, fungsi formula, templat, dan contoh kerja.POST /submit/setup dengan "dry_run": true: tiada apa yang ditulis; setiap masalah dikembalikan dengan laluannya dan satu ayat yang menerangkan cara membetulkannya.POST /submit/setup tanpa dry_run: senarai, sambungan, borang dan automasi digunakan serentak. Jika ada sebarang masalah, tiada apa yang ditulis.POST /submit/forms/{key}/publish, atau namakan borang dalam "publish" pada dokumen persediaan.GET /submit/forms/{key} mengembalikannya), kemudian baca GET /submit/submissions atau dengar peristiwa webhook.Simpan dokumen di bawah sebagai setup.json dan hantarnya. Gantikan 61400000000 dengan nombor anda. Ia menyediakan penyelesaian bacaan meter: senarai tapak, sambungan ke sistem bil, satu borang dengan tiga peringkat dan penggunaan yang dikira, serta dua automasi. Buang "dry_run": true untuk menggunakannya. Borang, senarai dan sambungan sedia ada dengan kunci yang sama akan digantikan; automasi dipadankan mengikut nama dalam borang. "preset": "..." menggantikan sebahagian bahagian untuk memasang salah satu templat (GET /submit/presets menyenaraikannya).
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"
]
}Jawapan panggilan sebenar (tanpa 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 untuk menghantar borang ke satu nombor dengan nilai yang sudah diisi.PUT /submit/lists/{key} menggantikan baris bagi satu senarai.updated_after untuk penyegerakan; CSV dengan ?format=csv), cipta, baca mengikut id atau rujukan, kemas kini (peringkat, nota, keutamaan, penerima tugas, masa tamat, tag, jawapan, medan dalaman), tambah nota, balas dengan butang, tambah fail, padam.POST /submit/automations/try, dan log larian.Setiap webhook akaun anda menerima setiap peristiwa. Setiap satu membawa penyerahan seperti keadaannya pada masa itu; pautan fail di dalamnya berfungsi selama 7 hari.
| Peristiwa | Bila |
|---|---|
submission.created | penyerahan wujud (failnya mungkin masih tiba) |
submission.files_ready | failnya sudah disimpan |
submission.updated | jawapan, nilai dalaman, keutamaan, tag atau masa tamat berubah |
submission.status_changed | peringkat berubah |
submission.assigned | penerima tugas berubah |
submission.note_added | nota ditulis |
submission.customer_replied | orang itu menambah teks, fail atau susulan, atau menekan butang |
submission.deleted | dipadam atau dihapuskan |
submit.automation_failed | sesuatu automasi berhenti selepas cubaan semula |
Setiap laluan juga menjadi alat pada pelayan MCP yang dihoskan oleh app2email, jadi seorang pembantu boleh melakukan keseluruhan persediaan dalam satu perbualan: 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 dan lain-lain. Mesej pertama yang baik kepada pembantu: "Baca panduan Submit-Info, kemudian sediakan borang laporan masalah dengan gambar dan lokasi, dan beritahu pengurus saya tentang yang mendesak."
claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Lebih lanjut tentang menyambungkan pembantu dan alat automasi: Alat automasi dan ejen.
| Had | Nilai |
|---|---|
| Borang setiap nombor | 100 |
| Langkah dalam borang, soalan dalam langkah | 12 dan 12 (60 soalan dalam borang, satu soalan lokasi) |
| Senarai | 50, setiap satu sehingga 1,000 baris |
| Automasi, sambungan, ahli pasukan | 200, 30, 200 |
| Fail dalam satu penyerahan | 60 |
| Saiz fail | 25 MB dari WhatsApp, 10 MB dari halaman web atau API |
| Nota atau balasan | 4,000 aksara |
| Tag pada penyerahan | 20 |
| Panggilan ke sistem luar | 60 seminit dan 2,000 sehari setiap nombor; 15 saat dan 256 KB setiap panggilan |
| Log larian | disimpan selama 30 hari |
Semua di atas ditetapkan pada halaman Submit-Info papan pemuka (/dashboard/app/submit). Soalan: support@app2email.com.