app2email API Cennik

Dokumentacja

Submit-Info

Przewodnik po Submit-Info: zbuduj formularz z listy pytań, opublikuj go w WhatsApp i na stronie www, obsługuj zgłoszenia przez etapy we wspólnej skrzynce z rolami, automatyzuj odpowiedzi i wywołania własnych systemów oraz konfiguruj wszystko przez API lub agenta AI.

Formularz piszesz jako zwykłą listę pytań. app2email zamienia go w formularz w WhatsApp i w stronę www z tymi samymi krokami. Klient albo członek Twojego zespołu terenowego wypełnia go i dostaje numer referencyjny. Odpowiedzi i pliki stają się zgłoszeniem we wspólnej skrzynce, w której przechodzi ono przez Twoje etapy i uruchamia automatyzacje.

Prośba o wycenę, wniosek, odczyt licznika, zgłoszenie problemu, zakończona praca, potwierdzenie dostawy i paragon z wydatku to wszystko ta sama rzecz z innymi pytaniami i innymi nazwami etapów. Każdy przypadek jest dostępny jako szablon, który możesz zainstalować i zmienić.

Jedna zasada

Formularz, potem zgłoszenie, potem etapy, potem automatyzacje, potem połączenia. Prośba o wycenę, wniosek, odczyt licznika, zgłoszenie problemu, zakończona praca, potwierdzenie dostawy i paragon z wydatku to wszystko ta sama rzecz z innymi pytaniami i innymi nazwami etapów. Każdy przypadek jest dostępny jako szablon, który możesz zainstalować i zmienić.

Start w pięć minut

  1. Otwórz: w panelu otwórz stronę Submit-Info (/dashboard/app/submit, otwierana też z Integracji). Włącz ją.
  2. Zrób formularz: wybierz „Nowy formularz” i wskaż szablon albo zacznij od pustego. Nadaj nazwę i napisz pytania. Każde pytanie to jeden wiersz: jego treść, rodzaj i to, czy trzeba na nie odpowiedzieć.
  3. Opublikuj: „Opublikuj w WhatsApp” wgrywa formularz do WhatsApp i uruchamia go. Strona www z tymi samymi krokami działa od razu.
  4. Udostępnij: w sekcji Udostępnianie znajdziesz słowo, które otwiera formularz na czacie, link otwierający czat z tym słowem już wpisanym, adres strony www, kod QR oraz fragment kodu do umieszczenia formularza na Twojej stronie.
  5. Obsługuj skrzynkę: nowe zgłoszenia trafiają do Skrzynki. Otwórz zgłoszenie, zmień jego etap, odpowiedz. Zaproś zespół, kiedy będziesz gotowy.

Niczego się nie zmienia dla numeru, który nigdy nie otwiera Submit-Info. Formularz, który nie jest jeszcze opublikowany w WhatsApp, nadal działa: jego słowo odpowiada linkiem do strony www.

Kreator formularzy

Formularz ma od 1 do 12 kroków, a krok ma tytuł i od 1 do 12 pytań. Nie ma tu płótna ani niczego do rysowania: ta sama lista steruje formularzem w WhatsApp, stroną www, sprawdzaniem odpowiedzi, kolumnami widoku tabeli, eksportami i API. Podgląd obok edytora pokazuje formularz tak, jak widzi go osoba.

