app2email API Preise

Dokumentation

Submit-Info

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.

In fünf Minuten starten

  1. Öffnen: Öffnen Sie in Ihrem Dashboard die Seite Submit-Info (/dashboard/app/submit, auch über Integrationen zu öffnen). Schalten Sie sie ein.
  2. Ein Formular erstellen: Wählen Sie „Neues Formular“ und eine Vorlage aus, oder beginnen Sie leer. Geben Sie ihm einen Namen und schreiben Sie Ihre Fragen. Jede Frage ist eine Zeile: ihr Text, ihr Typ und ob sie beantwortet werden muss.
  3. Veröffentlichen: „In WhatsApp veröffentlichen“ lädt das Formular zu WhatsApp hoch und schaltet es live. Die Webseite mit denselben Schritten ist sofort live.
  4. Teilen: Unter Teilen finden Sie das Wort, das das Formular in Ihrem Chat öffnet, einen Link, der Ihren Chat mit diesem eingetippten Wort öffnet, die Adresse der Webseite, einen QR-Code und einen Code-Schnipsel, um das Formular auf Ihrer eigenen Website einzubinden.
  5. Den Posteingang bearbeiten: Neue Einsendungen kommen in der Inbox an. Öffnen Sie eine, ändern Sie ihre Phase, antworten Sie. Laden Sie Ihr Team ein, wenn Sie bereit sind.

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.

Der Formular-Builder

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.

TypWas die Person angibtWas Sie einstellen können
textEine kurze Antwortkürzeste und längste Länge, ein Muster
textareaEine längere Antwortkürzeste und längste Länge
numberEine Zahlniedrigster und höchster Wert, Dezimalstellen, eine Einheit wie kWh
emailEine E-Mail-Adresse
phoneEine Telefonnummer
dateEin Datumwie viele Tage zurück oder voraus es liegen darf
selectEine Auswahldie Auswahlmöglichkeiten (2 bis 200) oder eine Liste von Ihnen
multiselectMehrere Auswahlendie Auswahlmöglichkeiten (2 bis 20), wie wenige und wie viele anzukreuzen sind
yesnoJa oder Nein
ratingEine Note von 1 bis 3-10die höchste Note
consentEin Satz, dem zuzustimmen istob er angekreuzt sein muss
photoEin oder mehrere Fotoswie viele (1 bis 10); Kamera, Galerie oder beides
documentEine oder mehrere Dateienwie viele (1 bis 10); jede Datei, PDF, Bilder oder Office-Dateien
locationWo sich die Person befindetin WhatsApp die Standortabfrage; im Web eine Schaltfläche und eine Adresszeile
infoText, den Sie anzeigennichts wird abgefragt oder gespeichert
hiddenEin Wert, der mit dem Link kommtetwa eine Auftragsnummer; nichts wird angezeigt
  • Hilfetext und Standardwerte: Jede Frage kann einen kurzen Hinweis und einen Standardwert tragen. Ein Standardwert kann nutzen, was Sie bereits wissen, etwa {contact.name}.
  • Nur anzeigen, wenn: Ein Schritt oder eine Frage kann von einer früheren Antwort abhängen („diesen Schritt nur zeigen, wenn Problem Ja ist“). WhatsApp und die Webseite folgen derselben Regel.
  • Interne Felder: Felder, die nie abgefragt werden. Ihr Team oder eine Automatisierung füllt sie: ein Angebotsbetrag, ein Entscheidungsgrund, eine ID, die von einem anderen System zurückkam. Sie erscheinen nur in der Inbox und in Exporten.
  • Listen: Eine Auswahlfrage kann ihre Möglichkeiten aus einer Liste von Ihnen nehmen (Standorte, Aufträge, Produkte mit Preisen). Ändern Sie die Liste im Dashboard oder über die API, und das Formular folgt, ohne dass Sie erneut veröffentlichen müssen.
  • Berechnete Werte: eine Formel über die Antworten, für eine Sofortschätzung oder eine Prüfung. Siehe Formeln.
  • Nach dem Senden: ein Prüfbildschirm vor dem Senden, die Antwort mit der Referenz, eine Schaltfläche „Add more“, die die nächsten Nachrichten (Text, Fotos, Dateien) zehn Minuten lang an die Einsendung anhängt, und der Link zur eigenen Statusseite der Person.
  • Veröffentlichen: app2email schreibt das WhatsApp-Formular für Sie, teilt einen langen Schritt auf mehrere Bildschirme auf, wenn die Limits von WhatsApp es verlangen, und behält die letzten fünf veröffentlichten Versionen, damit eine ältere Nachricht noch das Formular öffnet, mit dem sie gesendet wurde.

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.

