app2email API Harga

Dokumentasi

Submit-Info

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.

Mulai dalam lima menit

  1. Buka: di dashboard Anda buka halaman Submit-Info (/dashboard/app/submit, juga bisa dibuka dari Integrations). Aktifkan.
  2. Buat formulir: pilih "New form" dan pilih template, atau mulai dari kosong. Beri nama dan tulis pertanyaan Anda. Setiap pertanyaan adalah satu baris: teksnya, tipenya, dan apakah wajib dijawab.
  3. Publikasikan: "Publish to WhatsApp" mengunggah formulir ke WhatsApp dan membuatnya live. Halaman web dengan langkah yang sama langsung live.
  4. Bagikan: di bawah Share Anda menemukan kata yang membuka formulir di obrolan Anda, tautan yang membuka obrolan Anda dengan kata itu sudah diketik, alamat halaman web, kode QR, dan snippet untuk menaruh formulir di situs web Anda sendiri.
  5. Kerjakan kotak masuk: kiriman baru tiba di Inbox. Buka satu, ubah tahapannya, balas. Undang tim Anda saat sudah siap.

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.

Pembuat formulir

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.

TipeYang diberikan orangYang bisa Anda atur
textJawaban singkatpanjang terpendek dan terpanjang, sebuah pola
textareaJawaban lebih panjangpanjang terpendek dan terpanjang
numberSebuah angkanilai terendah dan tertinggi, desimal, satuan seperti kWh
emailAlamat email
phoneNomor telepon
dateSebuah tanggalberapa hari ke belakang atau ke depan yang diperbolehkan
selectSatu pilihanpilihannya (2 sampai 200), atau daftar milik Anda
multiselectBeberapa pilihanpilihannya (2 sampai 20), paling sedikit dan paling banyak yang dicentang
yesnoYa atau Tidak
ratingNilai dari 1 sampai 3-10nilai tertinggi
consentKalimat untuk disetujuiapakah harus dicentang
photoSatu foto atau lebihberapa banyak (1 sampai 10); kamera, galeri, atau keduanya
documentSatu file atau lebihberapa banyak (1 sampai 10); file apa pun, PDF, gambar, atau file office
locationDi mana orang itu beradadi WhatsApp berupa permintaan lokasi; di web berupa tombol dan satu baris alamat
infoTeks yang Anda tampilkantidak ada yang ditanyakan atau disimpan
hiddenNilai yang datang bersama tautanseperti nomor pekerjaan; tidak ada yang ditampilkan
  • Teks bantuan dan nilai default: setiap pertanyaan bisa membawa petunjuk singkat, dan nilai default. Nilai default bisa memakai apa yang sudah Anda ketahui, seperti {contact.name}.
  • Tampilkan hanya jika: langkah atau pertanyaan bisa bergantung pada jawaban sebelumnya ("tampilkan langkah ini hanya bila Problem adalah Yes"). WhatsApp dan halaman web mengikuti aturan yang sama.
  • Field internal: field yang tidak pernah ditanyakan. Tim Anda atau sebuah otomatisasi yang mengisinya: jumlah penawaran, alasan keputusan, id yang kembali dari sistem lain. Field ini hanya tampil di inbox dan di ekspor.
  • Daftar: pertanyaan pilihan bisa mengambil pilihannya dari daftar milik Anda (lokasi, pekerjaan, produk beserta harga). Ubah daftar di dashboard atau lewat API dan formulir mengikutinya, tanpa perlu dipublikasikan lagi.
  • Nilai terhitung: rumus atas jawaban, untuk perkiraan instan atau pemeriksaan. Lihat rumus.
  • Setelah dikirim: layar tinjauan sebelum mengirim, balasan dengan nomor referensi, tombol "Add more" yang melampirkan pesan berikutnya (teks, foto, file) ke kiriman selama sepuluh menit, dan tautan ke halaman status milik orang itu sendiri.
  • Publikasi: app2email menulis formulir WhatsApp untuk Anda, membagi langkah yang panjang ke beberapa layar saat batas WhatsApp mengharuskannya, dan menyimpan lima versi terakhir yang dipublikasikan sehingga pesan lama tetap membuka formulir yang dikirim bersamanya.

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.

