app2email API Harga

Dokumentasi

Submit-Info

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.

Mula dalam lima minit

  1. Bukanya: dalam papan pemuka, buka halaman Submit-Info (/dashboard/app/submit, juga boleh dibuka dari Integrations). Hidupkannya.
  2. Buat borang: pilih "New form" dan pilih templat, atau mulakan dari kosong. Beri nama dan tulis soalan anda. Setiap soalan ialah satu baris: teksnya, jenisnya, dan sama ada ia wajib dijawab.
  3. Terbitkan: "Publish to WhatsApp" memuat naik borang ke WhatsApp dan menjadikannya aktif. Halaman web dengan langkah yang sama aktif serta-merta.
  4. Kongsi: di bawah Share anda akan dapati perkataan yang membuka borang dalam sembang anda, pautan yang membuka sembang anda dengan perkataan itu sudah ditaip, alamat halaman web, kod QR, dan kod untuk meletakkan borang di laman web anda sendiri.
  5. Uruskan peti masuk: penyerahan baharu tiba dalam Inbox. Buka satu, tukar peringkatnya, balas. Jemput pasukan anda apabila anda sedia.

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.

Pembina borang

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.

JenisApa yang diberikan oleh orang ituApa yang boleh anda tetapkan
textJawapan pendekpanjang terpendek dan terpanjang, corak
textareaJawapan yang lebih panjangpanjang terpendek dan terpanjang
numberNombornilai terendah dan tertinggi, perpuluhan, unit seperti kWh
emailAlamat e-mel
phoneNombor telefon
dateTarikhberapa hari ke belakang atau ke hadapan yang dibenarkan
selectSatu pilihanpilihan (2 hingga 200), atau senarai anda sendiri
multiselectBeberapa pilihanpilihan (2 hingga 20), bilangan minimum dan maksimum untuk ditanda
yesnoYa atau Tidak
ratingMarkah dari 1 hingga 3-10markah tertinggi
consentAyat untuk dipersetujuisama ada ia mesti ditanda
photoSatu atau lebih gambarberapa banyak (1 hingga 10); kamera, galeri atau mana-mana
documentSatu atau lebih failberapa banyak (1 hingga 10); mana-mana fail, PDF, gambar atau fail pejabat
locationDi mana orang itu beradapada WhatsApp, permintaan lokasi; pada web, butang dan baris alamat
infoTeks yang anda tunjukkantiada yang ditanya atau disimpan
hiddenNilai yang datang bersama pautanseperti nombor kerja; tiada yang dipaparkan
  • Teks bantuan dan nilai lalai: setiap soalan boleh mempunyai petunjuk ringkas dan nilai lalai. Nilai lalai boleh menggunakan apa yang sudah anda ketahui, seperti {contact.name}.
  • Tunjuk hanya apabila: sesuatu langkah atau soalan boleh bergantung pada jawapan sebelumnya ("tunjuk langkah ini hanya apabila Masalah ialah Ya"). WhatsApp dan halaman web mengikut peraturan yang sama.
  • Medan dalaman: medan yang tidak pernah ditanya. Pasukan anda atau automasi mengisinya: jumlah sebut harga, sebab keputusan, id yang dikembalikan daripada sistem lain. Ia hanya dipaparkan dalam peti masuk dan eksport.
  • Senarai: soalan pilihan boleh mengambil pilihannya daripada senarai anda (tapak, kerja, produk dengan harga). Tukar senarai dalam papan pemuka atau melalui API dan borang akan mengikutinya, tanpa perlu menerbitkan semula.
  • Nilai yang dikira: formula ke atas jawapan, untuk anggaran serta-merta atau semakan. Lihat formula.
  • Selepas hantar: skrin semakan sebelum menghantar, balasan dengan rujukan, butang "Add more" yang melampirkan mesej seterusnya (teks, gambar, fail) pada penyerahan selama sepuluh minit, dan pautan ke halaman status peribadi orang itu.
  • Penerbitan: app2email menulis borang WhatsApp untuk anda, membahagikan langkah yang panjang kepada beberapa skrin apabila had WhatsApp memerlukannya, dan menyimpan lima versi terbitan terakhir supaya mesej lama masih membuka borang yang dihantar bersamanya.

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.