RodzajCo podaje osobaCo możesz ustawić
textKrótką odpowiedźnajkrótszą i najdłuższą długość, wzorzec
textareaDłuższą odpowiedźnajkrótszą i najdłuższą długość
numberLiczbęnajniższą i najwyższą wartość, miejsca po przecinku, jednostkę, np. kWh
emailAdres e-mail
phoneNumer telefonu
dateDatęile dni wstecz lub w przód może być
selectJeden wybórwybory (2 do 200) albo listę Twoją
multiselectKilka wyborówwybory (2 do 20), najmniej i najwięcej do zaznaczenia
yesnoTak lub Nie
ratingOcenę od 1 do 3–10najwyższą ocenę
consentZdanie do zaakceptowaniaczy musi być zaznaczone
photoJedno lub więcej zdjęćile (1 do 10); aparat, galeria lub jedno z nich
documentJeden lub więcej plikówile (1 do 10); dowolny plik, PDF, obrazy lub pliki biurowe
locationMiejsce, w którym jest osobana WhatsApp prośbę o lokalizację; na stronie przycisk i wiersz adresu
infoTekst do pokazanianic nie jest pytane ani zapisywane
hiddenWartość, która przychodzi z linkiemnp. numer zlecenia; nic nie jest pokazywane
  • Tekst pomocy i wartości domyślne: każde pytanie może mieć krótką podpowiedź i wartość domyślną. Wartość domyślna może korzystać z tego, co już wiesz, np. {contact.name}.
  • Pokaż tylko wtedy, gdy: krok lub pytanie może zależeć od wcześniejszej odpowiedzi („pokaż ten krok tylko wtedy, gdy Problem to Tak”). WhatsApp i strona www stosują tę samą regułę.
  • Pola wewnętrzne: pola, o które się nigdy nie pyta. Wypełnia je Twój zespół albo automatyzacja: kwotę wyceny, powód decyzji, identyfikator, który wrócił z innego systemu. Pojawiają się tylko w skrzynce i w eksportach.
  • Listy: pytanie o wybór może brać wybory z Twojej listy (miejsca, zlecenia, produkty z cenami). Zmień listę w panelu albo przez API, a formularz za nią podąży, bez potrzeby ponownej publikacji.
  • Wartości wyliczane: wzór na podstawie odpowiedzi, np. do natychmiastowej wyceny albo sprawdzenia. Zobacz wzory.
  • Po wysłaniu: ekran przeglądu przed wysłaniem, odpowiedź z numerem referencyjnym, przycisk „Dodaj więcej”, który przez dziesięć minut dołącza kolejne wiadomości (tekst, zdjęcia, pliki) do zgłoszenia, oraz link do osobistej strony statusu danej osoby.
  • Publikacja: app2email przygotowuje formularz w WhatsApp, dzieli długi krok na kilka ekranów, gdy wymagają tego limity WhatsApp, i zachowuje ostatnie pięć opublikowanych wersji, tak aby starsza wiadomość nadal otwierała formularz, z którym została wysłana.

Strona www. Te same kroki pod adresem /form/your-code/form-key. Na końcu pyta o imię i numer WhatsApp. Po wysłaniu osoba widzi numer referencyjny i może nacisnąć „Otrzymuj aktualizacje w WhatsApp”, co potwierdza jej numer jedną wiadomością; formularz można ustawić tak, by to wymagał. Osobisty link (wysłany przez Ciebie) już wie, kim jest osoba. Aby umieścić formularz na swojej stronie, użyj fragmentu pod Udostępnianiem; jeśli formularz pyta o lokalizację, dodaj allow="geolocation" do iframe. Zdjęcia są pomniejszane w przeglądarce, zanim zostaną wysłane; plik może mieć do 10 MB.

Jak ludzie trafiają do formularza

  • Słowo: każdy formularz ma własne słowa. Słowa form, forms, report i submit (możesz je zmienić) wyświetlają listę Twoich formularzy, gdy jest ich kilka. Słowo liczy się tylko w krótkiej wiadomości: takiej z mniej niż 10 innymi słowami (Ustawienia, „Ignoruj słowa w długich wiadomościach”), więc długa wiadomość, która przypadkiem zawiera to słowo, niczego nie uruchamia.
  • Link lub kod QR: link, który otwiera Twój czat WhatsApp z słowem formularza, albo adres strony www.
  • Wysłany przez Ciebie: „Wyślij formularz” w skrzynce albo przez API wysyła formularz na jeden numer, z już wypełnionymi wartościami (numerem zlecenia, kontem, dokumentami, które chcesz).
  • Kontynuacja: automatyzacja albo członek zespołu prosi o więcej przez drugi formularz. To, co wróci, jest dołączane do pierwszego zgłoszenia.
  • Strona www, oraz API dla systemów, które już mają te dane.