Bagaimana orang mencapai formulir

  • Sebuah kata: setiap formulir memiliki kata-katanya sendiri. Kata form, forms, report dan submit (bisa Anda ubah) mencantumkan formulir Anda sebagai menu bila ada beberapa. Kata hanya dihitung dalam pesan pendek: yang memiliki kurang dari 10 kata lain (Settings, "Ignore the words in long messages"), sehingga pesan panjang yang kebetulan memuatnya tidak memulai apa pun.
  • Tautan atau kode QR: tautan yang membuka obrolan WhatsApp Anda dengan kata formulir, atau alamat halaman web.
  • Dikirim oleh Anda: "Send form" di inbox, atau API, mengirim formulir ke satu nomor, dengan nilai yang sudah terisi (nomor pekerjaan, akun, dokumen yang Anda inginkan).
  • Tindak lanjut: sebuah otomatisasi atau anggota tim meminta lebih banyak dengan formulir kedua. Yang kembali dilampirkan ke kiriman pertama.
  • Halaman web, dan API untuk sistem yang sudah menyimpan datanya.

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

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.

  • Siapa yang boleh memilihnya: simpan tahapan untuk peran tertentu. Agent menyiapkan, hanya Manager yang menyetujui.
  • Catatan wajib: minta alasan saat kiriman dipindahkan ke sana (ditolak, ditolak mentah-mentah, dipertanyakan).
  • Pesan: teks yang dikirim ke orang itu saat kirimannya tiba di tahapan tersebut, dengan placeholder.
  • Tombol untuk orang itu: balasan bisa membawa hingga tiga tombol (Accept, Decline, "Not fixed yet"), dan masing-masing memindahkan tahapan. Satu fitur itu memberi Anda penerimaan penawaran, konfirmasi kunjungan, dan "apakah sudah diperbaiki?".

Balasan yang ditulis di luar waktu balasan WhatsApp disimpan dan dikirim saat orang itu menulis berikutnya. Inbox menyatakannya pada balasan.

Inbox dan peran

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.

PeranDimulai dengan
Owner, AdminSemuanya, termasuk formulir, otomatisasi, koneksi, dan tim
ManagerCatatan, balasan, mengedit jawaban, mengubah tahapan, menugaskan, file, ekspor, hapus, menjalankan aksi manual
AgentCatatan, balasan, mengedit jawaban, mengubah tahapan, file, menjalankan aksi manual. Bisa mengambil kiriman untuk dirinya sendiri
ViewerBisa 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

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."

SaatBerjalan ketika
submittedkiriman lengkap dan file-nya sudah tiba
status_changedtahapan berubah (opsional: ke atau dari tahapan tertentu)
assignedorang yang ditugasi berubah
updatedjawaban atau field internal diedit
note_addedanggota tim menulis catatan
file_addedfile ditambahkan belakangan
customer_repliedorang yang mengirimnya menambahkan teks atau file
buttonorang itu menekan tombol dari salah satu balasan Anda
overduemasih di tahapan yang sama setelah sejumlah menit
duewaktu tenggatnya lewat selagi masih terbuka
manualanggota 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).

LakukanFungsinya
set_statuspindahkan ke tahapan, dengan catatan
assignke seorang anggota, bergiliran pada sebuah peran, ke yang paling tidak sibuk dari sebuah peran, atau ke tidak seorang pun
set_field, calculatemenulis field internal, atau menghitungnya dengan rumus
tag, set_priority, set_duetag, prioritas, waktu tenggat
replypesan WhatsApp ke orang itu, dengan hingga 3 tombol yang masing-masing memindahkan tahapan, sebuah file, atau tautan ke halaman statusnya
ask_locationmeminta orang itu membagikan di mana ia berada
send_formmengirim formulir tindak lanjut; yang kembali dilampirkan ke kiriman ini
emailke pemilik, penerima tugas, orang itu, atau alamat mana pun, dengan file terlampir
notifyemail ke penerima tugas, sebuah peran, atau semua orang di tim
http, openapi, mcpmemanggil koneksi dan menyimpan sebagian jawaban di field
waitlanjut nanti, hanya jika kondisinya masih berlaku
stopberhenti 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.

Resep 1: penawaran besar diteruskan ke manajer

{
  "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
    }
  ]
}

Resep 2: kirim penawaran, minta jawaban, ingatkan setelah tiga hari

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."
    }
  ]
}

Resep 3: sisihkan pembacaan meteran yang tampak salah

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

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.

Permintaan HTTP

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"
}

Dokumen OpenAPI

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"
}

Server MCP

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.

Placeholder

