Submit-Info rehberi: bir soru listesinden form oluşturun, WhatsApp'ta ve bir web sayfasında yayınlayın, gönderimleri rollerle ortak bir gelen kutusunda aşamalardan geçirin, yanıtları ve kendi sistemlerinize yapılan çağrıları otomatikleştirin ve her şeyi API ya da bir yapay zeka ajanı üzerinden kurun.
Bir formu düz bir soru listesi olarak yazarsınız. app2email onu WhatsApp içinde bir forma ve aynı adımlara sahip bir web sayfasına dönüştürür. Bir müşteri ya da kendi saha personelinizden biri onu doldurur ve bir referans alır. Yanıtlar ve dosyalar, ortak bir gelen kutusunda bir gönderim olur; gönderim orada aşamalarınızdan geçer ve otomasyonlarınızı tetikler.
Tek fikir
Form, sonra gönderim, sonra aşamalar, sonra otomasyonlar, sonra bağlantılar. Bir teklif talebi, bir başvuru, bir sayaç okuması, bir sorun bildirimi, tamamlanmış bir iş, bir teslimat kanıtı ve bir gider makbuzu aynı şeydir; yalnızca soruları ve aşama adları farklıdır. Her biri, kurup değiştirebileceğiniz bir şablon olarak gelir.
Submit-Info'yu hiç açmayan bir numara için hiçbir şey değişmez. Henüz WhatsApp'ta yayınlanmamış bir form da çalışır: sözcüğü web sayfasının bağlantısıyla yanıt verir.
Bir formun 1 ile 12 arasında adımı vardır ve bir adımın bir başlığı ile 1 ile 12 arasında sorusu vardır. Çizilecek bir tuval ve bir şey yoktur: aynı liste WhatsApp'taki formu, web sayfasını, yanıtlar üzerindeki denetimleri, tablo görünümünün sütunlarını, dışa aktarmaları ve API'yi yönetir. Düzenleyicinin yanındaki önizleme formu bir kişinin gördüğü şekliyle gösterir.
| Tür | Kişinin verdiği | Neleri ayarlayabilirsiniz |
|---|---|---|
text | Kısa bir yanıt | en kısa ve en uzun uzunluk, bir desen |
textarea | Daha uzun bir yanıt | en kısa ve en uzun uzunluk |
number | Bir sayı | en düşük ve en yüksek değer, ondalıklar, kWh gibi bir birim |
email | Bir e-posta adresi | |
phone | Bir telefon numarası | |
date | Bir tarih | kaç gün geriye ya da ileriye olabileceği |
select | Tek bir seçim | seçenekler (2 ile 200 arası) ya da sizin bir listeniz |
multiselect | Birkaç seçim | seçenekler (2 ile 20 arası), işaretlenecek en az ve en çok sayı |
yesno | Evet ya da Hayır | |
rating | 1'den 3-10'a kadar bir puan | en yüksek puan |
consent | Kabul edilecek bir cümle | işaretlenmesinin zorunlu olup olmadığı |
photo | Bir ya da daha fazla fotoğraf | kaç tane (1 ile 10 arası); kamera, galeri ya da ikisi |
document | Bir ya da daha fazla dosya | kaç tane (1 ile 10 arası); herhangi bir dosya, PDF, resimler ya da ofis dosyaları |
location | Kişinin bulunduğu yer | WhatsApp'ta konum isteği; web'de bir düğme ve bir adres satırı |
info | Sizin gösterdiğiniz metin | hiçbir şey sorulmaz ya da saklanmaz |
hidden | Bağlantıyla birlikte gelen bir değer | bir iş numarası gibi; hiçbir şey gösterilmez |
{contact.name} gibi zaten bildiğiniz şeyleri kullanabilir.Web sayfası. Aynı adımlar /form/your-code/form-key adresinde. En son bir ad ve bir WhatsApp numarası sorar. Gönderdikten sonra kişi referansı görür ve numarasını tek bir mesajla doğrulayan "Get updates on WhatsApp" düğmesine dokunabilir; bir form bunu zorunlu kılacak şekilde ayarlanabilir. Sizin gönderdiğiniz kişisel bir bağlantı, kişinin kim olduğunu zaten bilir. Formu kendi sitenize koymak için Share altındaki kod parçasını kullanın; form bir konum soruyorsa iframe'e allow="geolocation" ekleyin. Fotoğraflar yüklenmeden önce tarayıcıda küçültülür; bir dosya en fazla 10 MB olabilir.
Kimler gönderebilir. Herkes (olağan seçim) ya da yalnızca listelediğiniz numaralar ya da sizin bir etiketinizi taşıyan kişiler. Bir form saha personelinizde böyle kalır. status sözcüğü kişiye son gönderimlerinin aşamasını yanıtlar.
Aşamalar forma aittir. Yeni bir form New, In progress ve Done ile başlar; bunları yeniden adlandırın, kendinizinkini ekleyin (2 ile 12 arası) ve bir renk seçin. Her aşama üç türden biridir: açık, tamamlandı ya da iptal edildi.
WhatsApp'ın yanıt süresinin dışında yazılan bir yanıt saklanır ve kişi bir dahaki sefere yazdığında teslim edilir. Gelen kutusu bunu yanıtın üzerinde söyler.
Inbox; Open, Mine, Unassigned, Done ve All görünümlerini ve kaydettiğiniz görünümleri gösterir. Form, aşama, atanan kişi, etiket, kanal ve tarihe göre arayın ve filtreleyin. Üç düzen: bir liste, bir tablo (bir form: her soru bir sütundur) ve bir pano (bir form: her aşama için bir sütun). Aşamayı değiştirmek, atamak, etiketlemek, dışa aktarmak ya da silmek için birkaç satırı birlikte işaretleyin.
Bir gönderim yanıtlarını, dosyalarını, nereden gönderildiğini ve ona olan her şeyin tek bir geçmişini gösterir: kimin ve neden yaptığıyla aşama değişiklikleri, notlar, iki yönde yanıtlar, dosyalar ve sonucuyla her otomasyon adımı. En altta ya dahili bir not ya da bir WhatsApp yanıtı yazarsınız. Herhangi bir görünümü CSV, Excel ya da JSON olarak, tek bir gönderimi PDF olarak dışa aktarın.
Ekibiniz. İnsanları yalnızca gelen kutusuna e-postayla davet edin. /desk adresinde kendilerine ait hafif bir uygulama alırlar ve hesabınızın geri kalanını asla görmezler. Rol, başlangıç yeteneklerinin bir kümesidir ve her yetenek bir kişi için açılıp kapatılabilir.
| Rol | Şunlarla başlar |
|---|---|
| Owner, Admin | Formlar, otomasyonlar, bağlantılar ve ekip dahil her şey |
| Manager | Notlar, yanıtlar, yanıtları düzenleme, aşamayı değiştirme, atama, dosyalar, dışa aktarma, silme, manuel eylemleri çalıştırma |
| Agent | Notlar, yanıtlar, yanıtları düzenleme, aşamayı değiştirme, dosyalar, manuel eylemleri çalıştırma. Bir gönderimi kendisi için alabilir |
| Viewer | Okuyabilir, başka bir şey yapamaz |
Bir kişinin gördüklerini de daraltabilirsiniz: yalnızca bazı formlar, yalnızca kendisine atananlar (alınacak atanmamış olanlarla ya da onlarsız) ve gizlenmiş iletişim bilgileri. Bir ekip üyesinin her eylemi gönderimin geçmişine yazılır.
Kişinin kendi sayfası. Her gönderimin /s/a-long-code adresinde, oturum açmayı gerektirmeyen özel bir sayfası vardır: aşama, şimdiye kadarki mesajlar ve aşama değişiklikleri, düğmeleriyle birlikte açık sorunuz ve form izin veriyorsa "Add information". Dahili notlar ve dahili alanlar onda asla bulunmaz.
Gizlilik. Bir kişiyi silmek, onun gönderimlerini ve dosyalarını da siler. Bir formun bir saklama süresi olabilir; bu süreden sonra kapatılmış gönderimler silinir.
Bir otomasyon bir cümle gibi okunur: bir şey ne zaman olur, bazı şeyler doğruysa, bunları sırayla yap. "Bir Quote request gönderildiğinde, miktar 20 ya da daha fazlaysa, onu Managers rolüne ata ve sahibine e-posta gönder."
| Ne zaman | Şu durumda çalışır |
|---|---|
submitted | bir gönderim tamamlandığında ve dosyaları ulaştığında |
status_changed | aşama değiştiğinde (isteğe bağlı: belirli aşamalara ya da aşamalardan) |
assigned | atandığı kişi değiştiğinde |
updated | yanıtlar ya da dahili alanlar düzenlendiğinde |
note_added | bir ekip üyesi bir not yazdığında |
file_added | daha sonra bir dosya eklendiğinde |
customer_replied | onu gönderen kişi metin ya da dosya eklediğinde |
button | kişi yanıtlarınızdan birinin düğmesine bastığında |
overdue | bir dakika sayısı sonra hâlâ aynı aşamada olduğunda |
due | açıkken vadesi geçtiğinde |
manual | bir ekip üyesi gönderimdeki eylemin düğmesine bastığında |
Eğer: yanıtlar, hesaplanan değerler, aşama, kanal, etiketler ve atanan kişi üzerinde kurallar. Bir kural bir alan, bir işleç ve bir değerdir: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Kuralları all (ve) ya da any (veya) ile birleştirin.
| Yap | Ne yapar |
|---|---|
set_status | onu bir aşamaya taşır, bir notla |
assign | bir üyeye, bir rol üzerinden sırayla, bir rolün en az meşgul olanına ya da hiç kimseye |
set_field, calculate | bir dahili alan yazar ya da bir formülle hesaplar |
tag, set_priority, set_due | etiketler, öncelik, bir vade zamanı |
reply | kişiye bir WhatsApp mesajı; her biri aşamayı değiştiren en fazla 3 düğmeyle, bir dosyayla ya da durum sayfasına bağlantıyla |
ask_location | kişiden nerede olduğunu paylaşmasını ister |
send_form | bir takip formu gönderir; geri gelen bu gönderime eklenir |
email | sahibine, atanan kişiye, kişiye ya da herhangi bir adrese, dosyalar ekli olarak |
notify | atanan kişiye, bir role ya da ekipteki herkese bir e-posta |
http, openapi, mcp | bir bağlantıyı çağırır ve yanıtın parçalarını alanlarda tutar |
wait | daha sonra devam eder, yalnızca koşullar hâlâ geçerliyse |
stop | burada sona erer |
Her çalıştırma adım adım günlüğe yazılır: ne gönderildi, ne geri geldi, ne kadar sürdü. "Try with a submission", bir otomasyonu gerçek bir gönderime karşı, hiçbir şeyi değiştirmeden ya da göndermeden çalıştırır. Dış bir sisteme yapılan ve başarısız olan bir çağrı 1 dakika, 10 dakika ve 1 saat sonra yeniden denenir; ondan sonra otomasyon başarısız olarak işaretlenir ve webhook'larınız submit.automation_failed alır. Birbirini tetikleyen otomasyonlar üç düzeyden sonra durdurulur.
{
"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, ekibinizin gönderimi Quoted aşamasına taşımadan önce doldurduğu dahili bir alandır. Hatırlatma yalnızca gönderim hâlâ Quoted aşamasındaysa gider.
{
"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 hesaplanan bir değerdir: 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."
}
]
}Bağlantı, bir otomasyonun çağırabileceği dış bir sistemdir. Hesabınızın webhook'larının hiçbirine ihtiyacı yoktur: her gönderim olayını olduğu anda alırlar (bkz. olaylar). Diğer her şey için üç tür vardır. Bir bağlantıda "Test" ve bir eylemde "Try with a submission", herhangi bir şey açılmadan önce gerçek isteği ve gerçek yanıtı gösterir.
Bir temel adres ve oturum açma yolu (yok, bir bearer token, bir başlık, kullanıcı adı ve parola ya da adresteki bir anahtar). Eylem yöntemi, yolu ve bir JSON gövdesini adlandırır. save, yanıtın parçalarını gönderimin alanlarında tutar.
{
"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"
}JSON biçimindeki bir OpenAPI 3 belgesinin adresini verin ya da yapıştırın. app2email işlemlerini okur; eylem birini kimliğiyle seçer ve parametrelerini doldurur. YAML ve Swagger 2 belgeleri okunmaz.
{
"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"
}Bir MCP sunucusunun (streamable HTTP) adresini ve token'ını verin. app2email sunucunun araçlarını listeler; eylem birini seçer ve argümanlarını doldurur. $text aracın tüm yanıtını metin olarak tutar.
{
"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"
}Bilmekte fayda var. Tam olarak tek bir yer tutucu olan bir değer türünü korur (bir sayı sayı olarak, bir liste liste olarak kalır). Sırlar şifreli saklanır, bir daha gösterilmez ve API tarafından asla döndürülmez. Adresler https ve herkese açık olmalıdır: özel, yerel ve dahili adresler reddedilir ve yönlendirmeler izlenmez. Bir çağrı 15 saniye sürebilir ve yanıtı 256 KB olabilir. save içinde bir yol $ (tüm yanıt) ya da $.data.items[0].id gibi düz bir yoldur.
Bir eylemin her metni ve her parametresi, süslü parantezler içinde yer tutucular kullanabilir. Bilinmeyen bir ad, yazdığınız gibi kalır.
| Yer tutucu | Şuna dönüşür |
|---|---|
{<field key>} | o sorunun yanıtı (ayrıca dahili alanlar, hesaplanan değerler ve bir otomasyonun kaydettiği değerler) |
{reference} | referans, örneğin MR-7Q3M2A |
{form} {form_key} | formun adı ve anahtarı |
{status} {status_name} | aşamanın anahtarı ve adı |
{channel} | whatsapp, web, api ya da staff |
{priority} {tags} | öncelik ve etiketler |
{created} {updated} {due} | zamanlar |
{contact.name} {contact.phone} {contact.email} | onu gönderen kişi |
{assignee.name} {assignee.email} | atandığı ekip üyesi |
{link} | kişinin kendi durum sayfası |
{desk_link} | ekibinizin gelen kutusundaki gönderim |
{answers} | tüm yanıtlar "Etiket: değer" satırları olarak |
{files} {files.<field key>} | tüm dosyalara ya da bir sorunun dosyalarına bağlantılar; başka bir sistem bunları 7 gün boyunca çekebilir |
{note} | aşama değişikliğinin notu ya da otomasyonu tetikleyen not |
{button} | kişinin bastığı düğme |
{business} | işletmenizin adı |
{submission} | bir JSON gövdesinde: tüm gönderim bir nesne olarak |
{= formula } | yerinde hesaplanan bir formül, örneğin {= round(qty * 1.1, 2) } |
Hesaplanan değerler, calculate eylemi ve herhangi bir metindeki {= ... } içinde kullanılır. Bir formül sayılarla, tek tırnak içindeki metinlerle ve sorularınızın anahtarlarıyla çalışır. 500 karakter uzunluğunda olabilir. Sıfıra bölmek ya da eksik bir sayı, hata yerine boş bir değer verir.
| Yazdığınız | Anlamı |
|---|---|
+ - * / % | sayılar ve yanıtlar üzerinde aritmetik |
== != > >= < <= | karşılaştırmalar |
and or not ( ) | mantık ve parantezler |
if(condition, a, b) | koşul sağlanıyorsa a, aksi halde b |
min(a, b, ...) max(a, b, ...) | en küçük, en büyük |
round(x, n) abs(x) | n ondalığa yuvarlama, bir sayının işaretsiz büyüklüğü |
num(x) len(x) | bir metni sayı olarak; bir metnin ya da listenin uzunluğu |
coalesce(a, b) | a ya da a boşsa b |
lower(x) upper(x) concat(a, b, ...) | metinler |
lookup('list', id, 'column') | listelerinizden birinin bir satırının bir sütunu, örneğin bir fiyat |
previous('field') | aynı kişinin o soruya verdiği son yanıt |
count_files('field') | bir sorunun kaç dosya tuttuğu |
days_since(date) | bir tarihten bugüne kadar geçen gün |
Örnekler: anlık bir tahmin için qty * lookup('prices', product, 'price'); kullanım için reading - previous('reading'); kimin onaylayacağına karar vermek için if(amount > 500, 'manager', 'agent').
Yukarıdaki her şey, {number} ülke koduyla ve yalnızca rakamlardan oluşan WhatsApp numaranız olmak üzere /v1/{number}/submit altında REST API içindedir. API anahtarınızı Authorization: Bearer YOUR_API_KEY olarak gönderin (X-API-KEY başlığı da kabul edilir). Anahtarın submissions:manage kapsamına ihtiyacı vardır; tam erişimli anahtarlarda bu vardır, Varsayılan anahtarda yoktur. Sandbox anahtarları yazamaz.
GET /submit/guide: tüm sözlüğü içeren tek bir JSON belgesi: seçenekleri ve limitleriyle soru türleri, aşama kuralları, tetikleyiciler, işleçler, parametreleriyle eylemler, yer tutucular, formül işlevleri, şablonlar ve çalışılmış örnekler."dry_run": true ile POST /submit/setup: hiçbir şey yazılmaz; her sorun yoluyla ve nasıl düzeltileceğini söyleyen bir cümleyle geri gelir.dry_run olmadan POST /submit/setup: listeler, bağlantılar, formlar ve otomasyonlar birlikte uygulanır. Herhangi bir sorun varsa hiçbir şey yazılmaz.POST /submit/forms/{key}/publish ya da formları kurulum belgesinin "publish" alanında adlandırın.GET /submit/forms/{key} bunları döndürür), ardından GET /submit/submissions okuyun ya da webhook olaylarını dinleyin.Aşağıdaki belgeyi setup.json olarak kaydedin ve gönderin. 61400000000 yerine kendi numaranızı yazın. Bir sayaç okuması çözümünü denetler: bir alan listesi, bir faturalama sistemine bağlantı, üç aşamalı ve hesaplanan bir kullanımlı bir form ve iki otomasyon. Uygulamak için "dry_run": true satırını kaldırın. Aynı anahtara sahip mevcut formlar, listeler ve bağlantılar değiştirilir; otomasyonlar form içinde ada göre eşleştirilir. Parçaların yerine "preset": "..." yazmak şablonlardan birini kurar (GET /submit/presets bunları listeler).
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"
]
}Gerçek çağrının yanıtı (dry_run olmadan):
{
"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.PUT /submit/lists/{key} bir listenin satırlarını değiştirir.updated_after; ?format=csv ile CSV), oluşturma, kimliğe ya da referansa göre okuma, güncelleme (aşama, not, öncelik, atanan kişi, vade zamanı, etiketler, yanıtlar, dahili alanlar), not ekleme, düğmelerle yanıtlama, dosya ekleme, silme.POST /submit/automations/try ve çalıştırma günlüğü.Hesabınızın her webhook'u her olayı alır. Her biri gönderimi o andaki haliyle taşır; içindeki dosya bağlantıları 7 gün çalışır.
| Olay | Ne zaman |
|---|---|
submission.created | bir gönderim var (dosyaları hâlâ geliyor olabilir) |
submission.files_ready | dosyaları saklandı |
submission.updated | yanıtlar, dahili değerler, öncelik, etiketler ya da vade zamanı değişti |
submission.status_changed | aşama değişti |
submission.assigned | atanan kişi değişti |
submission.note_added | bir not yazıldı |
submission.customer_replied | kişi metin, dosya ya da bir takip ekledi ya da bir düğmeye bastı |
submission.deleted | silindi ya da kaldırıldı |
submit.automation_failed | bir otomasyon yeniden denemelerinden sonra vazgeçti |
Her rota, app2email'in barındırılan MCP sunucusunda bir araçtır da; böylece bir asistan kurulumun tamamını bir konuşmada yapabilir: 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 ve daha fazlası. Asistana iyi bir ilk mesaj: "Submit-Info rehberini oku, sonra fotoğraflı ve konumlu bir sorun bildirimi formu kur ve acil olanları yöneticilerime bildir."
claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Asistanları ve otomasyon araçlarını bağlama hakkında daha fazlası: Otomasyon araçları ve ajanlar.
| Limit | Değer |
|---|---|
| Numara başına form | 100 |
| Bir formdaki adım, bir adımdaki soru | 12 ve 12 (bir formda 60 soru, bir konum sorusu) |
| Listeler | 50, her biri en fazla 1.000 satır |
| Otomasyonlar, bağlantılar, ekip üyeleri | 200, 30, 200 |
| Bir gönderimdeki dosyalar | 60 |
| Dosya boyutu | WhatsApp'tan 25 MB, web sayfasından ya da API'den 10 MB |
| Bir not ya da bir yanıt | 4.000 karakter |
| Bir gönderimdeki etiketler | 20 |
| Dış sistemlere çağrılar | numara başına dakikada 60 ve günde 2.000; çağrı başına 15 saniye ve 256 KB |
| Çalıştırma günlüğü | 30 gün saklanır |
Yukarıdakilerin hepsi panelin Submit-Info sayfasında (/dashboard/app/submit) ayarlanır. Sorularınız için: support@app2email.com.