Kto może wysyłać. Każdy (zwykle wybierany wariant), albo tylko numery, które wskażesz, lub kontakty z Twoim tagiem. Dzięki temu formularz zostaje przy Twoim personelu terenowym. Słowo status odpowiada osobie etapem jej ostatnich zgłoszeń.

Etapy

Etapy należą do formularza. Nowy formularz zaczyna od etapów Nowe, W toku i Zakończone; możesz je zmienić nazwy, dodać własne (2 do 12) i wybrać kolor. Każdy etap jest jednego z trzech rodzajów: otwarty, zakończony lub anulowany.

  • Kto może go wybrać: zachowaj etap dla określonych ról. Agent przygotowuje, tylko Kierownik zatwierdza.
  • Wymagana notatka: poproś o powód, gdy zgłoszenie jest przenoszone na etap (odrzucone, odmowa, pytanie).
  • Wiadomość: tekst wysyłany do osoby, gdy jej zgłoszenie trafia na etap, z symbolami zastępczymi.
  • Przyciski dla osoby: odpowiedź może mieć do trzech przycisków (Akceptuj, Odrzuć, „Jeszcze nie naprawione”), a każdy przesuwa etap. Ta jedna rzecz daje akceptację wyceny, potwierdzenie wizyty i pytanie „czy jest naprawione?”.

Odpowiedź napisana poza czasem odpowiedzi WhatsApp jest zachowywana i dostarczana, gdy osoba napisze ponownie. Skrzynka mówi o tym przy odpowiedzi.

Skrzynka i role

Skrzynka pokazuje widoki Otwarte, Moje, Nieprzypisane, Zakończone i Wszystkie, a także widoki, które zapiszesz. Szukaj i filtruj według formularza, etapu, osoby przypisanej, tagu, kanału i daty. Trzy układy: lista, tabela (jeden formularz: każde pytanie jest kolumną) i tablica (jeden formularz: kolumna dla każdego etapu). Zaznacz kilka wierszy, aby razem zmienić etap, przypisać, otagować, wyeksportować lub usunąć.

Zgłoszenie pokazuje swoje odpowiedzi, pliki, skąd zostało wysłane, oraz jedną historię wszystkiego, co się z nim działo: zmiany etapów z tym, kto je zrobił i dlaczego, notatki, odpowiedzi w obu kierunkach, pliki i każdy krok automatyzacji z jego wynikiem. Na dole piszesz albo notatkę wewnętrzną, albo odpowiedź WhatsApp. Każdy widok możesz wyeksportować jako CSV, Excel lub JSON, a pojedyncze zgłoszenie jako PDF.

Twój zespół. Zaproś osoby e-mailem tylko do skrzynki. Dostają lekką aplikację we własnym zakresie, pod adresem /desk, i nigdy nie widzą reszty Twojego konta. Rola to początkowy zestaw uprawnień, a każde uprawnienie można włączyć lub wyłączyć dla jednej osoby.

RolaZaczyna z
Właściciel, AdministratorWszystko, w tym formularze, automatyzacje, połączenia i zespół
KierownikNotatki, odpowiedzi, edycję odpowiedzi, zmianę etapu, przypisywanie, pliki, eksport, usuwanie, ręczne akcje
AgentNotatki, odpowiedzi, edycję odpowiedzi, zmianę etapu, pliki, ręczne akcje. Może wziąć zgłoszenie dla siebie
PrzeglądającyMoże czytać, nic więcej

Możesz też zawęzić to, co widzi dana osoba: tylko niektóre formularze, tylko to, co jest jej przypisane (z nieprzypisanymi lub bez nich, do wzięcia), oraz ukryte dane kontaktowe. Każde działanie członka zespołu jest zapisywane w historii zgłoszenia.