Cara orang sampai ke borang

  • Perkataan: setiap borang mempunyai perkataannya sendiri. Perkataan form, forms, report dan submit (anda boleh mengubahnya) menyenaraikan borang anda sebagai menu apabila ada beberapa borang. Perkataan hanya dikira dalam mesej pendek: mesej yang mempunyai kurang daripada 10 perkataan lain (Settings, "Ignore the words in long messages"), jadi mesej panjang yang kebetulan mengandunginya tidak akan memulakan apa-apa.
  • Pautan atau kod QR: pautan yang membuka sembang WhatsApp anda dengan perkataan borang itu, atau alamat halaman web.
  • Dihantar oleh anda: "Send form" dalam peti masuk, atau API, menghantar borang ke satu nombor, dengan nilai yang sudah diisi (nombor kerja, akaun, dokumen yang anda mahukan).
  • Susulan: automasi atau ahli pasukan meminta lebih banyak dengan borang kedua. Apa yang dikembalikan dilampirkan pada penyerahan pertama.
  • Halaman web, dan API untuk sistem yang sudah memegang data.

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

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.

  • Siapa boleh memilihnya: simpan peringkat untuk peranan tertentu. Ejen menyediakan, hanya Manager yang meluluskan.
  • Nota diperlukan: minta sebab apabila penyerahan dipindahkan ke situ (ditolak, dinafikan, dipersoalkan).
  • Mesej: teks yang dihantar kepada orang itu apabila penyerahan mereka sampai ke peringkat tersebut, dengan tempat letak.
  • Butang untuk orang itu: satu balasan boleh membawa sehingga tiga butang (Accept, Decline, "Not fixed yet"), dan setiap butang memindahkan peringkat. Satu bahagian ini sahaja memberi anda penerimaan sebut harga, pengesahan lawatan dan "sudah dibaiki?".

Balasan yang ditulis di luar masa balas WhatsApp disimpan dan dihantar apabila orang itu menulis lagi. Peti masuk memberitahu perkara itu pada balasan tersebut.

Peti masuk dan peranan

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.

PerananBermula dengan
Owner, AdminSemuanya, termasuk borang, automasi, sambungan dan pasukan
ManagerNota, balasan, mengedit jawapan, menukar peringkat, menugaskan, fail, eksport, memadam, menjalankan tindakan manual
AgentNota, balasan, mengedit jawapan, menukar peringkat, fail, menjalankan tindakan manual. Boleh mengambil penyerahan untuk diri sendiri
ViewerBoleh 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

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

ApabilaIa berjalan apabila
submittedpenyerahan lengkap dan failnya sudah tiba
status_changedperingkat bertukar (pilihan: kepada atau daripada peringkat tertentu)
assignedorang yang ditugaskan bertukar
updatedjawapan atau medan dalaman diedit
note_addedahli pasukan menulis nota
file_addedfail ditambah kemudian
customer_repliedorang yang menghantarnya menambah teks atau fail
buttonorang itu menekan butang pada salah satu balasan anda
overdueia masih berada di peringkat yang sama selepas beberapa minit
duemasa tamatnya berlalu semasa ia masih terbuka
manualahli 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).

LakukanApa yang dibuatnya
set_statuspindahkan ke satu peringkat, dengan nota
assignkepada seorang ahli, secara giliran dalam satu peranan, kepada yang paling kurang sibuk dalam peranan, atau kepada tiada siapa
set_field, calculatetulis medan dalaman, atau kira dengan formula
tag, set_priority, set_duetag, keutamaan, masa tamat
replymesej WhatsApp kepada orang itu, dengan sehingga 3 butang yang setiap satunya memindahkan peringkat, satu fail, atau pautan ke halaman status mereka
ask_locationminta orang itu berkongsi di mana mereka berada
send_formhantar borang susulan; apa yang dikembalikan dilampirkan pada penyerahan ini
emailkepada pemilik, penerima tugas, orang itu, atau sebarang alamat, dengan fail dilampirkan
notifye-mel kepada penerima tugas, satu peranan, atau semua ahli pasukan
http, openapi, mcppanggil satu sambungan dan simpan sebahagian jawapan dalam medan
waitteruskan kemudian, hanya jika syaratnya masih benar
stoptamatkan 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.

Resipi 1: sebut harga besar pergi kepada pengurus

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

Resipi 2: hantar sebut harga, minta jawapan, ingatkan selepas tiga hari

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

Resipi 3: ketepikan bacaan meter yang kelihatan salah

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

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.

Permintaan HTTP

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

Dokumen OpenAPI

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

Pelayan MCP

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.

