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ć.
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.
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.
| Rodzaj | Co podaje osoba | Co możesz ustawić |
|---|---|---|
text | Krótką odpowiedź | najkrótszą i najdłuższą długość, wzorzec |
textarea | Dłuższą odpowiedź | najkrótszą i najdłuższą długość |
number | Liczbę | najniższą i najwyższą wartość, miejsca po przecinku, jednostkę, np. kWh |
email | Adres e-mail | |
phone | Numer telefonu | |
date | Datę | ile dni wstecz lub w przód może być |
select | Jeden wybór | wybory (2 do 200) albo listę Twoją |
multiselect | Kilka wyborów | wybory (2 do 20), najmniej i najwięcej do zaznaczenia |
yesno | Tak lub Nie | |
rating | Ocenę od 1 do 3–10 | najwyższą ocenę |
consent | Zdanie do zaakceptowania | czy musi być zaznaczone |
photo | Jedno lub więcej zdjęć | ile (1 do 10); aparat, galeria lub jedno z nich |
document | Jeden lub więcej plików | ile (1 do 10); dowolny plik, PDF, obrazy lub pliki biurowe |
location | Miejsce, w którym jest osoba | na WhatsApp prośbę o lokalizację; na stronie przycisk i wiersz adresu |
info | Tekst do pokazania | nic nie jest pytane ani zapisywane |
hidden | Wartość, która przychodzi z linkiem | np. numer zlecenia; nic nie jest pokazywane |
{contact.name}.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.
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 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.
Odpowiedź napisana poza czasem odpowiedzi WhatsApp jest zachowywana i dostarczana, gdy osoba napisze ponownie. Skrzynka mówi o tym przy odpowiedzi.
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.
| Rola | Zaczyna z |
|---|---|
| Właściciel, Administrator | Wszystko, w tym formularze, automatyzacje, połączenia i zespół |
| Kierownik | Notatki, odpowiedzi, edycję odpowiedzi, zmianę etapu, przypisywanie, pliki, eksport, usuwanie, ręczne akcje |
| Agent | Notatki, odpowiedzi, edycję odpowiedzi, zmianę etapu, pliki, ręczne akcje. Może wziąć zgłoszenie dla siebie |
| Przeglądający | Moż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.
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.”
| Kiedy | Uruchamia się, gdy |
|---|---|
submitted | zgłoszenie jest kompletne i jego pliki dotarły |
status_changed | zmienił się etap (opcjonalnie: na określone etapy lub z nich) |
assigned | zmieniła się osoba, do której zgłoszenie jest przypisane |
updated | edytowano odpowiedzi lub pola wewnętrzne |
note_added | członek zespołu napisał notatkę |
file_added | później dodano plik |
customer_replied | osoba, która je wysłała, dodała tekst lub pliki |
button | osoba nacisnęła przycisk jednej z Twoich odpowiedzi |
overdue | zgłoszenie nadal jest na tym samym etapie po określonej liczbie minut |
due | minął jego termin, a zgłoszenie było otwarte |
manual | czł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ób | Co robi |
|---|---|
set_status | przenosi na etap, z notatką |
assign | do członka zespołu, po kolei w roli, do osoby z najmniejszym obciążeniem w roli, albo do nikogo |
set_field, calculate | zapisuje pole wewnętrzne albo wylicza je wzorem |
tag, set_priority, set_due | tagi, priorytet, termin |
reply | wiadomość WhatsApp do osoby, z do trzech przycisków, które każdy przesuwa etap, plikiem lub linkiem do jej strony statusu |
ask_location | prosi osobę o udostępnienie, gdzie się znajduje |
send_form | wysyła formularz kontynuacji; to, co wróci, jest dołączane do tego zgłoszenia |
email | do właściciela, przypisanej osoby, samej osoby albo dowolnego adresu, z załączonymi plikami |
notify | e-mail do przypisanej osoby, roli albo wszystkich w zespole |
http, openapi, mcp | wywołuje połączenie i zachowuje części odpowiedzi w polach |
wait | kontynuuje później, tylko jeśli warunki nadal są spełnione |
stop | koń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.
{
"name": "Large quotes go to a manager",
"form": "quote_request",
"enabled": true,
"trigger": "submitted",
"options": {},
"conditions": {
"all": [
{
"field": "quantity",
"gte": 20
}
]
},
"actions": [
{
"type": "assign",
"to": "role:manager"
},
{
"type": "set_priority",
"priority": "high"
},
{
"type": "email",
"to": [
"owner"
],
"subject": "Large quote {reference}",
"body": "{contact.name} asked for a quote.\n\n{answers}\n\n{desk_link}",
"attach_files": true
}
]
}quote_amount 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."
}
]
}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łą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.
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"
}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"
}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.
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ępczy | Zamienia 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) } |
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.
| Piszesz | Znaczy |
|---|---|
+ - * / % | 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.
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ć.
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.POST /submit/setup z "dry_run": true: nic nie jest zapisywane; każdy problem wraca z jego ścieżką i zdaniem, jak go naprawić.POST /submit/setup bez dry_run: listy, połączenia, formularze i automatyzacje są stosowane razem. Przy jakimkolwiek problemie nic nie jest zapisywane.POST /submit/forms/{key}/publish albo wskaż formularze w "publish" dokumentu konfiguracji.GET /submit/forms/{key} je zwraca), a potem czytaj GET /submit/submissions albo nasłuchuj zdarzeń webhooka.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": []
}GET / PUT /submit/settings.POST /submit/forms/{key}/send, aby wysłać formularz na numer z już wypełnionymi wartościami.PUT /submit/lists/{key} zastępuje wiersze listy.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.POST /submit/automations/try i dziennik uruchomień.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.
| Zdarzenie | Kiedy |
|---|---|
submission.created | zgłoszenie istnieje (jego pliki mogą jeszcze docierać) |
submission.files_ready | jego pliki są zapisane |
submission.updated | zmieniły się odpowiedzi, wartości wewnętrzne, priorytet, tagi lub termin |
submission.status_changed | zmienił się etap |
submission.assigned | zmieniła się osoba przypisana |
submission.note_added | napisano notatkę |
submission.customer_replied | osoba dodała tekst, pliki lub kontynuację albo nacisnęła przycisk |
submission.deleted | usunięto lub skasowano |
submit.automation_failed | automatyzacja zrezygnowała po ponowieniach |
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.
| Limit | Wartość |
|---|---|
| Formularze na numer | 100 |
| Kroki w formularzu, pytania w kroku | 12 i 12 (60 pytań w formularzu, jedno pytanie o lokalizację) |
| Listy | 50, każda do 1000 wierszy |
| Automatyzacje, połączenia, członkowie zespołu | 200, 30, 200 |
| Pliki w jednym zgłoszeniu | 60 |
| Rozmiar pliku | 25 MB z WhatsApp, 10 MB ze strony www lub z API |
| Notatka lub odpowiedź | 4000 znaków |
| Tagi na zgłoszeniu | 20 |
| Wywołania zewnętrznych systemów | 60 na minutę i 2000 dziennie na numer; 15 sekund i 256 KB na wywołanie |
| Dziennik uruchomień | przechowywany przez 30 dni |
Wszystko powyżej ustawiasz na stronie Submit-Info w panelu (/dashboard/app/submit). Pytania: support@app2email.com.