app2email API Fiyatlandırma

Belgeler

Submit-Info

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.

Beş dakikada başlayın

  1. Açın: panelinizde Submit-Info sayfasını açın (/dashboard/app/submit, Integrations'tan da açılır). Açık konuma getirin.
  2. Bir form oluşturun: "New form" seçeneğini seçin ve bir şablon seçin ya da boş başlayın. Ona bir ad verin ve sorularınızı yazın. Her soru bir satırdır: metni, türü ve yanıtlanmasının zorunlu olup olmadığı.
  3. Yayınlayın: "Publish to WhatsApp" formu WhatsApp'a yükler ve canlıya alır. Aynı adımlara sahip web sayfası hemen yayındadır.
  4. Paylaşın: Share altında formu sohbetinizde açan sözcüğü, o sözcük yazılmış olarak sohbetinizi açan bir bağlantıyı, web sayfasının adresini, bir QR kodunu ve formu kendi web sitenize koymak için bir kod parçasını bulursunuz.
  5. Gelen kutusunu yönetin: yeni gönderimler Inbox'a düşer. Birini açın, aşamasını değiştirin, yanıtlayın. Hazır olduğunuzda ekibinizi davet edin.

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.

Form oluşturucu

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ürKişinin verdiğiNeleri ayarlayabilirsiniz
textKısa bir yanıten kısa ve en uzun uzunluk, bir desen
textareaDaha uzun bir yanıten kısa ve en uzun uzunluk
numberBir sayıen düşük ve en yüksek değer, ondalıklar, kWh gibi bir birim
emailBir e-posta adresi
phoneBir telefon numarası
dateBir tarihkaç gün geriye ya da ileriye olabileceği
selectTek bir seçimseçenekler (2 ile 200 arası) ya da sizin bir listeniz
multiselectBirkaç seçimseçenekler (2 ile 20 arası), işaretlenecek en az ve en çok sayı
yesnoEvet ya da Hayır
rating1'den 3-10'a kadar bir puanen yüksek puan
consentKabul edilecek bir cümleişaretlenmesinin zorunlu olup olmadığı
photoBir ya da daha fazla fotoğrafkaç tane (1 ile 10 arası); kamera, galeri ya da ikisi
documentBir ya da daha fazla dosyakaç tane (1 ile 10 arası); herhangi bir dosya, PDF, resimler ya da ofis dosyaları
locationKişinin bulunduğu yerWhatsApp'ta konum isteği; web'de bir düğme ve bir adres satırı
infoSizin gösterdiğiniz metinhiçbir şey sorulmaz ya da saklanmaz
hiddenBağlantıyla birlikte gelen bir değerbir iş numarası gibi; hiçbir şey gösterilmez
  • Yardım metni ve varsayılanlar: her soru kısa bir ipucu ve bir varsayılan değer taşıyabilir. Bir varsayılan, {contact.name} gibi zaten bildiğiniz şeyleri kullanabilir.
  • Yalnızca şu durumda göster: bir adım ya da soru önceki bir yanıta bağlı olabilir ("bu adımı yalnızca Sorun Evet ise göster"). WhatsApp ve web sayfası aynı kuralı izler.
  • Dahili alanlar: hiç sorulmayan alanlar. Ekibiniz ya da bir otomasyon bunları doldurur: bir teklif tutarı, bir karar nedeni, başka bir sistemden geri gelen bir kimlik. Yalnızca gelen kutusunda ve dışa aktarmalarda görünürler.
  • Listeler: bir seçim sorusu seçeneklerini sizin bir listenizden alabilir (alanlar, işler, fiyatlı ürünler). Listeyi panelde ya da API üzerinden değiştirin; form onu izler, yeniden yayınlamanız gerekmez.
  • Hesaplanan değerler: yanıtlar üzerinde bir formül; anlık bir tahmin ya da bir denetim için. Bkz. formüller.
  • Gönderdikten sonra: göndermeden önce bir gözden geçirme ekranı, referansı içeren yanıt, sonraki mesajları (metin, fotoğraflar, dosyalar) on dakika boyunca gönderime ekleyen bir "Add more" düğmesi ve kişinin kendi durum sayfasına bağlantı.
  • Yayınlama: app2email WhatsApp formunu sizin için yazar, WhatsApp'ın limitleri gerektirdiğinde uzun bir adımı birkaç ekrana böler ve son beş yayınlanmış sürümü saklar; böylece eski bir mesaj, gönderildiği formu yine açar.

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.

İnsanlar bir forma nasıl ulaşır

  • Bir sözcük: her formun kendi sözcükleri vardır. form, forms, report ve submit sözcükleri (değiştirebilirsiniz) birden çok form olduğunda formlarınızı bir menü olarak listeler. Bir sözcük yalnızca kısa bir mesajda sayılır: başka 10'dan az sözcük içeren bir mesajda (Settings, "Ignore the words in long messages"); bu yüzden tesadüfen onu içeren uzun bir mesaj hiçbir şey başlatmaz.
  • Bir bağlantı ya da QR kodu: WhatsApp sohbetinizi formun sözcüğüyle açan bir bağlantı ya da web sayfasının adresi.
  • Sizin gönderdiğiniz: gelen kutusundaki "Send form" ya da API, bir formu bir numaraya, değerler önceden doldurulmuş olarak (bir iş numarası, bir hesap, istediğiniz belgeler) gönderir.
  • Bir takip: bir otomasyon ya da bir ekip üyesi ikinci bir formla daha fazlasını ister. Geri gelen, ilk gönderime eklenir.
  • Web sayfası ve verileri zaten elinde tutan sistemler için API.

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

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.

  • Kimler seçebilir: bir aşamayı belirli roller için ayırın. Bir Agent hazırlar, yalnızca bir Manager onaylar.
  • Not zorunlu: bir gönderim oraya taşındığında bir neden isteyin (reddedildi, geri çevrildi, sorgulandı).
  • Mesaj: kişinin gönderimi aşamaya ulaştığında kişiye gönderilen, yer tutuculu bir metin.
  • Kişi için düğmeler: bir yanıt en fazla üç düğme taşıyabilir (Accept, Decline, "Not fixed yet") ve her biri aşamayı değiştirir. Bu tek parça size teklif kabulünü, bir ziyareti onaylamayı ve "düzeldi mi?" sorusunu verir.

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.

Gelen kutusu ve roller

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, AdminFormlar, otomasyonlar, bağlantılar ve ekip dahil her şey
ManagerNotlar, yanıtlar, yanıtları düzenleme, aşamayı değiştirme, atama, dosyalar, dışa aktarma, silme, manuel eylemleri çalıştırma
AgentNotlar, yanıtlar, yanıtları düzenleme, aşamayı değiştirme, dosyalar, manuel eylemleri çalıştırma. Bir gönderimi kendisi için alabilir
ViewerOkuyabilir, 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.

Otomasyonlar

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
submittedbir gönderim tamamlandığında ve dosyaları ulaştığında
status_changedaşama değiştiğinde (isteğe bağlı: belirli aşamalara ya da aşamalardan)
assignedatandığı kişi değiştiğinde
updatedyanıtlar ya da dahili alanlar düzenlendiğinde
note_addedbir ekip üyesi bir not yazdığında
file_addeddaha sonra bir dosya eklendiğinde
customer_repliedonu gönderen kişi metin ya da dosya eklediğinde
buttonkişi yanıtlarınızdan birinin düğmesine bastığında
overduebir dakika sayısı sonra hâlâ aynı aşamada olduğunda
dueaçıkken vadesi geçtiğinde
manualbir 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.

YapNe yapar
set_statusonu bir aşamaya taşır, bir notla
assignbir üyeye, bir rol üzerinden sırayla, bir rolün en az meşgul olanına ya da hiç kimseye
set_field, calculatebir dahili alan yazar ya da bir formülle hesaplar
tag, set_priority, set_dueetiketler, öncelik, bir vade zamanı
replykiş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_locationkişiden nerede olduğunu paylaşmasını ister
send_formbir takip formu gönderir; geri gelen bu gönderime eklenir
emailsahibine, atanan kişiye, kişiye ya da herhangi bir adrese, dosyalar ekli olarak
notifyatanan kişiye, bir role ya da ekipteki herkese bir e-posta
http, openapi, mcpbir bağlantıyı çağırır ve yanıtın parçalarını alanlarda tutar
waitdaha sonra devam eder, yalnızca koşullar hâlâ geçerliyse
stopburada 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.

Tarif 1: büyük teklifler bir yöneticiye gider

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

Tarif 2: teklifi gönderin, yanıt isteyin, üç gün sonra hatırlatın

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

Tarif 3: yanlış görünen bir sayaç okumasını kenara alın

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ılar

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.

HTTP isteği

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

OpenAPI belgesi

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

MCP sunucusu

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.

Yer tutucular

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

Formüller

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ızAnlamı
+ - * / %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').

Geliştiriciler ve yapay zeka ajanları için

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.

  1. 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.
  2. "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.
  3. 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.
  4. POST /submit/forms/{key}/publish ya da formları kurulum belgesinin "publish" alanında adlandırın.
  5. Formun bağlantılarını paylaşın (GET /submit/forms/{key} bunları döndürür), ardından GET /submit/submissions okuyun ya da webhook olaylarını dinleyin.

Eksiksiz bir kurulum çağrısı

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

Diğer rotalar

  • Ayarlar: GET / PUT /submit/settings.
  • Formlar: listeleme, oluşturma (bir tanımdan ya da şablondan), okuma, güncelleme, silme, yayınlama ve bir formu değerler doldurulmuş olarak bir numaraya göndermek için POST /submit/forms/{key}/send.
  • Listeler: PUT /submit/lists/{key} bir listenin satırlarını değiştirir.
  • Gönderimler: listeleme (forma, aşamaya, atanan kişiye, etikete, kanala, kişiye, metne ve tarihlere göre filtreleme; senkronizasyon için 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.
  • Otomasyonlar ve çalıştırmalar: listeleme, oluşturma, okuma, güncelleme, silme, POST /submit/automations/try ve çalıştırma günlüğü.
  • Bağlantılar: listeleme, ayarlama, silme, test etme, yenileme ve bir eylemin çağırabileceği işlevler.
  • Ekip ve rapor: üyeleri davet etme, güncelleme ve kaldırma; forma, aşamaya, güne ve atanan kişiye göre sayılar.

Webhook olayları

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.

OlayNe zaman
submission.createdbir gönderim var (dosyaları hâlâ geliyor olabilir)
submission.files_readydosyaları saklandı
submission.updatedyanıtlar, dahili değerler, öncelik, etiketler ya da vade zamanı değişti
submission.status_changedaşama değişti
submission.assignedatanan kişi değişti
submission.note_addedbir not yazıldı
submission.customer_repliedkişi metin, dosya ya da bir takip ekledi ya da bir düğmeye bastı
submission.deletedsilindi ya da kaldırıldı
submit.automation_failedbir otomasyon yeniden denemelerinden sonra vazgeçti

MCP araçları

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.

Limitler

LimitDeğer
Numara başına form100
Bir formdaki adım, bir adımdaki soru12 ve 12 (bir formda 60 soru, bir konum sorusu)
Listeler50, her biri en fazla 1.000 satır
Otomasyonlar, bağlantılar, ekip üyeleri200, 30, 200
Bir gönderimdeki dosyalar60
Dosya boyutuWhatsApp'tan 25 MB, web sayfasından ya da API'den 10 MB
Bir not ya da bir yanıt4.000 karakter
Bir gönderimdeki etiketler20
Dış sistemlere çağrılarnumara 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

Henüz mevcut değil

  • Bir gönderim üzerinden ödeme almak (bir teklif kabul edilir, ödenmez).
  • Son 24 saatte size yazmamış birine bir WhatsApp formu olarak form göndermek: bunun yerine, onaylı herhangi bir şablonla göndermeniz için kişisel web bağlantısını alırsınız.
  • İmzalar.
  • Yinelenen gruplar ("başka bir öğe ekle").
  • Yarı yolda farklı bir forma atlamak.
  • Bir formu bağlantı olmadan doldurmak.
  • Web sayfasının sabit metinlerinde diğer diller (formunuzun her metni sizin yazacağınız şeydir).
  • YAML ya da Swagger 2 biçimindeki OpenAPI belgeleri ve yalnızca eski SSE aktarımını konuşan MCP sunucuları.
  • Fotoğraflardan değer okumak.

Yukarıdakilerin hepsi panelin Submit-Info sayfasında (/dashboard/app/submit) ayarlanır. Sorularınız için: support@app2email.com.