app2email API Ceník

Dokumentace

Submit-Info

Průvodce Submit-Info: sestavte formulář ze seznamu otázek, zveřejněte jej na WhatsAppu a na webové stránce, zpracovávejte podání přes fáze ve sdílené schránce s rolemi, automatizujte odpovědi a volání vašich vlastních systémů a nastavte vše přes API nebo AI agenta.

Formulář napíšete jako prostý seznam otázek. app2email z něj udělá formulář uvnitř WhatsAppu a webovou stránku se stejnými kroky. Zákazník nebo člen vaší terénní party jej vyplní a dostane referenci. Odpovědi a soubory se stanou podáním ve sdílené schránce, kde se podání posouvá přes vaše fáze a spouští vaše automatizace.

Jedna myšlenka

Formulář, pak podání, pak fáze, pak automatizace, pak připojení. Žádost o nabídku, přihláška, odečet měřiče, hlášení problému, dokončená zakázka, potvrzení doručení a účtenka za výdaj jsou totéž s jinými otázkami a jinými názvy fází. Každé je k dispozici jako šablona, kterou si můžete nainstalovat a upravit.

Začněte za pět minut

  1. Otevřete to: ve vašem dashboardu otevřete stránku Submit-Info (/dashboard/app/submit, otevřete ji také z Integrations). Zapněte ji.
  2. Vytvořte formulář: zvolte „New form“ a vyberte šablonu, nebo začněte s prázdným. Dejte mu název a napište své otázky. Každá otázka je jeden řádek: její text, její typ a zda musí být zodpovězena.
  3. Zveřejněte: „Publish to WhatsApp“ nahraje formulář na WhatsApp a zpřístupní jej. Webová stránka se stejnými kroky je zpřístupněna okamžitě.
  4. Sdílejte: v části Share najdete slovo, které otevře formulář ve vašem chatu, odkaz, který otevře váš chat s tímto slovem již napsaným, adresu webové stránky, QR kód a úryvek kódu pro vložení formuláře na vaše vlastní webové stránky.
  5. Pracujte se schránkou: nová podání přicházejí do Inboxu. Otevřete jedno, změňte jeho fázi, odpovězte. Až budete připraveni, pozvěte svůj tým.

Pro číslo, které nikdy neotevře Submit-Info, se nic nemění. Formulář, který ještě není zveřejněn na WhatsAppu, funguje dál: jeho slovo odpoví odkazem na webovou stránku.

Editor formulářů

Formulář má 1 až 12 kroků a krok má název a 1 až 12 otázek. Není tu plátno ani nic, co byste kreslili: tentýž seznam řídí formulář na WhatsAppu, webovou stránku, kontroly odpovědí, sloupce tabulkového zobrazení, exporty i API. Náhled vedle editoru ukazuje formulář tak, jak jej vidí člověk.