Osobista strona osoby. Każde zgłoszenie ma prywatną stronę pod adresem /s/a-long-code, bez logowania: etap, wiadomości i zmiany etapów do tej pory, Twoje otwarte pytanie z przyciskami oraz „Dodaj informacje”, gdy formularz na to pozwala. Notatki wewnętrzne i pola wewnętrzne nigdy się tam nie pojawiają.

Prywatność. Usunięcie kontaktu usuwa jego zgłoszenia i pliki. Formularz może mieć czas przechowywania, po którym zamknięte zgłoszenia są usuwane.

Automatyzacje

Automatyzację czyta się jak zdanie: kiedy coś się stanie, jeśli coś jest prawdą, zrób te rzeczy po kolei. „Gdy zostanie wysłana Prośba o wycenę, jeśli ilość wynosi 20 lub więcej, przypisz ją Kierownikom i wyślij e-mail do właściciela.”

KiedyUruchamia się, gdy
submittedzgłoszenie jest kompletne i jego pliki dotarły
status_changedzmienił się etap (opcjonalnie: na określone etapy lub z nich)
assignedzmieniła się osoba, do której zgłoszenie jest przypisane
updatededytowano odpowiedzi lub pola wewnętrzne
note_addedczłonek zespołu napisał notatkę
file_addedpóźniej dodano plik
customer_repliedosoba, która je wysłała, dodała tekst lub pliki
buttonosoba nacisnęła przycisk jednej z Twoich odpowiedzi
overduezgłoszenie nadal jest na tym samym etapie po określonej liczbie minut
dueminął jego termin, a zgłoszenie było otwarte
manualczłonek zespołu naciska przycisk akcji na zgłoszeniu

Jeśli: reguły dotyczące odpowiedzi, wartości wyliczanych, etapu, kanału, tagów i osoby przypisanej. Reguła to pole, operator i wartość: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Reguły łączy się przez all (i) lub any (lub).

ZróbCo robi
set_statusprzenosi na etap, z notatką
assigndo członka zespołu, po kolei w roli, do osoby z najmniejszym obciążeniem w roli, albo do nikogo
set_field, calculatezapisuje pole wewnętrzne albo wylicza je wzorem
tag, set_priority, set_duetagi, priorytet, termin
replywiadomość WhatsApp do osoby, z do trzech przycisków, które każdy przesuwa etap, plikiem lub linkiem do jej strony statusu
ask_locationprosi osobę o udostępnienie, gdzie się znajduje
send_formwysyła formularz kontynuacji; to, co wróci, jest dołączane do tego zgłoszenia
emaildo właściciela, przypisanej osoby, samej osoby albo dowolnego adresu, z załączonymi plikami
notifye-mail do przypisanej osoby, roli albo wszystkich w zespole
http, openapi, mcpwywołuje połączenie i zachowuje części odpowiedzi w polach
waitkontynuuje później, tylko jeśli warunki nadal są spełnione
stopkończy tutaj

Każde uruchomienie jest zapisywane krok po kroku: co wysłano, co wróciło, ile to trwało. „Wypróbuj na zgłoszeniu” uruchamia automatyzację na prawdziwym zgłoszeniu bez zmieniania lub wysyłania czegokolwiek. Wywołanie zewnętrznego systemu, które się nie powiedzie, jest ponawiane po 1 minucie, 10 minutach i 1 godzinie; potem automatyzacja jest oznaczona jako nieudana, a Twoje webhooki otrzymują submit.automation_failed. Automatyzacje, które wzajemnie się uruchamiają, są zatrzymywane po trzech poziomach.

Przepis 1: duże wyceny idą do kierownika

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

Przepis 2: wyślij wycenę, poproś o odpowiedź, przypomnij po trzech dniach