Wie Personen zu einem Formular kommen

  • Ein Wort: Jedes Formular hat seine eigenen Wörter. Die Wörter form, forms, report und submit (Sie können sie ändern) listen Ihre Formulare als Menü auf, wenn es mehrere gibt. Ein Wort zählt nur in einer kurzen Nachricht: einer mit weniger als 10 anderen Wörtern (Einstellungen, „Wörter in langen Nachrichten ignorieren“), sodass eine lange Nachricht, die es zufällig enthält, nichts startet.
  • Ein Link oder ein QR-Code: ein Link, der Ihren WhatsApp-Chat mit dem Wort des Formulars öffnet, oder die Adresse der Webseite.
  • Von Ihnen gesendet: „Formular senden“ in der Inbox oder die API sendet ein Formular an eine Nummer, mit bereits ausgefüllten Werten (eine Auftragsnummer, ein Konto, die Dokumente, die Sie möchten).
  • Eine Nachfrage: Eine Automatisierung oder ein Teammitglied fragt mit einem zweiten Formular nach mehr. Was zurückkommt, wird an die erste Einsendung angehängt.
  • Die Webseite und die API für Systeme, die die Daten bereits halten.

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

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.

  • Wer sie wählen darf: Behalten Sie eine Phase bestimmten Rollen vor. Ein Agent bereitet vor, nur ein Manager genehmigt.
  • Notiz erforderlich: Fragen Sie nach einem Grund, wenn eine Einsendung dorthin verschoben wird (abgelehnt, zurückgewiesen, rückgefragt).
  • Nachricht: ein Text, der an die Person gesendet wird, wenn ihre Einsendung die Phase erreicht, mit Platzhaltern.
  • Schaltflächen für die Person: Eine Antwort kann bis zu drei Schaltflächen tragen (Accept, Decline, „Not fixed yet“), und jede verschiebt die Phase. Dieses eine Stück liefert Ihnen die Annahme eines Angebots, die Bestätigung eines Besuchs und „ist es behoben?“.

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 und Rollen

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.

RolleBeginnt mit
Inhaber, AdminAllem, einschließlich Formularen, Automatisierungen, Verbindungen und dem Team
ManagerNotizen, Antworten, Antworten bearbeiten, Phase ändern, zuweisen, Dateien, Export, Löschen, manuelle Aktionen ausführen
AgentNotizen, Antworten, Antworten bearbeiten, Phase ändern, Dateien, manuelle Aktionen ausführen. Kann eine Einsendung für sich übernehmen
BetrachterKann 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.

Automatisierungen

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.“

WennSie läuft, wenn
submittedeine Einsendung vollständig ist und ihre Dateien angekommen sind
status_changeddie Phase gewechselt hat (optional: zu oder von bestimmten Phasen)
assigneddie Person, der sie zugewiesen ist, gewechselt hat
updatedAntworten oder interne Felder bearbeitet wurden
note_addedein Teammitglied eine Notiz geschrieben hat
file_addedspäter eine Datei hinzugefügt wurde
customer_replieddie Person, die sie gesendet hat, Text oder Dateien hinzugefügt hat
buttondie Person eine Schaltfläche einer Ihrer Antworten gedrückt hat
overduesie nach einer Zahl von Minuten noch in derselben Phase ist
dueihre Fälligkeitszeit verstrichen ist, während sie offen war
manualein 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).

MacheWas es tut
set_statussie in eine Phase verschieben, mit einer Notiz
assignan ein Mitglied, reihum über eine Rolle, an den am wenigsten ausgelasteten einer Rolle oder an niemanden
set_field, calculateein internes Feld schreiben oder mit einer Formel berechnen
tag, set_priority, set_dueTags, Priorität, eine Fälligkeitszeit
replyeine 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_locationdie Person bitten, ihren Standort zu teilen
send_formein Folgeformular senden; was zurückkommt, wird an diese Einsendung angehängt
emailan den Inhaber, den Bearbeiter, die Person oder jede Adresse, mit angehängten Dateien
notifyeine E-Mail an den Bearbeiter, eine Rolle oder alle im Team
http, openapi, mcpeine Verbindung aufrufen und Teile der Antwort in Feldern behalten
waitspäter weitermachen, nur wenn die Bedingungen noch gelten
stophier 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.

Beispiel 1: große Angebote gehen an einen Manager

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

Beispiel 2: das Angebot senden, um eine Antwort bitten, nach drei Tagen erinnern

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

Beispiel 3: einen Zählerstand beiseitelegen, der falsch aussieht

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

Verbindungen

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.

HTTP-Anfrage

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