Tempat letak

Setiap teks dan setiap parameter tindakan boleh menggunakan tempat letak dalam kurungan kerawang. Nama yang tidak dikenali kekal seperti yang anda taip.

Tempat letakMenjadi
{<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) }

Formula

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

Untuk pembangun dan ejen AI

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.

  1. 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.
  2. POST /submit/setup dengan "dry_run": true: tiada apa yang ditulis; setiap masalah dikembalikan dengan laluannya dan satu ayat yang menerangkan cara membetulkannya.
  3. POST /submit/setup tanpa dry_run: senarai, sambungan, borang dan automasi digunakan serentak. Jika ada sebarang masalah, tiada apa yang ditulis.
  4. POST /submit/forms/{key}/publish, atau namakan borang dalam "publish" pada dokumen persediaan.
  5. Kongsi pautan borang (GET /submit/forms/{key} mengembalikannya), kemudian baca GET /submit/submissions atau dengar peristiwa webhook.

Panggilan persediaan lengkap

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

Laluan lain

  • Tetapan: GET / PUT /submit/settings.
  • Borang: senarai, cipta (daripada definisi atau templat), baca, kemas kini, padam, terbit, dan POST /submit/forms/{key}/send untuk menghantar borang ke satu nombor dengan nilai yang sudah diisi.
  • Senarai: PUT /submit/lists/{key} menggantikan baris bagi satu senarai.
  • Penyerahan: senarai (tapis mengikut borang, peringkat, penerima tugas, tag, saluran, kenalan, teks dan tarikh; 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.
  • Automasi dan larian: senarai, cipta, baca, kemas kini, padam, POST /submit/automations/try, dan log larian.
  • Sambungan: senarai, tetapkan, padam, uji, muat semula, dan fungsi yang boleh dipanggil oleh tindakan.
  • Pasukan dan laporan: jemput, kemas kini dan buang ahli; kiraan mengikut borang, peringkat, hari dan penerima tugas.

Peristiwa webhook

Setiap webhook akaun anda menerima setiap peristiwa. Setiap satu membawa penyerahan seperti keadaannya pada masa itu; pautan fail di dalamnya berfungsi selama 7 hari.

PeristiwaBila
submission.createdpenyerahan wujud (failnya mungkin masih tiba)
submission.files_readyfailnya sudah disimpan
submission.updatedjawapan, nilai dalaman, keutamaan, tag atau masa tamat berubah
submission.status_changedperingkat berubah
submission.assignedpenerima tugas berubah
submission.note_addednota ditulis
submission.customer_repliedorang itu menambah teks, fail atau susulan, atau menekan butang
submission.deleteddipadam atau dihapuskan
submit.automation_failedsesuatu automasi berhenti selepas cubaan semula

Alat MCP

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

HadNilai
Borang setiap nombor100
Langkah dalam borang, soalan dalam langkah12 dan 12 (60 soalan dalam borang, satu soalan lokasi)
Senarai50, setiap satu sehingga 1,000 baris
Automasi, sambungan, ahli pasukan200, 30, 200
Fail dalam satu penyerahan60
Saiz fail25 MB dari WhatsApp, 10 MB dari halaman web atau API
Nota atau balasan4,000 aksara
Tag pada penyerahan20
Panggilan ke sistem luar60 seminit dan 2,000 sehari setiap nombor; 15 saat dan 256 KB setiap panggilan
Log lariandisimpan selama 30 hari

Belum tersedia

  • Mengambil bayaran pada penyerahan (sebut harga diterima, bukan dibayar).
  • Menghantar borang kepada seseorang yang tidak menulis kepada anda dalam 24 jam terakhir sebagai borang WhatsApp: anda mendapat pautan web peribadi mereka, untuk dihantar dengan mana-mana templat yang diluluskan.
  • Tandatangan.
  • Kumpulan berulang ("add another item").
  • Melompat ke borang lain di pertengahan.
  • Mengisi borang tanpa sambungan.
  • Bahasa lain dalam teks tetap halaman web (setiap teks borang anda adalah milik anda untuk ditulis).
  • Dokumen OpenAPI dalam YAML atau Swagger 2, dan pelayan MCP yang hanya menggunakan pengangkutan SSE lama.
  • Membaca nilai dari gambar.

Semua di atas ditetapkan pada halaman Submit-Info papan pemuka (/dashboard/app/submit). Soalan: support@app2email.com.