TypCo osoba zadáCo můžete nastavit
textKrátkou odpověďnejkratší a nejdelší délku, vzor
textareaDelší odpověďnejkratší a nejdelší délku
numberČíslonejnižší a nejvyšší hodnotu, desetinná místa, jednotku, například kWh
emailE-mailovou adresu
phoneTelefonní číslo
dateDatumo kolik dní zpět nebo dopředu smí být
selectJednu volbumožnosti (2 až 200), nebo váš vlastní seznam
multiselectNěkolik volebmožnosti (2 až 20), nejméně a nejvíce možností k zaškrtnutí
yesnoAno nebo Ne
ratingZnámku od 1 až do 3-10nejvyšší známku
consentVětu, se kterou souhlasízda musí být zaškrtnuta
photoJednu nebo více fotografiíkolik (1 až 10); fotoaparát, galerie nebo obojí
documentJeden nebo více souborůkolik (1 až 10); libovolný soubor, PDF, obrázky nebo kancelářské soubory
locationKde se osoba nacházína WhatsAppu žádost o polohu; na webu tlačítko a řádek s adresou
infoText, který zobrazujetenic se nezjišťuje ani neukládá
hiddenHodnotu, která přijde s odkazemnapříklad číslo zakázky; nic se nezobrazuje
  • Nápověda a výchozí hodnoty: každá otázka může mít krátkou nápovědu a výchozí hodnotu. Výchozí hodnota může použít to, co už víte, například {contact.name}.
  • Zobrazit jen tehdy, když: krok nebo otázka může záviset na dřívější odpovědi („zobrazit tento krok jen tehdy, když je Problém Ano“). WhatsApp i webová stránka se řídí stejným pravidlem.
  • Interní pole: pole, na která se nikdy neptá. Váš tým nebo automatizace je vyplní: částku nabídky, důvod rozhodnutí, id, které přišlo z jiného systému. Zobrazují se jen v inboxu a v exportech.
  • Seznamy: otázka s volbou může čerpat možnosti z vašeho seznamu (lokality, zakázky, produkty s cenami). Změňte seznam v dashboardu nebo přes API a formulář se podle něj zaktualizuje, bez nutnosti znovu zveřejňovat.
  • Vypočítané hodnoty: vzorec nad odpověďmi, pro okamžitý odhad nebo kontrolu. Viz vzorce.
  • Po odeslání: obrazovka s přehledem před odesláním, odpověď s referencí, tlačítko „Add more“, které k podání během deseti minut připojí další zprávy (text, fotografie, soubory), a odkaz na vlastní stránku stavu dané osoby.
  • Zveřejňování: app2email připraví formulář pro WhatsApp za vás, rozdělí dlouhý krok na více obrazovek, pokud to vyžadují limity WhatsAppu, a uchovává posledních pět zveřejněných verzí, takže starší zpráva stále otevře formulář, se kterým byla odeslána.

Webová stránka. Tytéž kroky na adrese /form/your-code/form-key. Jméno a číslo WhatsAppu se ptá jako poslední. Po odeslání vidí osoba referenci a může klepnout na „Get updates on WhatsApp“, což jejich číslo potvrdí jednou zprávou; formulář lze nastavit tak, aby to vyžadoval. Osobní odkaz (který posíláte vy) již ví, kdo osoba je. Chcete-li formulář vložit na své vlastní webové stránky, použijte úryvek pod Share; pokud formulář žádá polohu, přidejte do iframe allow="geolocation". Fotografie se v prohlížeči před nahráním zmenší; soubor může mít až 10 MB.

Jak se lidé k formuláři dostanou

  • Slovo: každý formulář má svá slova. Slova form, forms, report a submit (můžete je změnit) vypíší vaše formuláře jako nabídku, pokud jich je více. Slovo se počítá jen v krátké zprávě: taková, která má méně než 10 dalších slov (Settings, „Ignore the words in long messages“), takže dlouhá zpráva, která jej náhodou obsahuje, nic nespustí.
  • Odkaz nebo QR kód: odkaz, který otevře váš chat WhatsAppu se slovem formuláře, nebo adresa webové stránky.
  • Posláno vámi: „Send form“ v inboxu nebo API pošle formulář na jedno číslo s již vyplněnými hodnotami (číslo zakázky, účet, dokumenty, které chcete).
  • Navazující formulář: automatizace nebo člen týmu si vyžádá více údajů druhým formulářem. Co se vrátí, se připojí k prvnímu podání.
  • Webová stránka a API pro systémy, které už data mají.

Kdo smí odesílat. Kdokoli (obvyklá volba), nebo jen čísla, která vypíšete, nebo kontakty se štítkem, který jste nastavili. Tak formulář zůstane u vaší terénní party. Slovo status odpoví osobě fází jejích nedávných podání.

Fáze

Fáze patří k formuláři. Nový formulář začíná fázemi New, In progress a Done; přejmenujte je, přidejte vlastní (2 až 12) a zvolte barvu. Každá fáze je jednoho ze tří druhů: otevřená, hotová nebo zrušená.

  • Kdo ji smí zvolit: vyhraďte fázi určitým rolím. Agent připravuje, jen manažer schvaluje.
  • Poznámka povinná: při přesunu podání do této fáze požádejte o důvod (zamítnuto, odmítnuto, dotazováno).
  • Zpráva: text odeslaný osobě, když její podání dorazí do fáze, se zástupnými znaky.
  • Tlačítka pro osobu: odpověď může obsahovat až tři tlačítka (Accept, Decline, „Not fixed yet“) a každé z nich přesune fázi. Jen tato jedna věc vám dá přijetí nabídky, potvrzení návštěvy a „je to opravené?“.