quote_amount to pole wewnętrzne, które Twój zespół wypełnia, zanim przeniesie zgłoszenie na Wyceniono. Przypomnienie wychodzi tylko wtedy, gdy zgłoszenie nadal jest na etapie Wyceniono.

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

Przepis 3: odłóż na bok odczyt licznika, który wygląda źle

usage to wartość wyliczana: 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."
    }
  ]
}

Połączenia

Połączenie to zewnętrzny system, który automatyzacja może wywołać. Twoje webhooki nie potrzebują żadnego: dostają każde zdarzenie zgłoszenia w chwili, gdy zajdzie (zobacz zdarzenia). Dla wszystkiego innego są trzy rodzaje. „Testuj” przy połączeniu i „Wypróbuj na zgłoszeniu” przy akcji pokazują prawdziwe żądanie i prawdziwą odpowiedź, zanim cokolwiek zostanie włączone.

Żądanie HTTP

Adres bazowy i sposób logowania (brak, token na okaziciela, nagłówek, nazwa użytkownika i hasło albo klucz w adresie). Akcja podaje metodę, ścieżkę i ciało JSON. save zachowuje części odpowiedzi w polach zgłoszenia.

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

Podaj adres dokumentu OpenAPI 3 w JSON albo wklej go. app2email odczytuje jego operacje; akcja wybiera jedną po jej identyfikatorze i wypełnia jej parametry. Dokumentów w YAML i Swagger 2 nie da się odczytać.

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

Serwer MCP

Podaj adres serwera MCP (streamable HTTP) i jego token. app2email wyświetla listę narzędzi serwera; akcja wybiera jedno i wypełnia jego argumenty. $text zachowuje całą odpowiedź narzędzia jako tekst.

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

Dobrze wiedzieć. Wartość, która jest dokładnie jednym symbolem zastępczym, zachowuje swój typ (liczba zostaje liczbą, lista zostaje listą). Sekrety są przechowywane zaszyfrowane, nigdy nie są pokazywane ponownie i nie są zwracane przez API. Adresy muszą być https i publiczne: adresy prywatne, lokalne i wewnętrzne są odrzucane, a przekierowania nie są śledzone. Wywołanie może trwać 15 sekund, a odpowiedź może mieć 256 KB. W save ścieżka to $ (cała odpowiedź) albo zwykła ścieżka, np. $.data.items[0].id.

Symbole zastępcze

Każdy tekst i każdy parametr akcji może używać symboli zastępczych w nawiasach klamrowych. Nieznana nazwa zostaje taka, jak ją wpisałeś.

Symbol zastępczyZamienia się na
{<field key>}odpowiedź na to pytanie (także pola wewnętrzne, wartości wyliczane i wartości zapisane przez automatyzację)
{reference}numer referencyjny, np. MR-7Q3M2A
{form} {form_key}nazwa formularza i jego klucz
{status} {status_name}klucz etapu i jego nazwa
{channel}whatsapp, web, api lub staff
{priority} {tags}priorytet i tagi
{created} {updated} {due}czasy
{contact.name} {contact.phone} {contact.email}osoba, która wysłała zgłoszenie
{assignee.name} {assignee.email}członek zespołu, do którego zgłoszenie jest przypisane
{link}osobista strona statusu danej osoby
{desk_link}zgłoszenie w skrzynce Twojego zespołu
{answers}wszystkie odpowiedzi jako wiersze „Etykieta: wartość”
{files} {files.<field key>}linki do wszystkich plików albo do plików jednego pytania; inny system może je pobrać przez 7 dni
{note}notatka zmiany etapu albo notatka, która uruchomiła automatyzację
{button}przycisk, który nacisnęła osoba
{business}nazwa Twojej firmy
{submission}w ciele JSON: całe zgłoszenie jako obiekt
{= formula }wzór wyliczony w miejscu, np. {= round(qty * 1.1, 2) }

Wzory