Setiap teks dan setiap parameter aksi bisa memakai placeholder dalam kurung kurawal. Nama yang tidak dikenal tetap seperti yang Anda ketik.

PlaceholderMenjadi
{<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) }

Rumus

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 tulisArtinya
+ - * / %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.

Untuk developer dan agen AI

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.

  1. 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.
  2. POST /submit/setup dengan "dry_run": true: tidak ada yang ditulis; setiap masalah kembali beserta path-nya dan satu kalimat yang menyatakan cara memperbaikinya.
  3. POST /submit/setup tanpa dry_run: daftar, koneksi, formulir, dan otomatisasi diterapkan bersama. Jika ada masalah apa pun, tidak ada yang ditulis.
  4. POST /submit/forms/{key}/publish, atau sebutkan formulir di "publish" pada dokumen setup.
  5. Bagikan tautan formulir (GET /submit/forms/{key} mengembalikannya), lalu baca GET /submit/submissions atau dengarkan event webhook.

Panggilan setup yang lengkap

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": []
}

Rute lainnya

  • Pengaturan: GET / PUT /submit/settings.
  • Formulir: daftar, buat (dari definisi atau template), baca, perbarui, hapus, publikasikan, dan POST /submit/forms/{key}/send untuk mengirim formulir ke sebuah nomor dengan nilai yang sudah terisi.
  • Daftar: PUT /submit/lists/{key} mengganti baris sebuah daftar.
  • Kiriman: daftar (filter berdasarkan formulir, tahapan, penerima tugas, tag, saluran, kontak, teks, dan tanggal; 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.
  • Otomatisasi dan proses: daftar, buat, baca, perbarui, hapus, POST /submit/automations/try, dan log proses.
  • Koneksi: daftar, atur, hapus, uji, segarkan, dan fungsi yang bisa dipanggil sebuah aksi.
  • Tim dan laporan: undang, perbarui, dan hapus anggota; jumlah per formulir, tahapan, hari, dan penerima tugas.

Event webhook

Setiap webhook akun Anda menerima setiap event. Masing-masing membawa kiriman sebagaimana adanya pada saat itu; tautan file di dalamnya berlaku selama 7 hari.

EventKapan
submission.createdsebuah kiriman ada (file-nya mungkin masih tiba)
submission.files_readyfile-nya sudah tersimpan
submission.updatedjawaban, nilai internal, prioritas, tag, atau waktu tenggat berubah
submission.status_changedtahapan berubah
submission.assignedpenerima tugas berubah
submission.note_addedcatatan ditulis
submission.customer_repliedorang itu menambahkan teks, file, atau tindak lanjut, atau menekan tombol
submission.deleteddihapus atau dihapus permanen
submit.automation_failedotomatisasi menyerah setelah percobaan ulangnya

Tool MCP

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

BatasNilai
Formulir per nomor100
Langkah dalam formulir, pertanyaan dalam langkah12 dan 12 (60 pertanyaan dalam satu formulir, satu pertanyaan lokasi)
Daftar50, masing-masing hingga 1.000 baris
Otomatisasi, koneksi, anggota tim200, 30, 200
File dalam satu kiriman60
Ukuran file25 MB dari WhatsApp, 10 MB dari halaman web atau API
Catatan atau balasan4.000 karakter
Tag pada kiriman20
Panggilan ke sistem luar60 per menit dan 2.000 per hari per nomor; 15 detik dan 256 KB per panggilan
Log prosesdisimpan 30 hari

Belum tersedia

  • Menerima pembayaran pada kiriman (penawaran diterima, bukan dibayar).
  • Mengirim formulir sebagai formulir WhatsApp ke seseorang yang belum menulis kepada Anda dalam 24 jam terakhir: Anda mendapat tautan web pribadinya sebagai gantinya, untuk dikirim dengan template yang disetujui.
  • Tanda tangan.
  • Grup berulang ("tambah item lain").
  • Melompat ke formulir lain di tengah jalan.
  • Mengisi formulir tanpa koneksi.
  • Bahasa lain pada teks tetap halaman web (setiap teks formulir Anda sepenuhnya Anda yang menulis).
  • Dokumen OpenAPI dalam YAML atau Swagger 2, dan server MCP yang hanya mendukung transport SSE yang lebih lama.
  • Membaca nilai dari foto.

Semua yang di atas diatur di halaman Submit-Info dashboard (/dashboard/app/submit). Pertanyaan: support@app2email.com.