OpenAPI-Dokument

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

MCP-Server

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.

Platzhalter

Jeder Text und jeder Parameter einer Aktion kann Platzhalter in geschweiften Klammern verwenden. Ein unbekannter Name bleibt so stehen, wie Sie ihn getippt haben.

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

Formeln

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 schreibenBedeutung
+ - * / %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.

Für Entwickler und KI-Agenten

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.

  1. 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.
  2. 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.
  3. POST /submit/setup ohne dry_run: Listen, Verbindungen, Formulare und Automatisierungen werden gemeinsam angewendet. Bei einem Problem wird nichts geschrieben.
  4. POST /submit/forms/{key}/publish, oder nennen Sie die Formulare in "publish" des Setup-Dokuments.
  5. Teilen Sie die Links des Formulars (GET /submit/forms/{key} gibt sie zurück), lesen Sie dann GET /submit/submissions oder hören Sie auf die Webhook-Ereignisse.

Ein vollständiger Setup-Aufruf

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

Die anderen Routen

  • Einstellungen: GET / PUT /submit/settings.
  • Formulare: auflisten, erstellen (aus einer Definition oder einer Vorlage), lesen, aktualisieren, löschen, veröffentlichen, und POST /submit/forms/{key}/send, um ein Formular mit ausgefüllten Werten an eine Nummer zu senden.
  • Listen: PUT /submit/lists/{key} ersetzt die Zeilen einer Liste.
  • Einsendungen: auflisten (filtern nach Formular, Phase, Bearbeiter, Tag, Kanal, Kontakt, Text und Daten; 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.
  • Automatisierungen und Läufe: auflisten, erstellen, lesen, aktualisieren, löschen, POST /submit/automations/try und das Laufprotokoll.
  • Verbindungen: auflisten, setzen, löschen, testen, aktualisieren und die Funktionen, die eine Aktion aufrufen kann.
  • Team und Bericht: Mitglieder einladen, aktualisieren und entfernen; Zählungen nach Formular, Phase, Tag und Bearbeiter.

Webhook-Ereignisse

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.

EreignisWann
submission.createdeine Einsendung existiert (ihre Dateien können noch ankommen)
submission.files_readyihre Dateien sind gespeichert
submission.updatedAntworten, interne Werte, Priorität, Tags oder die Fälligkeitszeit haben sich geändert
submission.status_changeddie Phase hat gewechselt
submission.assignedder Bearbeiter hat gewechselt
submission.note_addedeine Notiz wurde geschrieben
submission.customer_replieddie Person hat Text, Dateien oder eine Nachfrage hinzugefügt oder eine Schaltfläche gedrückt
submission.deletedgelöscht oder bereinigt
submit.automation_failedeine Automatisierung hat nach ihren Wiederholungen aufgegeben

MCP-Tools

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.

Limits

LimitWert
Formulare pro Nummer100
Schritte in einem Formular, Fragen in einem Schritt12 und 12 (60 Fragen in einem Formular, eine Standortfrage)
Listen50, jede mit bis zu 1.000 Zeilen
Automatisierungen, Verbindungen, Teammitglieder200, 30, 200
Dateien in einer Einsendung60
Dateigröße25 MB aus WhatsApp, 10 MB von der Webseite oder der API
Eine Notiz oder eine Antwort4.000 Zeichen
Tags an einer Einsendung20
Aufrufe an externe Systeme60 pro Minute und 2.000 pro Tag und Nummer; 15 Sekunden und 256 KB pro Aufruf
Laufprotokoll30 Tage aufbewahrt

Noch nicht verfügbar

  • Eine Zahlung für eine Einsendung annehmen (ein Angebot wird angenommen, nicht bezahlt).
  • Ein Formular als WhatsApp-Formular an jemanden senden, der Ihnen in den letzten 24 Stunden nicht geschrieben hat: Sie erhalten stattdessen seinen persönlichen Weblink, den Sie mit einer beliebigen genehmigten Vorlage senden.
  • Unterschriften.
  • Wiederholte Gruppen („weiteren Eintrag hinzufügen“).
  • Auf halbem Weg zu einem anderen Formular springen.
  • Ein Formular ohne Verbindung ausfüllen.
  • Andere Sprachen in den festen Texten der Webseite (jeden Text Ihres Formulars schreiben Sie selbst).
  • OpenAPI-Dokumente in YAML oder Swagger 2 und MCP-Server, die nur den älteren SSE-Transport sprechen.
  • Werte aus Fotos auslesen.

Alles oben Genannte wird auf der Seite Submit-Info des Dashboards eingestellt (/dashboard/app/submit). Fragen: support@app2email.com.