Używane przez wartości wyliczane, przez akcję calculate i wewnątrz {= ... } w dowolnym tekście. Wzór działa na liczbach, tekstach w pojedynczych cudzysłowach i kluczach Twoich pytań. Może mieć 500 znaków. Dzielenie przez zero albo brakująca liczba daje pustą wartość zamiast błędu.

PiszeszZnaczy
+ - * / %działania na liczbach i odpowiedziach
== != > >= < <=porównania
and or not ( )logika i nawiasy
if(condition, a, b)a, gdy warunek jest spełniony, w przeciwnym razie b
min(a, b, ...) max(a, b, ...)najmniejsze, największe
round(x, n) abs(x)zaokrąglenie do n miejsc po przecinku, wartość liczby bez znaku
num(x) len(x)tekst jako liczba; długość tekstu lub listy
coalesce(a, b)a, a gdy a jest puste, to b
lower(x) upper(x) concat(a, b, ...)teksty
lookup('list', id, 'column')kolumna wiersza z Twojej listy, np. cena
previous('field')ostatnia odpowiedź tej samej osoby na to pytanie
count_files('field')ile plików ma pytanie
days_since(date)dni od daty do dzisiaj

Przykłady: qty * lookup('prices', product, 'price') do natychmiastowej wyceny; reading - previous('reading') do zużycia; if(amount > 500, 'manager', 'agent'), aby zdecydować, kto zatwierdza.

Dla programistów i agentów AI

Wszystko powyżej jest w REST API pod /v1/{number}/submit, gdzie {number} to Twój numer WhatsApp z kodem kraju, tylko cyframi. Wyślij klucz API jako Authorization: Bearer YOUR_API_KEY (akceptowany jest też nagłówek X-API-KEY). Klucz potrzebuje zakresu submissions:manage; klucze z pełnym dostępem go mają, klucz Default nie. Klucze sandbox nie mogą zapisywać.

  1. GET /submit/guide: jeden dokument JSON z całym słownictwem: rodzaje pytań z opcjami i limitami, zasady etapów, wyzwalacze, operatory, akcje z ich parametrami, symbole zastępcze, funkcje wzorów, szablony i przykłady.
  2. POST /submit/setup z "dry_run": true: nic nie jest zapisywane; każdy problem wraca z jego ścieżką i zdaniem, jak go naprawić.
  3. POST /submit/setup bez dry_run: listy, połączenia, formularze i automatyzacje są stosowane razem. Przy jakimkolwiek problemie nic nie jest zapisywane.
  4. POST /submit/forms/{key}/publish albo wskaż formularze w "publish" dokumentu konfiguracji.
  5. Udostępnij linki formularza (GET /submit/forms/{key} je zwraca), a potem czytaj GET /submit/submissions albo nasłuchuj zdarzeń webhooka.

Pełne wywołanie konfiguracji

Zapisz poniższy dokument jako setup.json i wyślij go. Zamień 61400000000 na swój numer. Konfiguruje rozwiązanie do odczytów liczników: listę miejsc, połączenie z systemem rozliczeń, jeden formularz z trzema etapami i wyliczanym zużyciem oraz dwie automatyzacje. Usuń "dry_run": true, aby zastosować. Istniejące formularze, listy i połączenia z tym samym kluczem są zastępowane; automatyzacje są dopasowywane po nazwie w obrębie formularza. "preset": "..." zamiast części instaluje jeden z szablonów (GET /submit/presets wyświetla je).

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

Odpowiedź prawdziwego wywołania (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": []
}