Odpověď napsaná mimo dobu odpovídání WhatsAppu se uschová a doručí se, až osoba napíše příště. Inbox to u odpovědi uvede.

Schránka a role

Inbox zobrazuje Open, Mine, Unassigned, Done a All, plus zobrazení, která si uložíte. Hledejte a filtrujte podle formuláře, fáze, přiřazeného člena, štítku, kanálu a data. Tři rozvržení: seznam, tabulka (jeden formulář: každá otázka je sloupec) a nástěnka (jeden formulář: sloupec pro každou fázi). Zaškrtněte několik řádků a změňte jejich fázi, přiřaďte je, označte, exportujte nebo smažte najednou.

Podání ukazuje své odpovědi, své soubory, odkud bylo odesláno, a jednu historii všeho, co se s ním stalo: změny fáze s tím, kdo a proč, poznámky, odpovědi v obou směrech, soubory a každý krok automatizace s jeho výsledkem. Dole píšete buď interní poznámku, nebo odpověď na WhatsAppu. Libovolné zobrazení můžete exportovat jako CSV, Excel nebo JSON a jedno podání jako PDF.

Váš tým. Pozvěte lidi e-mailem jen do inboxu. Dostanou vlastní lehkou aplikaci na adrese /desk a zbytek vašeho účtu nikdy neuvidí. Role je výchozí sada oprávnění a každé oprávnění lze jednotlivému člověku zapnout nebo vypnout.

RoleZačíná s
Owner, AdminVším, včetně formulářů, automatizací, připojení a týmu
ManagerPoznámky, odpovědi, úpravu odpovědí, změnu fáze, přiřazování, soubory, export, mazání, spouštění ručních akcí
AgentPoznámky, odpovědi, úpravu odpovědí, změnu fáze, soubory, spouštění ručních akcí. Může si podání převzít sám
ViewerMůže číst, nic jiného

Můžete také zúžit, co člověk vidí: jen některé formuláře, jen to, co je mu přiřazeno (s nepřiřazenými k převzetí i bez nich), a skryté kontaktní údaje. Každá akce člena týmu se zapíše do historie podání.

Vlastní stránka osoby. Každé podání má soukromou stránku na adrese /s/a-long-code, bez přihlášení: fázi, dosavadní zprávy a změny fází, vaši otevřenou otázku s jejími tlačítky a „Add information“, pokud to formulář dovoluje. Interní poznámky a interní pole se na ní nikdy neobjeví.

Soukromí. Výmaz kontaktu vymaže jeho podání a soubory. Formulář může mít dobu uchování, po jejímž uplynutí se uzavřená podání smažou.

Automatizace

Automatizaci čtete jako větu: když se něco stane, jestliže platí některé věci, proveď tyto věci v pořadí. „Když je odeslána Žádost o nabídku, jestliže je množství 20 nebo více, přiřaď ji manažerům a pošli e-mail majiteli.“

KdyžSpustí se, když
submittedpodání je kompletní a jeho soubory dorazily
status_changedse změnila fáze (volitelně: na určité fáze nebo z nich)
assignedse změnila osoba, které je přiřazeno
updatedse upravily odpovědi nebo interní pole
note_addedčlen týmu napsal poznámku
file_addedbyl později přidán soubor
customer_repliedosoba, která podání odeslala, přidala text nebo soubory
buttonosoba stiskla tlačítko jedné z vašich odpovědí
overdueje stále ve stejné fázi po určitém počtu minut
dueuplynul jeho termín, zatímco bylo otevřené
manualčlen týmu stiskne tlačítko akce u podání

Jestliže: pravidla o odpovědích, vypočítaných hodnotách, fázi, kanálu, štítcích a přiřazené osobě. Pravidlo je pole, operátor a hodnota: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Pravidla spojujte pomocí all (a) nebo any (nebo).

