Die Anleitung zu Submit-Info: ein Formular aus einer Liste von Fragen bauen, es in WhatsApp und auf einer Webseite veröffentlichen, Einsendungen in einem gemeinsamen Posteingang mit Rollen durch Phasen führen, Antworten und Aufrufe an Ihre eigenen Systeme automatisieren und alles über die API oder einen KI-Agenten einrichten.
Sie schreiben ein Formular als einfache Liste von Fragen. app2email macht daraus ein Formular in WhatsApp und eine Webseite mit denselben Schritten. Ein Kunde oder ein Mitglied Ihres eigenen Außendienstes füllt es aus und erhält eine Referenz. Die Antworten und Dateien werden zu einer Einsendung in einem gemeinsamen Posteingang, wo sie durch Ihre Phasen läuft und Ihre Automatisierungen auslöst.
Ein Gedanke
Formular, dann Einsendung, dann Phasen, dann Automatisierungen, dann Verbindungen. Eine Angebotsanfrage, eine Bewerbung, ein Zählerstand, eine Störungsmeldung, ein erledigter Auftrag, ein Lieferbeleg und ein Spesenbeleg sind alle dasselbe mit anderen Fragen und anderen Phasennamen. Jedes gibt es als Vorlage, die Sie installieren und ändern können.
Für eine Nummer, die Submit-Info nie öffnet, ändert sich nichts. Ein Formular, das noch nicht in WhatsApp veröffentlicht ist, funktioniert trotzdem: Sein Wort antwortet mit dem Link der Webseite.
Ein Formular hat 1 bis 12 Schritte, und ein Schritt hat einen Titel und 1 bis 12 Fragen. Es gibt keine Zeichenfläche und nichts zu zeichnen: Dieselbe Liste steuert das Formular in WhatsApp, die Webseite, die Prüfungen der Antworten, die Spalten der Tabellenansicht, die Exporte und die API. Die Vorschau neben dem Editor zeigt das Formular so, wie eine Person es sieht.
| Typ | Was die Person angibt | Was Sie einstellen können |
|---|---|---|
text | Eine kurze Antwort | kürzeste und längste Länge, ein Muster |
textarea | Eine längere Antwort | kürzeste und längste Länge |
number | Eine Zahl | niedrigster und höchster Wert, Dezimalstellen, eine Einheit wie kWh |
email | Eine E-Mail-Adresse | |
phone | Eine Telefonnummer | |
date | Ein Datum | wie viele Tage zurück oder voraus es liegen darf |
select | Eine Auswahl | die Auswahlmöglichkeiten (2 bis 200) oder eine Liste von Ihnen |
multiselect | Mehrere Auswahlen | die Auswahlmöglichkeiten (2 bis 20), wie wenige und wie viele anzukreuzen sind |
yesno | Ja oder Nein | |
rating | Eine Note von 1 bis 3-10 | die höchste Note |
consent | Ein Satz, dem zuzustimmen ist | ob er angekreuzt sein muss |
photo | Ein oder mehrere Fotos | wie viele (1 bis 10); Kamera, Galerie oder beides |
document | Eine oder mehrere Dateien | wie viele (1 bis 10); jede Datei, PDF, Bilder oder Office-Dateien |
location | Wo sich die Person befindet | in WhatsApp die Standortabfrage; im Web eine Schaltfläche und eine Adresszeile |
info | Text, den Sie anzeigen | nichts wird abgefragt oder gespeichert |
hidden | Ein Wert, der mit dem Link kommt | etwa eine Auftragsnummer; nichts wird angezeigt |
{contact.name}.Die Webseite. Dieselben Schritte unter /form/your-code/form-key. Sie fragt zuletzt nach einem Namen und einer WhatsApp-Nummer. Nach dem Senden sieht die Person die Referenz und kann auf „Get updates on WhatsApp“ tippen, was ihre Nummer mit einer Nachricht bestätigt; ein Formular kann so eingestellt werden, dass es das verlangt. Ein persönlicher Link (von Ihnen gesendet) weiß bereits, wer die Person ist. Um das Formular auf Ihrer eigenen Website einzubinden, nutzen Sie den Code-Schnipsel unter Teilen; wenn das Formular nach einem Standort fragt, fügen Sie dem iframe allow="geolocation" hinzu. Fotos werden im Browser verkleinert, bevor sie hochgeladen werden; eine Datei darf bis zu 10 MB groß sein.
Wer senden darf. Jeder (die übliche Wahl) oder nur die Nummern, die Sie auflisten, oder Kontakte mit einem Tag von Ihnen. So bleibt ein Formular bei Ihrem Außendienst. Das Wort status antwortet einer Person mit der Phase ihrer letzten Einsendungen.
Phasen gehören zum Formular. Ein neues Formular beginnt mit New, In progress und Done; benennen Sie sie um, fügen Sie eigene hinzu (2 bis 12) und wählen Sie eine Farbe. Jede Phase ist von einer von drei Arten: offen, erledigt oder storniert.
Eine Antwort, die außerhalb des Antwortzeitraums von WhatsApp geschrieben wird, wird aufbewahrt und zugestellt, wenn die Person das nächste Mal schreibt. Die Inbox sagt das bei der Antwort.
Die Inbox zeigt Offen, Meine, Nicht zugewiesen, Erledigt und Alle sowie die Ansichten, die Sie speichern. Suchen und filtern Sie nach Formular, Phase, Bearbeiter, Tag, Kanal und Datum. Drei Layouts: eine Liste, eine Tabelle (ein Formular: jede Frage ist eine Spalte) und ein Board (ein Formular: eine Spalte pro Phase). Kreuzen Sie mehrere Zeilen an, um Phase, Zuweisung, Tag, Export oder Löschen gemeinsam zu ändern.
Eine Einsendung zeigt ihre Antworten, ihre Dateien, von wo sie gesendet wurde, und einen Verlauf von allem, was mit ihr geschehen ist: Phasenwechsel mit Wer und Warum, Notizen, Antworten in beide Richtungen, Dateien und jeder Schritt einer Automatisierung mit seinem Ergebnis. Unten schreiben Sie entweder eine interne Notiz oder eine WhatsApp-Antwort. Exportieren Sie jede Ansicht als CSV, Excel oder JSON und eine Einsendung als PDF.
Ihr Team. Laden Sie Personen per E-Mail nur in die Inbox ein. Sie erhalten eine eigene schlanke App unter /desk und sehen nie den Rest Ihres Kontos. Eine Rolle ist ein Startsatz von Fähigkeiten, und jede Fähigkeit lässt sich für eine Person ein- oder ausschalten.
| Rolle | Beginnt mit |
|---|---|
| Inhaber, Admin | Allem, einschließlich Formularen, Automatisierungen, Verbindungen und dem Team |
| Manager | Notizen, Antworten, Antworten bearbeiten, Phase ändern, zuweisen, Dateien, Export, Löschen, manuelle Aktionen ausführen |
| Agent | Notizen, Antworten, Antworten bearbeiten, Phase ändern, Dateien, manuelle Aktionen ausführen. Kann eine Einsendung für sich übernehmen |
| Betrachter | Kann lesen, sonst nichts |
Sie können auch einschränken, was eine Person sieht: nur einige Formulare, nur was ihr zugewiesen ist (mit oder ohne nicht zugewiesene zum Übernehmen) und ausgeblendete Kontaktdaten. Jede Aktion eines Teammitglieds wird in den Verlauf der Einsendung geschrieben.
Die eigene Seite der Person. Jede Einsendung hat eine private Seite unter /s/a-long-code, ohne Login: die Phase, die bisherigen Nachrichten und Phasenwechsel, Ihre offene Frage mit ihren Schaltflächen und „Add information“, wenn das Formular es erlaubt. Interne Notizen und interne Felder stehen nie darauf.
Datenschutz. Das Löschen eines Kontakts löscht seine Einsendungen und Dateien. Ein Formular kann eine Aufbewahrungsdauer haben, nach der abgeschlossene Einsendungen gelöscht werden.
Eine Automatisierung liest sich wie ein Satz: Wenn etwas passiert, falls einige Dinge zutreffen, mache diese Dinge der Reihe nach. „Wenn eine Angebotsanfrage eingereicht wird, falls die Menge 20 oder mehr ist, weise sie den Managern zu und schreibe dem Inhaber eine E-Mail.“
| Wenn | Sie läuft, wenn |
|---|---|
submitted | eine Einsendung vollständig ist und ihre Dateien angekommen sind |
status_changed | die Phase gewechselt hat (optional: zu oder von bestimmten Phasen) |
assigned | die Person, der sie zugewiesen ist, gewechselt hat |
updated | Antworten oder interne Felder bearbeitet wurden |
note_added | ein Teammitglied eine Notiz geschrieben hat |
file_added | später eine Datei hinzugefügt wurde |
customer_replied | die Person, die sie gesendet hat, Text oder Dateien hinzugefügt hat |
button | die Person eine Schaltfläche einer Ihrer Antworten gedrückt hat |
overdue | sie nach einer Zahl von Minuten noch in derselben Phase ist |
due | ihre Fälligkeitszeit verstrichen ist, während sie offen war |
manual | ein Teammitglied die Schaltfläche der Aktion an der Einsendung drückt |
Falls: Regeln zu Antworten, berechneten Werten, der Phase, dem Kanal, Tags und dem Bearbeiter. Eine Regel besteht aus einem Feld, einem Operator und einem Wert: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Verbinden Sie Regeln mit all (und) oder any (oder).
| Mache | Was es tut |
|---|---|
set_status | sie in eine Phase verschieben, mit einer Notiz |
assign | an ein Mitglied, reihum über eine Rolle, an den am wenigsten ausgelasteten einer Rolle oder an niemanden |
set_field, calculate | ein internes Feld schreiben oder mit einer Formel berechnen |
tag, set_priority, set_due | Tags, Priorität, eine Fälligkeitszeit |
reply | eine WhatsApp-Nachricht an die Person, mit bis zu 3 Schaltflächen, die jeweils die Phase verschieben, einer Datei oder dem Link zu ihrer Statusseite |
ask_location | die Person bitten, ihren Standort zu teilen |
send_form | ein Folgeformular senden; was zurückkommt, wird an diese Einsendung angehängt |
email | an den Inhaber, den Bearbeiter, die Person oder jede Adresse, mit angehängten Dateien |
notify | eine E-Mail an den Bearbeiter, eine Rolle oder alle im Team |
http, openapi, mcp | eine Verbindung aufrufen und Teile der Antwort in Feldern behalten |
wait | später weitermachen, nur wenn die Bedingungen noch gelten |
stop | hier enden |
Jeder Lauf wird Schritt für Schritt protokolliert: was gesendet wurde, was zurückkam, wie lange es dauerte. „Mit einer Einsendung ausprobieren“ lässt eine Automatisierung gegen eine echte Einsendung laufen, ohne etwas zu ändern oder zu senden. Ein fehlgeschlagener Aufruf an ein externes System wird nach 1 Minute, 10 Minuten und 1 Stunde erneut versucht; danach wird die Automatisierung als fehlgeschlagen markiert, und Ihre Webhooks erhalten submit.automation_failed. Automatisierungen, die sich gegenseitig auslösen, werden nach drei Ebenen gestoppt.
{
"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 ist ein internes Feld, das Ihr Team ausfüllt, bevor es die Einsendung nach Quoted verschiebt. Die Erinnerung geht nur hinaus, wenn die Einsendung noch in Quoted ist.
{
"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 ist ein berechneter Wert: 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."
}
]
}Eine Verbindung ist ein externes System, das eine Automatisierung aufrufen kann. Die Webhooks Ihres Kontos brauchen keine: Sie erhalten jedes Einsendungsereignis, sobald es passiert (siehe die Ereignisse). Für alles andere gibt es drei Arten. „Testen“ an einer Verbindung und „Mit einer Einsendung ausprobieren“ an einer Aktion zeigen die echte Anfrage und die echte Antwort, bevor etwas eingeschaltet wird.
Eine Basisadresse und eine Art der Anmeldung (keine, ein Bearer-Token, ein Header, Benutzername und Passwort oder ein Schlüssel in der Adresse). Die Aktion nennt die Methode, den Pfad und einen JSON-Body. save behält Teile der Antwort in Feldern der Einsendung.
{
"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"
}Geben Sie die Adresse eines OpenAPI-3-Dokuments in JSON an oder fügen Sie es ein. app2email liest seine Operationen; die Aktion wählt eine über ihre ID und füllt ihre Parameter. YAML- und Swagger-2-Dokumente werden nicht gelesen.
{
"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"
}Geben Sie die Adresse eines MCP-Servers (streamable HTTP) und sein Token an. app2email listet die Tools des Servers auf; die Aktion wählt eines und füllt seine Argumente. $text behält die ganze Antwort des Tools als 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"
}Gut zu wissen. Ein Wert, der genau ein Platzhalter ist, behält seinen Typ (eine Zahl bleibt eine Zahl, eine Liste bleibt eine Liste). Geheimnisse werden verschlüsselt gespeichert, nie wieder angezeigt und nie von der API zurückgegeben. Adressen müssen https und öffentlich sein: Private, lokale und interne Adressen werden abgelehnt, und Weiterleitungen werden nicht verfolgt. Ein Aufruf darf 15 Sekunden dauern, und seine Antwort darf 256 KB groß sein. In save ist ein Pfad $ (die ganze Antwort) oder ein einfacher Pfad wie $.data.items[0].id.
Jeder Text und jeder Parameter einer Aktion kann Platzhalter in geschweiften Klammern verwenden. Ein unbekannter Name bleibt so stehen, wie Sie ihn getippt haben.
| Platzhalter | Wird zu |
|---|---|
{<field key>} | der Antwort auf diese Frage (auch interne Felder, berechnete Werte und Werte, die eine Automatisierung gespeichert hat) |
{reference} | der Referenz, zum Beispiel MR-7Q3M2A |
{form} {form_key} | dem Namen des Formulars und seinem Schlüssel |
{status} {status_name} | dem Schlüssel der Phase und ihrem Namen |
{channel} | whatsapp, web, api oder staff |
{priority} {tags} | der Priorität und den Tags |
{created} {updated} {due} | den Zeiten |
{contact.name} {contact.phone} {contact.email} | der Person, die sie gesendet hat |
{assignee.name} {assignee.email} | dem Teammitglied, dem sie zugewiesen ist |
{link} | der eigenen Statusseite der Person |
{desk_link} | der Einsendung in der Inbox Ihres Teams |
{answers} | allen Antworten als Zeilen „Bezeichnung: Wert“ |
{files} {files.<field key>} | Links zu allen Dateien oder zu den Dateien einer Frage; ein anderes System kann sie 7 Tage lang abrufen |
{note} | der Notiz des Phasenwechsels oder der Notiz, die die Automatisierung ausgelöst hat |
{button} | der Schaltfläche, die die Person gedrückt hat |
{business} | Ihrem Unternehmensnamen |
{submission} | in einem JSON-Body: die ganze Einsendung als Objekt |
{= formula } | einer an Ort und Stelle berechneten Formel, zum Beispiel {= round(qty * 1.1, 2) } |
Verwendet von berechneten Werten, von der Aktion calculate und innerhalb von {= ... } in jedem Text. Eine Formel arbeitet mit Zahlen, Texten in einfachen Anführungszeichen und den Schlüsseln Ihrer Fragen. Sie darf 500 Zeichen lang sein. Eine Division durch null oder eine fehlende Zahl ergibt einen leeren Wert statt eines Fehlers.
| Sie schreiben | Bedeutung |
|---|---|
+ - * / % | Rechnen mit Zahlen und Antworten |
== != > >= < <= | Vergleiche |
and or not ( ) | Logik und Klammern |
if(condition, a, b) | a, wenn die Bedingung gilt, sonst b |
min(a, b, ...) max(a, b, ...) | der kleinste, der größte |
round(x, n) abs(x) | Runden auf n Dezimalstellen, der Betrag einer Zahl ohne ihr Vorzeichen |
num(x) len(x) | ein Text als Zahl; die Länge eines Textes oder einer Liste |
coalesce(a, b) | a oder b, wenn a leer ist |
lower(x) upper(x) concat(a, b, ...) | Texte |
lookup('list', id, 'column') | eine Spalte einer Zeile einer Ihrer Listen, zum Beispiel ein Preis |
previous('field') | die letzte Antwort derselben Person auf diese Frage |
count_files('field') | wie viele Dateien eine Frage enthält |
days_since(date) | Tage von einem Datum bis heute |
Beispiele: qty * lookup('prices', product, 'price') für eine Sofortschätzung; reading - previous('reading') für den Verbrauch; if(amount > 500, 'manager', 'agent'), um zu entscheiden, wer genehmigt.
Alles oben Genannte steht in der REST API unter /v1/{number}/submit, wobei {number} Ihre WhatsApp-Nummer mit Landesvorwahl ist, nur Ziffern. Senden Sie Ihren API-Schlüssel als Authorization: Bearer YOUR_API_KEY (der Header X-API-KEY wird ebenfalls akzeptiert). Der Schlüssel braucht den Scope submissions:manage; Schlüssel mit Vollzugriff haben ihn, der Standardschlüssel nicht. Sandbox-Schlüssel können nicht schreiben.
GET /submit/guide: ein JSON-Dokument mit dem gesamten Vokabular: Fragetypen mit ihren Optionen und Limits, Phasenregeln, Auslöser, Operatoren, Aktionen mit ihren Parametern, Platzhalter, Formelfunktionen, die Vorlagen und durchgerechnete Beispiele.POST /submit/setup mit "dry_run": true: Nichts wird geschrieben; jedes Problem kommt mit seinem Pfad und einem Satz zurück, der sagt, wie es zu beheben ist.POST /submit/setup ohne dry_run: Listen, Verbindungen, Formulare und Automatisierungen werden gemeinsam angewendet. Bei einem Problem wird nichts geschrieben.POST /submit/forms/{key}/publish, oder nennen Sie die Formulare in "publish" des Setup-Dokuments.GET /submit/forms/{key} gibt sie zurück), lesen Sie dann GET /submit/submissions oder hören Sie auf die Webhook-Ereignisse.Speichern Sie das folgende Dokument als setup.json und senden Sie es per POST. Ersetzen Sie 61400000000 durch Ihre Nummer. Es prüft eine Zählerstand-Lösung: eine Liste von Standorten, eine Verbindung zu einem Abrechnungssystem, ein Formular mit drei Phasen und einem berechneten Verbrauch sowie zwei Automatisierungen. Entfernen Sie "dry_run": true, um es anzuwenden. Bestehende Formulare, Listen und Verbindungen mit demselben Schlüssel werden ersetzt; Automatisierungen werden innerhalb des Formulars über den Namen zugeordnet. "preset": "..." anstelle der Teile installiert eine der Vorlagen (GET /submit/presets listet sie auf).
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"
]
}Die Antwort des echten Aufrufs (ohne 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, um ein Formular mit ausgefüllten Werten an eine Nummer zu senden.PUT /submit/lists/{key} ersetzt die Zeilen einer Liste.updated_after zum Synchronisieren; CSV mit ?format=csv), erstellen, lesen nach ID oder Referenz, aktualisieren (Phase, Notiz, Priorität, Bearbeiter, Fälligkeitszeit, Tags, Antworten, interne Felder), eine Notiz hinzufügen, mit Schaltflächen antworten, eine Datei hinzufügen, löschen.POST /submit/automations/try und das Laufprotokoll.Jeder Webhook Ihres Kontos erhält jedes Ereignis. Jedes enthält die Einsendung so, wie sie in diesem Moment ist; Dateilinks darin funktionieren 7 Tage.
| Ereignis | Wann |
|---|---|
submission.created | eine Einsendung existiert (ihre Dateien können noch ankommen) |
submission.files_ready | ihre Dateien sind gespeichert |
submission.updated | Antworten, interne Werte, Priorität, Tags oder die Fälligkeitszeit haben sich geändert |
submission.status_changed | die Phase hat gewechselt |
submission.assigned | der Bearbeiter hat gewechselt |
submission.note_added | eine Notiz wurde geschrieben |
submission.customer_replied | die Person hat Text, Dateien oder eine Nachfrage hinzugefügt oder eine Schaltfläche gedrückt |
submission.deleted | gelöscht oder bereinigt |
submit.automation_failed | eine Automatisierung hat nach ihren Wiederholungen aufgegeben |
Jede Route ist auch ein Tool auf dem gehosteten MCP-Server von app2email, sodass ein Assistent das gesamte Setup in einem Gespräch erledigen kann: 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 und mehr. Eine gute erste Nachricht an den Assistenten: „Lies die Submit-Info-Anleitung, richte dann ein Formular für Störungsmeldungen mit Fotos und einem Standort ein und informiere meine Manager über dringende.“
claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Mehr zum Verbinden von Assistenten und Automatisierungstools: Automatisierungstools und Agenten.
| Limit | Wert |
|---|---|
| Formulare pro Nummer | 100 |
| Schritte in einem Formular, Fragen in einem Schritt | 12 und 12 (60 Fragen in einem Formular, eine Standortfrage) |
| Listen | 50, jede mit bis zu 1.000 Zeilen |
| Automatisierungen, Verbindungen, Teammitglieder | 200, 30, 200 |
| Dateien in einer Einsendung | 60 |
| Dateigröße | 25 MB aus WhatsApp, 10 MB von der Webseite oder der API |
| Eine Notiz oder eine Antwort | 4.000 Zeichen |
| Tags an einer Einsendung | 20 |
| Aufrufe an externe Systeme | 60 pro Minute und 2.000 pro Tag und Nummer; 15 Sekunden und 256 KB pro Aufruf |
| Laufprotokoll | 30 Tage aufbewahrt |
Alles oben Genannte wird auf der Seite Submit-Info des Dashboards eingestellt (/dashboard/app/submit). Fragen: support@app2email.com.