Pozostałe ścieżki

  • Ustawienia: GET / PUT /submit/settings.
  • Formularze: lista, utworzenie (z definicji albo z szablonu), odczyt, aktualizacja, usunięcie, publikacja oraz POST /submit/forms/{key}/send, aby wysłać formularz na numer z już wypełnionymi wartościami.
  • Listy: PUT /submit/lists/{key} zastępuje wiersze listy.
  • Zgłoszenia: lista (filtrowanie według formularza, etapu, osoby przypisanej, tagu, kanału, kontaktu, tekstu i dat; updated_after do synchronizacji; CSV przez ?format=csv), utworzenie, odczyt po id lub numerze referencyjnym, aktualizacja (etap, notatka, priorytet, osoba przypisana, termin, tagi, odpowiedzi, pola wewnętrzne), dodanie notatki, odpowiedź z przyciskami, dodanie pliku, usunięcie.
  • Automatyzacje i uruchomienia: lista, utworzenie, odczyt, aktualizacja, usunięcie, POST /submit/automations/try i dziennik uruchomień.
  • Połączenia: lista, zapis, usunięcie, test, odświeżenie oraz funkcje, które może wywołać akcja.
  • Zespół i raport: zaproszenie, aktualizacja i usunięcie członków; liczby według formularza, etapu, dnia i osoby przypisanej.

Zdarzenia webhooka

Każdy webhook Twojego konta dostaje każde zdarzenie. Każde zawiera zgłoszenie takie, jakie jest w tym momencie; linki do plików w nim działają przez 7 dni.

ZdarzenieKiedy
submission.createdzgłoszenie istnieje (jego pliki mogą jeszcze docierać)
submission.files_readyjego pliki są zapisane
submission.updatedzmieniły się odpowiedzi, wartości wewnętrzne, priorytet, tagi lub termin
submission.status_changedzmienił się etap
submission.assignedzmieniła się osoba przypisana
submission.note_addednapisano notatkę
submission.customer_repliedosoba dodała tekst, pliki lub kontynuację albo nacisnęła przycisk
submission.deletedusunięto lub skasowano
submit.automation_failedautomatyzacja zrezygnowała po ponowieniach

Narzędzia MCP

Każda ścieżka jest też narzędziem na hostowanym serwerze MCP app2email, więc asystent może wykonać całą konfigurację w rozmowie: 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 i więcej. Dobra pierwsza wiadomość do asystenta: „Przeczytaj przewodnik Submit-Info, a potem zrób formularz zgłoszenia problemu ze zdjęciami i lokalizacją i powiadom moich kierowników o pilnych sprawach.”

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

Więcej o podłączaniu asystentów i narzędzi automatyzacji: Narzędzia automatyzacji i agenci.

Limity

LimitWartość
Formularze na numer100
Kroki w formularzu, pytania w kroku12 i 12 (60 pytań w formularzu, jedno pytanie o lokalizację)
Listy50, każda do 1000 wierszy
Automatyzacje, połączenia, członkowie zespołu200, 30, 200
Pliki w jednym zgłoszeniu60
Rozmiar pliku25 MB z WhatsApp, 10 MB ze strony www lub z API
Notatka lub odpowiedź4000 znaków
Tagi na zgłoszeniu20
Wywołania zewnętrznych systemów60 na minutę i 2000 dziennie na numer; 15 sekund i 256 KB na wywołanie
Dziennik uruchomieńprzechowywany przez 30 dni

Jeszcze niedostępne

  • Przyjmowanie płatności przy zgłoszeniu (wycenę się akceptuje, nie płaci).
  • Wysyłanie formularza do osoby, która nie pisała do Ciebie w ciągu ostatnich 24 godzin, jako formularz WhatsApp: zamiast tego dostaje jej osobisty link na stronę www, który wysyłasz dowolnym zatwierdzonym szablonem.
  • Podpisy.
  • Powtarzalne grupy („dodaj kolejną pozycję”).
  • Przeskok do innego formularza w połowie.
  • Wypełnianie formularza bez połączenia.
  • Inne języki w stałych tekstach strony www (każdy tekst Twojego formularza piszesz sam).
  • Dokumenty OpenAPI w YAML lub Swagger 2 oraz serwery MCP obsługujące tylko starszy transport SSE.
  • Odczytywanie wartości ze zdjęć.

Wszystko powyżej ustawiasz na stronie Submit-Info w panelu (/dashboard/app/submit). Pytania: support@app2email.com.