ProveďCo dělá
set_statuspřesune ji do fáze, s poznámkou
assignčlenovi, postupně v rámci role, nejméně zaneprázdněnému z role, nebo nikomu
set_field, calculatezapíše interní pole, nebo jej vypočítá vzorcem
tag, set_priority, set_dueštítky, prioritu, termín
replyzprávu WhatsApp osobě, s až 3 tlačítky, z nichž každé přesune fázi, soubor, nebo odkaz na její stránku stavu
ask_locationpožádat osobu, aby sdílela, kde se nachází
send_formposlat navazující formulář; co se vrátí, připojí se k tomuto podání
emailmajiteli, přiřazené osobě, osobě, nebo libovolné adrese, se soubory v příloze
notifye-mail přiřazené osobě, roli, nebo všem v týmu
http, openapi, mcpzavolat připojení a části odpovědi uložit do polí
waitpokračovat později, jen pokud podmínky stále platí
stopskončit zde

Každé spuštění se zapisuje krok po kroku: co bylo odesláno, co se vrátilo, jak dlouho to trvalo. „Try with a submission“ spustí automatizaci proti skutečnému podání, aniž by cokoli změnila nebo odeslala. Volání vnějšího systému, které selže, se zopakuje po 1 minutě, 10 minutách a 1 hodině; poté je automatizace označena jako neúspěšná a vaše webhooky dostanou submit.automation_failed. Automatizace, které se navzájem spouštějí, se zastaví po třech úrovních.

Recept 1: velké nabídky jdou manažerovi

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

Recept 2: odeslat nabídku, požádat o odpověď, připomenout po třech dnech

quote_amount je interní pole, které váš tým vyplní dříve, než podání přesune do Quoted. Připomínka se odešle jen tehdy, pokud je podání stále ve fázi 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."
    }
  ]
}

Recept 3: odložit odečet měřiče, který vypadá chybně

usage je vypočítaná hodnota: 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."
    }
  ]
}

Připojení

Připojení je vnější systém, který může automatizace volat. Webhooky vašeho účtu žádné nepotřebují: dostávají každou událost podání v okamžiku, kdy nastane (viz události). Pro vše ostatní existují tři druhy. „Test“ u připojení a „Try with a submission“ u akce ukážou skutečný požadavek a skutečnou odpověď, ještě než cokoli zapnete.

HTTP požadavek

Základní adresa a způsob přihlášení (žádný, bearer token, hlavička, uživatelské jméno a heslo, nebo klíč v adrese). Akce uvádí metodu, cestu a tělo JSON. save uloží části odpovědi do polí podání.

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

Dokument OpenAPI

Zadejte adresu dokumentu OpenAPI 3 v JSON, nebo jej vložte. app2email načte jeho operace; akce vybere jednu podle jejího id a vyplní její parametry. Dokumenty YAML a Swagger 2 se nečtou.

