Panduan Submit-Info: buat formulir dari daftar pertanyaan, publikasikan ke WhatsApp dan halaman web, tangani kiriman melalui tahapan di kotak masuk bersama dengan peran, otomatiskan balasan dan panggilan ke sistem Anda sendiri, dan siapkan semuanya lewat API atau agen AI.
Anda menulis formulir sebagai daftar pertanyaan biasa. app2email mengubahnya menjadi formulir di dalam WhatsApp dan halaman web dengan langkah yang sama. Pelanggan, atau anggota staf lapangan Anda sendiri, mengisinya dan mendapat nomor referensi. Jawaban dan file menjadi sebuah kiriman (submission) di kotak masuk bersama, tempat ia bergerak melalui tahapan Anda dan memicu otomatisasi Anda.
Satu gagasan
Formulir, lalu kiriman, lalu tahapan, lalu otomatisasi, lalu koneksi. Permintaan penawaran, lamaran, pembacaan meteran, laporan masalah, pekerjaan yang selesai, bukti pengiriman, dan tanda terima pengeluaran semuanya hal yang sama dengan pertanyaan dan nama tahapan yang berbeda. Masing-masing tersedia sebagai template yang bisa Anda pasang dan ubah.
Tidak ada yang berubah untuk nomor yang tidak pernah membuka Submit-Info. Formulir yang belum dipublikasikan ke WhatsApp tetap berfungsi: katanya dijawab dengan tautan halaman web.
Formulir memiliki 1 sampai 12 langkah, dan langkah memiliki judul dan 1 sampai 12 pertanyaan. Tidak ada kanvas dan tidak ada yang digambar: daftar yang sama menggerakkan formulir di WhatsApp, halaman web, pemeriksaan jawaban, kolom tampilan tabel, ekspor, dan API. Pratinjau di samping editor menampilkan formulir seperti yang dilihat orang.
| Tipe | Yang diberikan orang | Yang bisa Anda atur |
|---|---|---|
text | Jawaban singkat | panjang terpendek dan terpanjang, sebuah pola |
textarea | Jawaban lebih panjang | panjang terpendek dan terpanjang |
number | Sebuah angka | nilai terendah dan tertinggi, desimal, satuan seperti kWh |
email | Alamat email | |
phone | Nomor telepon | |
date | Sebuah tanggal | berapa hari ke belakang atau ke depan yang diperbolehkan |
select | Satu pilihan | pilihannya (2 sampai 200), atau daftar milik Anda |
multiselect | Beberapa pilihan | pilihannya (2 sampai 20), paling sedikit dan paling banyak yang dicentang |
yesno | Ya atau Tidak | |
rating | Nilai dari 1 sampai 3-10 | nilai tertinggi |
consent | Kalimat untuk disetujui | apakah harus dicentang |
photo | Satu foto atau lebih | berapa banyak (1 sampai 10); kamera, galeri, atau keduanya |
document | Satu file atau lebih | berapa banyak (1 sampai 10); file apa pun, PDF, gambar, atau file office |
location | Di mana orang itu berada | di WhatsApp berupa permintaan lokasi; di web berupa tombol dan satu baris alamat |
info | Teks yang Anda tampilkan | tidak ada yang ditanyakan atau disimpan |
hidden | Nilai yang datang bersama tautan | seperti nomor pekerjaan; tidak ada yang ditampilkan |
{contact.name}.Halaman web. Langkah yang sama di /form/your-code/form-key. Halaman ini menanyakan nama dan nomor WhatsApp di akhir. Setelah mengirim, orang itu melihat nomor referensi dan bisa mengetuk "Get updates on WhatsApp", yang mengonfirmasi nomornya dengan satu pesan; formulir bisa diatur untuk mewajibkannya. Tautan pribadi (yang Anda kirim) sudah tahu siapa orang itu. Untuk menaruh formulir di situs Anda sendiri, gunakan snippet di bawah Share; jika formulir menanyakan lokasi, tambahkan allow="geolocation" ke iframe. Foto diperkecil di browser sebelum diunggah; file bisa hingga 10 MB.
Siapa yang boleh mengirim. Siapa saja (pilihan yang lazim), atau hanya nomor yang Anda daftarkan atau kontak dengan tag milik Anda. Begitulah formulir tetap hanya untuk staf lapangan Anda. Kata status menjawab orang dengan tahapan kiriman terbarunya.
Tahapan milik formulir. Formulir baru dimulai dengan New, In progress dan Done; ganti namanya, tambahkan milik Anda (2 sampai 12), dan pilih warna. Setiap tahapan adalah salah satu dari tiga jenis: terbuka, selesai, atau dibatalkan.
Balasan yang ditulis di luar waktu balasan WhatsApp disimpan dan dikirim saat orang itu menulis berikutnya. Inbox menyatakannya pada balasan.
Inbox menampilkan Open, Mine, Unassigned, Done dan All, ditambah tampilan yang Anda simpan. Cari dan filter berdasarkan formulir, tahapan, penerima tugas, tag, saluran, dan tanggal. Tiga tata letak: daftar, tabel (satu formulir: setiap pertanyaan adalah kolom), dan papan (satu formulir: satu kolom untuk setiap tahapan). Centang beberapa baris untuk mengubah tahapan, menugaskan, memberi tag, mengekspor, atau menghapusnya bersama.
Kiriman menampilkan jawabannya, file-nya, dari mana ia dikirim, dan satu riwayat dari semua yang terjadi padanya: perubahan tahapan beserta siapa dan mengapa, catatan, balasan dua arah, file, dan setiap langkah otomatisasi beserta hasilnya. Di bagian bawah Anda menulis catatan internal atau balasan WhatsApp. Ekspor tampilan apa pun sebagai CSV, Excel, atau JSON, dan satu kiriman sebagai PDF.
Tim Anda. Undang orang lewat email hanya ke inbox. Mereka mendapat aplikasi ringan sendiri di /desk dan tidak pernah melihat bagian akun Anda yang lain. Peran adalah kumpulan kemampuan awal, dan setiap kemampuan bisa dinyalakan atau dimatikan untuk satu orang.
| Peran | Dimulai dengan |
|---|---|
| Owner, Admin | Semuanya, termasuk formulir, otomatisasi, koneksi, dan tim |
| Manager | Catatan, balasan, mengedit jawaban, mengubah tahapan, menugaskan, file, ekspor, hapus, menjalankan aksi manual |
| Agent | Catatan, balasan, mengedit jawaban, mengubah tahapan, file, menjalankan aksi manual. Bisa mengambil kiriman untuk dirinya sendiri |
| Viewer | Bisa membaca, tidak lebih |
Anda juga bisa mempersempit apa yang dilihat seseorang: hanya beberapa formulir, hanya yang ditugaskan kepadanya (dengan atau tanpa yang belum ditugaskan untuk diambil), dan detail kontak disembunyikan. Setiap tindakan anggota tim dicatat di riwayat kiriman.
Halaman milik orang itu sendiri. Setiap kiriman memiliki halaman privat di /s/a-long-code, tanpa login: tahapan, pesan dan perubahan tahapan sejauh ini, pertanyaan terbuka dari Anda beserta tombolnya, dan "Add information" bila formulir mengizinkannya. Catatan internal dan field internal tidak pernah ada di sana.
Privasi. Menghapus kontak menghapus kiriman dan file-nya. Formulir bisa memiliki waktu penyimpanan, setelah itu kiriman yang sudah ditutup dihapus.
Otomatisasi terbaca seperti kalimat: saat sesuatu terjadi, jika beberapa hal benar, lakukan hal-hal ini secara berurutan. "Saat Quote request dikirim, jika jumlahnya 20 atau lebih, tugaskan ke Managers dan kirim email ke pemilik."
| Saat | Berjalan ketika |
|---|---|
submitted | kiriman lengkap dan file-nya sudah tiba |
status_changed | tahapan berubah (opsional: ke atau dari tahapan tertentu) |
assigned | orang yang ditugasi berubah |
updated | jawaban atau field internal diedit |
note_added | anggota tim menulis catatan |
file_added | file ditambahkan belakangan |
customer_replied | orang yang mengirimnya menambahkan teks atau file |
button | orang itu menekan tombol dari salah satu balasan Anda |
overdue | masih di tahapan yang sama setelah sejumlah menit |
due | waktu tenggatnya lewat selagi masih terbuka |
manual | anggota tim menekan tombol aksi pada kiriman |
Jika: aturan pada jawaban, nilai terhitung, tahapan, saluran, tag, dan penerima tugas. Aturan terdiri dari field, operator, dan nilai: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Gabungkan aturan dengan all (dan) atau any (atau).
| Lakukan | Fungsinya |
|---|---|
set_status | pindahkan ke tahapan, dengan catatan |
assign | ke seorang anggota, bergiliran pada sebuah peran, ke yang paling tidak sibuk dari sebuah peran, atau ke tidak seorang pun |
set_field, calculate | menulis field internal, atau menghitungnya dengan rumus |
tag, set_priority, set_due | tag, prioritas, waktu tenggat |
reply | pesan WhatsApp ke orang itu, dengan hingga 3 tombol yang masing-masing memindahkan tahapan, sebuah file, atau tautan ke halaman statusnya |
ask_location | meminta orang itu membagikan di mana ia berada |
send_form | mengirim formulir tindak lanjut; yang kembali dilampirkan ke kiriman ini |
email | ke pemilik, penerima tugas, orang itu, atau alamat mana pun, dengan file terlampir |
notify | email ke penerima tugas, sebuah peran, atau semua orang di tim |
http, openapi, mcp | memanggil koneksi dan menyimpan sebagian jawaban di field |
wait | lanjut nanti, hanya jika kondisinya masih berlaku |
stop | berhenti di sini |
Setiap proses dicatat langkah demi langkah: apa yang dikirim, apa yang kembali, berapa lama. "Try with a submission" menjalankan otomatisasi terhadap kiriman sungguhan tanpa mengubah atau mengirim apa pun. Panggilan ke sistem luar yang gagal dicoba lagi setelah 1 menit, 10 menit, dan 1 jam; setelah itu otomatisasi ditandai gagal dan webhook Anda menerima submit.automation_failed. Otomatisasi yang saling memicu dihentikan setelah tiga tingkat.
{
"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 adalah field internal yang diisi tim Anda sebelum memindahkan kiriman ke Quoted. Pengingat dikirim hanya jika kiriman masih di 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 adalah nilai terhitung: 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."
}
]
}Koneksi adalah sistem luar yang bisa dipanggil otomatisasi. Webhook akun Anda tidak membutuhkannya: webhook menerima setiap event kiriman saat terjadi (lihat event). Untuk yang lainnya ada tiga jenis. "Test" pada koneksi, dan "Try with a submission" pada aksi, menampilkan permintaan sungguhan dan jawaban sungguhan sebelum apa pun dinyalakan.
Alamat dasar dan cara masuk (tidak ada, bearer token, header, nama pengguna dan kata sandi, atau kunci di alamat). Aksi menyebutkan method, path, dan body JSON. save menyimpan sebagian jawaban di field kiriman.
{
"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"
}Berikan alamat dokumen OpenAPI 3 dalam JSON, atau tempel. app2email membaca operasinya; aksi memilih satu berdasarkan 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"
}Berikan alamat server MCP (streamable HTTP) dan token-nya. app2email mencantumkan tool milik server; aksi memilih satu dan mengisi argumennya. $text menyimpan seluruh jawaban tool 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 persis berupa satu placeholder mempertahankan tipenya (angka tetap angka, daftar tetap daftar). Rahasia disimpan terenkripsi, tidak pernah ditampilkan lagi dan tidak pernah dikembalikan oleh API. Alamat harus https dan publik: alamat privat, lokal, dan internal ditolak, dan pengalihan tidak diikuti. Satu panggilan boleh memakan 15 detik dan jawabannya boleh 256 KB. Di save, path adalah $ (seluruh jawaban) atau path biasa seperti $.data.items[0].id.
Setiap teks dan setiap parameter aksi bisa memakai placeholder dalam kurung kurawal. Nama yang tidak dikenal tetap seperti yang Anda ketik.
| Placeholder | Menjadi |
|---|---|
{<field key>} | jawaban atas pertanyaan itu (juga field internal, nilai terhitung, dan nilai yang disimpan otomatisasi) |
{reference} | nomor referensi, misalnya MR-7Q3M2A |
{form} {form_key} | nama formulir dan key-nya |
{status} {status_name} | key tahapan dan namanya |
{channel} | whatsapp, web, api atau staff |
{priority} {tags} | prioritas dan tag |
{created} {updated} {due} | waktunya |
{contact.name} {contact.phone} {contact.email} | orang yang mengirimnya |
{assignee.name} {assignee.email} | anggota tim yang ditugasi |
{link} | halaman status milik orang itu sendiri |
{desk_link} | kiriman di inbox tim Anda |
{answers} | semua jawaban sebagai baris "Label: value" |
{files} {files.<field key>} | tautan ke semua file, atau ke file dari satu pertanyaan; sistem lain bisa mengambilnya selama 7 hari |
{note} | catatan perubahan tahapan, atau catatan yang memicu otomatisasi |
{button} | tombol yang ditekan orang itu |
{business} | nama bisnis Anda |
{submission} | dalam body JSON: seluruh kiriman sebagai objek |
{= formula } | rumus yang dihitung di tempat, misalnya {= round(qty * 1.1, 2) } |
Dipakai oleh nilai terhitung, oleh aksi calculate, dan di dalam {= ... } pada teks mana pun. Rumus bekerja dengan angka, teks dalam tanda kutip tunggal, dan key pertanyaan Anda. Panjangnya bisa 500 karakter. Pembagian dengan nol, atau angka yang tidak ada, menghasilkan nilai kosong, bukan error.
| Yang Anda tulis | Artinya |
|---|---|
+ - * / % | aritmetika pada angka dan jawaban |
== != > >= < <= | perbandingan |
and or not ( ) | logika dan tanda kurung |
if(condition, a, b) | a bila kondisi terpenuhi, jika tidak b |
min(a, b, ...) max(a, b, ...) | yang terkecil, yang terbesar |
round(x, n) abs(x) | pembulatan ke n desimal, besar angka tanpa tandanya |
num(x) len(x) | teks sebagai angka; panjang teks atau daftar |
coalesce(a, b) | a, atau b bila a kosong |
lower(x) upper(x) concat(a, b, ...) | teks |
lookup('list', id, 'column') | kolom dari satu baris di salah satu daftar Anda, misalnya harga |
previous('field') | jawaban terakhir orang yang sama atas pertanyaan itu |
count_files('field') | berapa file yang dimuat sebuah pertanyaan |
days_since(date) | hari sejak sebuah tanggal sampai hari ini |
Contoh: qty * lookup('prices', product, 'price') untuk perkiraan instan; reading - previous('reading') untuk pemakaian; if(amount > 500, 'manager', 'agent') untuk menentukan siapa yang menyetujui.
Semua di atas ada di REST API di bawah /v1/{number}/submit, dengan {number} adalah nomor WhatsApp Anda beserta kode negara, hanya angka. Kirim kunci API Anda sebagai Authorization: Bearer YOUR_API_KEY (header X-API-KEY juga diterima). Kunci membutuhkan scope submissions:manage; kunci dengan akses penuh memilikinya, kunci Default tidak. Kunci sandbox tidak bisa menulis.
GET /submit/guide: satu dokumen JSON berisi seluruh kosakata: tipe pertanyaan beserta opsi dan batasnya, aturan tahapan, pemicu, operator, aksi beserta parameternya, placeholder, fungsi rumus, template, dan contoh kerja.POST /submit/setup dengan "dry_run": true: tidak ada yang ditulis; setiap masalah kembali beserta path-nya dan satu kalimat yang menyatakan cara memperbaikinya.POST /submit/setup tanpa dry_run: daftar, koneksi, formulir, dan otomatisasi diterapkan bersama. Jika ada masalah apa pun, tidak ada yang ditulis.POST /submit/forms/{key}/publish, atau sebutkan formulir di "publish" pada dokumen setup.GET /submit/forms/{key} mengembalikannya), lalu baca GET /submit/submissions atau dengarkan event webhook.Simpan dokumen di bawah sebagai setup.json dan kirim. Ganti 61400000000 dengan nomor Anda. Dokumen ini memeriksa solusi pembacaan meteran: daftar lokasi, koneksi ke sistem penagihan, satu formulir dengan tiga tahapan dan pemakaian terhitung, serta dua otomatisasi. Hapus "dry_run": true untuk menerapkannya. Formulir, daftar, dan koneksi yang sudah ada dengan key yang sama diganti; otomatisasi dicocokkan berdasarkan nama dalam formulir. "preset": "..." sebagai ganti bagian-bagiannya memasang salah satu template (GET /submit/presets mencantumkannya).
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"
]
}Jawaban panggilan sungguhan (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 mengirim formulir ke sebuah nomor dengan nilai yang sudah terisi.PUT /submit/lists/{key} mengganti baris sebuah daftar.updated_after untuk sinkronisasi; CSV dengan ?format=csv), buat, baca berdasarkan id atau referensi, perbarui (tahapan, catatan, prioritas, penerima tugas, waktu tenggat, tag, jawaban, field internal), tambah catatan, balas dengan tombol, tambah file, hapus.POST /submit/automations/try, dan log proses.Setiap webhook akun Anda menerima setiap event. Masing-masing membawa kiriman sebagaimana adanya pada saat itu; tautan file di dalamnya berlaku selama 7 hari.
| Event | Kapan |
|---|---|
submission.created | sebuah kiriman ada (file-nya mungkin masih tiba) |
submission.files_ready | file-nya sudah tersimpan |
submission.updated | jawaban, nilai internal, prioritas, tag, atau waktu tenggat berubah |
submission.status_changed | tahapan berubah |
submission.assigned | penerima tugas berubah |
submission.note_added | catatan ditulis |
submission.customer_replied | orang itu menambahkan teks, file, atau tindak lanjut, atau menekan tombol |
submission.deleted | dihapus atau dihapus permanen |
submit.automation_failed | otomatisasi menyerah setelah percobaan ulangnya |
Setiap rute juga merupakan tool di server MCP hosted milik app2email, sehingga asisten bisa melakukan seluruh penyiapan dalam satu percakapan: 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 lainnya. Pesan pertama yang baik kepada asisten: "Read the Submit-Info guide, then set up a problem report form with photos and a location, and tell my managers about urgent ones."
claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Selengkapnya tentang menghubungkan asisten dan tool otomatisasi: Tool otomatisasi dan agen.
| Batas | Nilai |
|---|---|
| Formulir per nomor | 100 |
| Langkah dalam formulir, pertanyaan dalam langkah | 12 dan 12 (60 pertanyaan dalam satu formulir, satu pertanyaan lokasi) |
| Daftar | 50, masing-masing hingga 1.000 baris |
| Otomatisasi, koneksi, anggota tim | 200, 30, 200 |
| File dalam satu kiriman | 60 |
| Ukuran file | 25 MB dari WhatsApp, 10 MB dari halaman web atau API |
| Catatan atau balasan | 4.000 karakter |
| Tag pada kiriman | 20 |
| Panggilan ke sistem luar | 60 per menit dan 2.000 per hari per nomor; 15 detik dan 256 KB per panggilan |
| Log proses | disimpan 30 hari |
Semua yang di atas diatur di halaman Submit-Info dashboard (/dashboard/app/submit). Pertanyaan: support@app2email.com.