{
  "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 server

Zadejte adresu MCP serveru (streamable HTTP) a jeho token. app2email vypíše nástroje serveru; akce vybere jeden a vyplní jeho argumenty. $text uchová celou odpověď nástroje jako text.

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

Dobré vědět. Hodnota, která je přesně jedním zástupným znakem, si zachová svůj typ (číslo zůstane číslem, seznam zůstane seznamem). Tajné údaje se ukládají šifrovaně, nikdy se znovu nezobrazují a API je nikdy nevrací. Adresy musí být https a veřejné: privátní, lokální a interní adresy se odmítnou a přesměrování se nesledují. Volání může trvat 15 sekund a jeho odpověď může mít 256 KB. V save je cesta buď $ (celá odpověď), nebo prostá cesta, například $.data.items[0].id.

Zástupné znaky

Každý text a každý parametr akce může používat zástupné znaky ve složených závorkách. Název, který není znám, zůstane tak, jak jste jej napsali.

Zástupný znakSe změní na
{<field key>}odpověď na tuto otázku (také interní pole, vypočítané hodnoty a hodnoty, které automatizace uložila)
{reference}referenci, například MR-7Q3M2A
{form} {form_key}název formuláře a jeho klíč
{status} {status_name}klíč fáze a její název
{channel}whatsapp, web, api nebo staff
{priority} {tags}prioritu a štítky
{created} {updated} {due}časy
{contact.name} {contact.phone} {contact.email}osobu, která je odeslala
{assignee.name} {assignee.email}člena týmu, kterému je přiřazeno
{link}vlastní stránku stavu osoby
{desk_link}podání ve schránce vašeho týmu
{answers}všechny odpovědi jako řádky „Popisek: hodnota“
{files} {files.<field key>}odkazy na všechny soubory, nebo na soubory jedné otázky; jiný systém je může stáhnout 7 dní
{note}poznámku změny fáze, nebo poznámku, která automatizaci spustila
{button}tlačítko, které osoba stiskla
{business}název vaší firmy
{submission}v těle JSON: celé podání jako objekt
{= formula }vzorec vyhodnocený na místě, například {= round(qty * 1.1, 2) }

Vzorce

Používají se ve vypočítaných hodnotách, v akci calculate a uvnitř {= ... } v libovolném textu. Vzorec pracuje s čísly, texty v jednoduchých uvozovkách a klíči vašich otázek. Může mít 500 znaků. Dělení nulou nebo chybějící číslo dá prázdnou hodnotu místo chyby.

NapíšeteVýznam
+ - * / %aritmetika s čísly a odpověďmi
== != > >= < <=porovnání
and or not ( )logika a závorky
if(condition, a, b)a, když podmínka platí, jinak b
min(a, b, ...) max(a, b, ...)nejmenší, největší
round(x, n) abs(x)zaokrouhlení na n desetinných míst, velikost čísla bez znaménka
num(x) len(x)text jako číslo; délka textu nebo seznamu
coalesce(a, b)a, nebo b, když je a prázdné
lower(x) upper(x) concat(a, b, ...)texty
lookup('list', id, 'column')sloupec řádku z jednoho z vašich seznamů, například cenu
previous('field')poslední odpověď téže osoby na tuto otázku
count_files('field')kolik souborů otázka obsahuje
days_since(date)počet dní od data do dneška

Příklady: qty * lookup('prices', product, 'price') pro okamžitý odhad; reading - previous('reading') pro spotřebu; if(amount > 500, 'manager', 'agent') pro rozhodnutí, kdo schvaluje.

Pro vývojáře a AI agenty

Vše výše je v REST API pod /v1/{number}/submit, kde {number} je vaše číslo WhatsAppu s předvolbou země, pouze číslice. Svůj klíč API posílejte jako Authorization: Bearer YOUR_API_KEY (přijímá se i hlavička X-API-KEY). Klíč potřebuje rozsah submissions:manage; klíče s plným přístupem jej mají, výchozí klíč nikoli. Klíče pro sandbox nemohou zapisovat.

  1. GET /submit/guide: jeden dokument JSON s celou slovní zásobou: typy otázek s jejich volbami a limity, pravidla fází, spouštěče, operátory, akce s jejich parametry, zástupné znaky, funkce vzorců, šablony a propracované příklady.
  2. POST /submit/setup s "dry_run": true: nic se nezapíše; každý problém se vrátí s jeho cestou a větou, jak jej opravit.
  3. POST /submit/setup bez dry_run: seznamy, připojení, formuláře a automatizace se použijí společně. Při jakémkoli problému se nezapíše nic.
  4. POST /submit/forms/{key}/publish, nebo pojmenujte formuláře v "publish" v dokumentu nastavení.
  5. Sdílejte odkazy formuláře (GET /submit/forms/{key} je vrátí), pak čtěte GET /submit/submissions nebo naslouchejte události webhooků.

Úplné volání nastavení

Uložte níže uvedený dokument jako setup.json a odešlete jej. Nahraďte 61400000000 svým číslem. Ověřuje řešení pro odečty měřičů: seznam lokalit, připojení k fakturačnímu systému, jeden formulář se třemi fázemi a vypočtenou spotřebou a dvě automatizace. Odeberte "dry_run": true, aby se použil. Stávající formuláře, seznamy a připojení se stejným klíčem se nahradí; automatizace se páruje podle názvu uvnitř formuláře. "preset": "..." místo částí nainstaluje jednu ze šablon (GET /submit/presets je vypíše).

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

Odpověď skutečného volání (bez 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": []
}

Ostatní cesty

  • Nastavení: GET / PUT /submit/settings.
  • Formuláře: seznam, vytvoření (z definice nebo šablony), čtení, úprava, smazání, zveřejnění, a POST /submit/forms/{key}/send pro odeslání formuláře na číslo s vyplněnými hodnotami.
  • Seznamy: PUT /submit/lists/{key} nahradí řádky seznamu.
  • Podání: seznam (filtr podle formuláře, fáze, přiřazené osoby, štítku, kanálu, kontaktu, textu a dat; updated_after pro synchronizaci; CSV pomocí ?format=csv), vytvoření, čtení podle id nebo reference, úprava (fáze, poznámka, priorita, přiřazená osoba, termín, štítky, odpovědi, interní pole), přidání poznámky, odpověď s tlačítky, přidání souboru, smazání.
  • Automatizace a běhy: seznam, vytvoření, čtení, úprava, smazání, POST /submit/automations/try, a protokol běhů.
  • Připojení: seznam, nastavení, smazání, test, obnovení, a funkce, které může akce volat.
  • Tým a přehled: pozvání, úprava a odebrání členů; počty podle formuláře, fáze, dne a přiřazené osoby.

Události webhooků

Každý webhook vašeho účtu dostane každou událost. Každá nese podání tak, jak je v daném okamžiku; odkazy na soubory v něm fungují 7 dní.

UdálostKdy
submission.createdpodání existuje (jeho soubory ještě mohou přicházet)
submission.files_readyjeho soubory jsou uložené
submission.updatedse změnily odpovědi, interní hodnoty, priorita, štítky nebo termín
submission.status_changedse změnila fáze
submission.assignedse změnila přiřazená osoba
submission.note_addedbyla napsána poznámka
submission.customer_repliedosoba přidala text, soubory nebo navazující odpověď, nebo stiskla tlačítko
submission.deletedsmazáno nebo vymazáno
submit.automation_failedautomatizace se po opakování vzdala

Nástroje MCP

Každá cesta je také nástrojem na hostovaném MCP serveru app2email, takže asistent může celé nastavení provést v konverzaci: 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 a další. Dobrá první zpráva asistentovi: „Přečti si průvodce Submit-Info a pak nastav formulář pro hlášení problémů s fotografiemi a polohou a řekni mým manažerům o naléhavých.“

claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Více o připojování asistentů a nástrojů pro automatizaci: Nástroje pro automatizaci a agenti.

Limity

LimitHodnota
Formuláře na číslo100
Kroky ve formuláři, otázky v kroku12 a 12 (60 otázek ve formuláři, jedna otázka na polohu)
Seznamy50, každý až 1 000 řádků
Automatizace, připojení, členové týmu200, 30, 200
Soubory v jednom podání60
Velikost souboru25 MB z WhatsAppu, 10 MB z webové stránky nebo API
Poznámka nebo odpověď4 000 znaků
Štítky na podání20
Volání vnějších systémů60 za minutu a 2 000 za den na číslo; 15 sekund a 256 KB na volání
Protokol běhůuchováván 30 dní

Zatím nedostupné

  • Přijetí platby u podání (nabídka se přijímá, ale neplatí se).
  • Odeslání formuláře někomu, kdo vám v posledních 24 hodinách nenapsal, jako formuláře WhatsApp: místo toho dostanete jeho osobní webový odkaz, který odešlete libovolnou schválenou šablonou.
  • Podpisy.
  • Opakující se skupiny („přidat další položku“).
  • Přeskok na jiný formulář uprostřed vyplňování.
  • Vyplnění formuláře bez připojení.
  • Jiné jazyky v pevných textech webové stránky (každý text vašeho formuláře píšete sami).
  • Dokumenty OpenAPI ve formátu YAML nebo Swagger 2 a MCP servery, které mluví jen starším přenosem SSE.
  • Čtení hodnot z fotografií.

Vše výše se nastavuje na stránce Submit-Info v dashboardu (/dashboard/app/submit). Dotazy: support@app2email.com.