app2email API Prezzi

Documentazione

Submit-Info

La guida a Submit-Info: creare un modulo da un elenco di domande, pubblicarlo su WhatsApp e su una pagina web, gestire gli invii attraverso fasi in una inbox condivisa con ruoli, automatizzare risposte e chiamate ai propri sistemi, e configurare tutto tramite l'API o un agente AI.

Scrive un modulo come un semplice elenco di domande. app2email lo trasforma in un modulo dentro WhatsApp e in una pagina web con gli stessi passaggi. Un cliente, o un membro del suo personale sul campo, lo compila e riceve un riferimento. Le risposte e i file diventano un invio in una inbox condivisa, dove avanza attraverso le sue fasi e fa partire le sue automazioni.

Un'idea

Modulo, poi invio, poi fasi, poi automazioni, poi connessioni. Una richiesta di preventivo, una candidatura, una lettura del contatore, una segnalazione di problema, un lavoro completato, una prova di consegna e una ricevuta di spesa sono tutte la stessa cosa, con domande diverse e nomi di fase diversi. Ognuna è disponibile come template che può installare e modificare.

Iniziare in cinque minuti

  1. Lo apra: nella dashboard apra la pagina Submit-Info (/dashboard/app/submit, che si apre anche da Integrations). La attivi.
  2. Crei un modulo: scelga "New form" e selezioni un template, oppure parta da zero. Gli dia un nome e scriva le sue domande. Ogni domanda è una riga: il suo testo, il suo tipo e se è obbligatoria.
  3. Pubblichi: "Publish to WhatsApp" carica il modulo su WhatsApp e lo mette online. La pagina web con gli stessi passaggi è online subito.
  4. Condivida: sotto Share trova la parola che apre il modulo nella sua chat, un link che apre la sua chat con quella parola già scritta, l'indirizzo della pagina web, un codice QR e uno snippet per mettere il modulo sul suo sito.
  5. Lavori nella inbox: i nuovi invii arrivano nella Inbox. Ne apra uno, cambi la sua fase, risponda. Inviti il suo team quando è pronto.

Per un numero che non apre mai Submit-Info non cambia nulla. Un modulo non ancora pubblicato su WhatsApp funziona comunque: la sua parola risponde con il link della pagina web.

Il costruttore di moduli

Un modulo ha da 1 a 12 passaggi, e un passaggio ha un titolo e da 1 a 12 domande. Non c'è alcuna tela e non c'è nulla da disegnare: lo stesso elenco comanda il modulo su WhatsApp, la pagina web, i controlli sulle risposte, le colonne della vista a tabella, le esportazioni e l'API. L'anteprima accanto all'editor mostra il modulo come lo vede una persona.

TipoCosa dà la personaCosa può impostare
textUna risposta brevelunghezza minima e massima, un pattern
textareaUna risposta più lungalunghezza minima e massima
numberUn numerovalore minimo e massimo, decimali, un'unità come kWh
emailUn indirizzo e-mail
phoneUn numero di telefono
dateUna datadi quanti giorni può essere nel passato o nel futuro
selectUna sceltale scelte (da 2 a 200), oppure un suo elenco
multiselectPiù sceltele scelte (da 2 a 20), il minimo e il massimo da selezionare
yesnoSì o No
ratingUn voto da 1 fino a 3-10il voto massimo
consentUna frase da accettarese deve essere selezionata
photoUna o più fotoquante (da 1 a 10); fotocamera, galleria o entrambe
documentUno o più filequanti (da 1 a 10); qualsiasi file, PDF, immagini o file di Office
locationDove si trova la personasu WhatsApp la richiesta di posizione; sul web un pulsante e una riga di indirizzo
infoTesto che mostranon viene chiesto né memorizzato nulla
hiddenUn valore che arriva con il linkcome un numero di lavoro; non viene mostrato nulla
  • Testo di aiuto e valori predefiniti: ogni domanda può avere un breve suggerimento e un valore predefinito. Un valore predefinito può usare ciò che già sa, come {contact.name}.
  • Mostra solo quando: un passaggio o una domanda può dipendere da una risposta precedente ("mostra questo passaggio solo quando Problema è Sì"). WhatsApp e la pagina web seguono la stessa regola.
  • Campi interni: campi che non vengono mai chiesti. Li compilano il suo team o un'automazione: l'importo di un preventivo, il motivo di una decisione, un id tornato da un altro sistema. Compaiono solo nella inbox e nelle esportazioni.
  • Elenchi: una domanda a scelta può prendere le sue scelte da un suo elenco (sedi, lavori, prodotti con prezzi). Modifichi l'elenco nella dashboard o tramite l'API e il modulo lo segue, senza bisogno di pubblicare di nuovo.
  • Valori calcolati: una formula sulle risposte, per una stima immediata o un controllo. Vedere le formule.
  • Dopo l'invio: una schermata di riepilogo prima dell'invio, la risposta con il riferimento, un pulsante "Add more" che allega all'invio i messaggi successivi (testo, foto, file) per dieci minuti, e il link alla pagina di stato della persona.
  • Pubblicazione: app2email scrive il modulo WhatsApp per Lei, divide un passaggio lungo su più schermate quando i limiti di WhatsApp lo richiedono e conserva le ultime cinque versioni pubblicate, così un messaggio più vecchio apre ancora il modulo con cui è stato inviato.

La pagina web. Gli stessi passaggi su /form/your-code/form-key. Chiede per ultimi un nome e un numero WhatsApp. Dopo l'invio, la persona vede il riferimento e può toccare "Get updates on WhatsApp", che conferma il suo numero con un messaggio; un modulo può essere impostato per richiederlo. Un link personale (inviato da Lei) sa già chi è la persona. Per mettere il modulo sul suo sito, usi lo snippet sotto Share; se il modulo chiede una posizione, aggiunga allow="geolocation" all'iframe. Le foto vengono ridotte nel browser prima del caricamento; un file può arrivare a 10 MB.

Come le persone raggiungono un modulo

  • Una parola: ogni modulo ha le sue parole. Le parole form, forms, report e submit (può cambiarle) elencano i suoi moduli come un menu quando ce n'è più d'uno. Una parola conta solo in un messaggio breve: uno con meno di 10 altre parole (Settings, "Ignore the words in long messages"), quindi un messaggio lungo che per caso la contiene non avvia nulla.
  • Un link o un codice QR: un link che apre la sua chat WhatsApp con la parola del modulo, oppure l'indirizzo della pagina web.
  • Inviato da Lei: "Send form" nella inbox, o l'API, invia un modulo a un numero, con valori già compilati (un numero di lavoro, un conto, i documenti che desidera).
  • Un follow-up: un'automazione o un membro del team chiede altro con un secondo modulo. Ciò che torna viene allegato al primo invio.
  • La pagina web, e l'API per i sistemi che già contengono i dati.

Chi può inviare. Chiunque (la scelta abituale), oppure solo i numeri che elenca o i contatti con un suo tag. È così che un modulo resta riservato al suo personale sul campo. La parola status risponde a una persona con la fase dei suoi invii recenti.

Fasi

Le fasi appartengono al modulo. Un nuovo modulo parte con New, In progress e Done; le rinomini, ne aggiunga di sue (da 2 a 12) e scelga un colore. Ogni fase è di uno di tre tipi: aperta, completata o annullata.

  • Chi può sceglierla: riservi una fase a certi ruoli. Un Agent prepara, solo un Manager approva.
  • Nota obbligatoria: chieda un motivo quando un invio viene spostato lì (rifiutato, respinto, in verifica).
  • Messaggio: un testo inviato alla persona quando il suo invio arriva alla fase, con segnaposto.
  • Pulsanti per la persona: una risposta può avere fino a tre pulsanti (Accept, Decline, "Not fixed yet") e ciascuno sposta la fase. Questo solo elemento Le dà l'accettazione del preventivo, la conferma di una visita e "è stato riparato?".

Una risposta scritta fuori dal tempo di risposta di WhatsApp viene conservata e consegnata quando la persona scrive di nuovo. La inbox lo indica sulla risposta.

La inbox e i ruoli

La Inbox mostra Open, Mine, Unassigned, Done e All, più le viste che salva. Cerchi e filtri per modulo, fase, assegnatario, tag, canale e data. Tre layout: un elenco, una tabella (un modulo: ogni domanda è una colonna) e una bacheca (un modulo: una colonna per ogni fase). Selezioni più righe per cambiare la fase, assegnare, aggiungere tag, esportare o eliminare insieme.

Un invio mostra le sue risposte, i suoi file, da dove è stato inviato e un'unica cronologia di tutto ciò che gli è successo: cambi di fase con chi e perché, note, risposte in entrambe le direzioni, file e ogni passaggio di automazione con il suo risultato. In fondo scrive una nota interna oppure una risposta WhatsApp. Esporti qualsiasi vista come CSV, Excel o JSON, e un singolo invio come PDF.

Il suo team. Inviti le persone via e-mail solo alla inbox. Ricevono una semplice app tutta loro su /desk e non vedono mai il resto del suo account. Un ruolo è un insieme iniziale di permessi, e ogni permesso può essere attivato o disattivato per una singola persona.

RuoloParte con
Owner, AdminTutto, compresi moduli, automazioni, connessioni e team
ManagerNote, risposte, modifica delle risposte, cambio della fase, assegnazione, file, esportazione, eliminazione, esecuzione di azioni manuali
AgentNote, risposte, modifica delle risposte, cambio della fase, file, esecuzione di azioni manuali. Può prendere in carico un invio
ViewerPuò leggere, nient'altro

Può anche restringere ciò che una persona vede: solo alcuni moduli, solo ciò che le è assegnato (con o senza quelli non assegnati da prendere in carico) e i dati di contatto nascosti. Ogni azione di un membro del team viene scritta nella cronologia dell'invio.

La pagina della persona. Ogni invio ha una pagina privata su /s/a-long-code, senza login: la fase, i messaggi e i cambi di fase finora, la sua domanda aperta con i suoi pulsanti e "Add information" quando il modulo lo consente. Le note interne e i campi interni non ci sono mai.

Privacy. Cancellare un contatto cancella i suoi invii e i suoi file. Un modulo può avere un periodo di conservazione, trascorso il quale gli invii chiusi vengono cancellati.

Automazioni

Un'automazione si legge come una frase: quando succede qualcosa, se certe cose sono vere, fai queste cose in ordine. "Quando viene inviata una Quote request, se la quantità è 20 o più, assegnala ai Manager e invia un'e-mail al titolare."

QuandoSi esegue quando
submittedun invio è completo e i suoi file sono arrivati
status_changedla fase è cambiata (facoltativamente: verso o da certe fasi)
assignedla persona a cui è assegnato è cambiata
updatedle risposte o i campi interni sono stati modificati
note_addedun membro del team ha scritto una nota
file_addedun file è stato aggiunto in seguito
customer_repliedla persona che l'ha inviato ha aggiunto testo o file
buttonla persona ha premuto un pulsante di una delle sue risposte
overdueè ancora nella stessa fase dopo un certo numero di minuti
duela sua scadenza è passata mentre era aperto
manualun membro del team preme il pulsante dell'azione sull'invio

Se: regole su risposte, valori calcolati, fase, canale, tag e assegnatario. Una regola è un campo, un operatore e un valore: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Unisca le regole con all (e) o any (o).

FaiCosa fa
set_statuslo sposta in una fase, con una nota
assigna un membro, a turno tra un ruolo, al meno occupato di un ruolo, o a nessuno
set_field, calculatescrive un campo interno, oppure lo calcola con una formula
tag, set_priority, set_duetag, priorità, una scadenza
replyun messaggio WhatsApp alla persona, con fino a 3 pulsanti che spostano ciascuno la fase, un file, o il link alla sua pagina di stato
ask_locationchiede alla persona di condividere dove si trova
send_forminvia un modulo di follow-up; ciò che torna viene allegato a questo invio
emailal titolare, all'assegnatario, alla persona o a qualsiasi indirizzo, con i file allegati
notifyun'e-mail all'assegnatario, a un ruolo o a tutti nel team
http, openapi, mcpchiama una connessione e conserva parti della risposta nei campi
waitprosegue più tardi, solo se le condizioni valgono ancora
stoptermina qui

Ogni esecuzione viene registrata passo per passo: cosa è stato inviato, cosa è tornato, quanto ci ha messo. "Try with a submission" esegue un'automazione su un invio reale senza modificare né inviare nulla. Una chiamata a un sistema esterno che fallisce viene ritentata dopo 1 minuto, 10 minuti e 1 ora; dopo di che l'automazione viene contrassegnata come fallita e i suoi webhook ricevono submit.automation_failed. Le automazioni che si attivano a vicenda si fermano dopo tre livelli.

Ricetta 1: i preventivi grandi vanno a un 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
    }
  ]
}

Ricetta 2: invia il preventivo, chiedi una risposta, ricorda dopo tre giorni

quote_amount è un campo interno che il suo team compila prima di spostare l'invio in Quoted. Il promemoria parte solo se l'invio è ancora in Quoted.

{
  "name": "Send the quote and ask for an answer",
  "form": "quote_request",
  "enabled": true,
  "trigger": "status_changed",
  "options": {
    "to": [
      "quoted"
    ],
    "from": []
  },
  "conditions": {
    "field": "status",
    "equals": "quoted"
  },
  "actions": [
    {
      "type": "reply",
      "text": "Your quote {reference}: {quote_amount}. Would you like to go ahead?",
      "link": true,
      "buttons": [
        {
          "id": "accept",
          "title": "Accept",
          "set_status": "accepted"
        },
        {
          "id": "decline",
          "title": "Decline",
          "set_status": "declined"
        }
      ]
    },
    {
      "type": "wait",
      "minutes": 4320
    },
    {
      "type": "reply",
      "text": "A reminder about your quote {reference}. Tap Accept or Decline, or write to us with any question."
    }
  ]
}

Ricetta 3: metti da parte una lettura del contatore che sembra sbagliata

usage è un valore calcolato: 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."
    }
  ]
}

Connessioni

Una connessione è un sistema esterno che un'automazione può chiamare. I webhook del suo account non ne richiedono nessuna: ricevono ogni evento degli invii mentre accade (vedere gli eventi). Per tutto il resto ci sono tre tipi. "Test" su una connessione e "Try with a submission" su un'azione mostrano la richiesta reale e la risposta reale prima che venga attivato qualcosa.

Richiesta HTTP

Un indirizzo di base e un modo di accedere (nessuno, un bearer token, un header, nome utente e password, o una chiave nell'indirizzo). L'azione indica il metodo, il percorso e un body JSON. save conserva parti della risposta nei campi dell'invio.

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

Documento OpenAPI

Indichi l'indirizzo di un documento OpenAPI 3 in JSON, oppure lo incolli. app2email ne legge le operazioni; l'azione ne sceglie una dal suo id e ne compila i parametri. I documenti YAML e Swagger 2 non vengono letti.

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

Server MCP

Indichi l'indirizzo di un server MCP (HTTP streamable) e il suo token. app2email elenca gli strumenti del server; l'azione ne sceglie uno e ne compila gli argomenti. $text conserva l'intera risposta dello strumento come testo.

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

Da sapere. Un valore che è esattamente un segnaposto mantiene il suo tipo (un numero resta un numero, un elenco resta un elenco). I segreti vengono memorizzati cifrati, non vengono mai mostrati di nuovo e non vengono mai restituiti dall'API. Gli indirizzi devono essere https e pubblici: gli indirizzi privati, locali e interni vengono rifiutati e i reindirizzamenti non vengono seguiti. Una chiamata può durare 15 secondi e la sua risposta può arrivare a 256 KB. In save, un percorso è $ (l'intera risposta) oppure un percorso semplice come $.data.items[0].id.

Segnaposto

Ogni testo e ogni parametro di un'azione può usare segnaposto tra parentesi graffe. Un nome non riconosciuto resta come l'ha scritto.

SegnapostoDiventa
{<field key>}la risposta a quella domanda (anche i campi interni, i valori calcolati e i valori salvati da un'automazione)
{reference}il riferimento, per esempio MR-7Q3M2A
{form} {form_key}il nome del modulo e la sua chiave
{status} {status_name}la chiave della fase e il suo nome
{channel}whatsapp, web, api o staff
{priority} {tags}la priorità e i tag
{created} {updated} {due}gli orari
{contact.name} {contact.phone} {contact.email}la persona che l'ha inviato
{assignee.name} {assignee.email}il membro del team a cui è assegnato
{link}la pagina di stato della persona
{desk_link}l'invio nella inbox del suo team
{answers}tutte le risposte come righe "Etichetta: valore"
{files} {files.<field key>}link a tutti i file, o ai file di una domanda; un altro sistema può recuperarli per 7 giorni
{note}la nota del cambio di fase, o la nota che ha fatto partire l'automazione
{button}il pulsante premuto dalla persona
{business}il nome della sua attività
{submission}in un body JSON: l'intero invio come oggetto
{= formula }una formula calcolata sul posto, per esempio {= round(qty * 1.1, 2) }

Formule

Usate dai valori calcolati, dall'azione calculate e dentro {= ... } in qualsiasi testo. Una formula funziona con numeri, testi tra apici singoli e le chiavi delle sue domande. Può essere lunga 500 caratteri. Una divisione per zero, o un numero mancante, dà un valore vuoto invece di un errore.

ScriveSignificato
+ - * / %aritmetica su numeri e risposte
== != > >= < <=confronti
and or not ( )logica e parentesi
if(condition, a, b)a quando la condizione vale, altrimenti b
min(a, b, ...) max(a, b, ...)il più piccolo, il più grande
round(x, n) abs(x)arrotondamento a n decimali, il valore di un numero senza il segno
num(x) len(x)un testo come numero; la lunghezza di un testo o di un elenco
coalesce(a, b)a, oppure b quando a è vuoto
lower(x) upper(x) concat(a, b, ...)testi
lookup('list', id, 'column')una colonna di una riga di uno dei suoi elenchi, per esempio un prezzo
previous('field')l'ultima risposta della stessa persona a quella domanda
count_files('field')quanti file contiene una domanda
days_since(date)i giorni da una data a oggi

Esempi: qty * lookup('prices', product, 'price') per una stima immediata; reading - previous('reading') per il consumo; if(amount > 500, 'manager', 'agent') per decidere chi approva.

Per sviluppatori e agenti AI

Tutto ciò che precede è nell'API REST sotto /v1/{number}/submit, dove {number} è il suo numero WhatsApp con il prefisso internazionale, solo cifre. Invii la sua chiave API come Authorization: Bearer YOUR_API_KEY (anche l'header X-API-KEY è accettato). La chiave richiede lo scope submissions:manage; le chiavi con accesso completo lo hanno, la chiave Default no. Le chiavi sandbox non possono scrivere.

  1. GET /submit/guide: un unico documento JSON con tutto il vocabolario: tipi di domanda con le loro opzioni e i loro limiti, regole delle fasi, trigger, operatori, azioni con i loro parametri, segnaposto, funzioni delle formule, i template ed esempi svolti.
  2. POST /submit/setup con "dry_run": true: non viene scritto nulla; ogni problema torna con il suo percorso e una frase che dice come risolverlo.
  3. POST /submit/setup senza dry_run: elenchi, connessioni, moduli e automazioni vengono applicati insieme. Con un qualsiasi problema non viene scritto nulla.
  4. POST /submit/forms/{key}/publish, oppure indichi i moduli in "publish" del documento di configurazione.
  5. Condivida i link del modulo (GET /submit/forms/{key} li restituisce), poi legga GET /submit/submissions oppure ascolti gli eventi webhook.

Una chiamata di configurazione completa

Salvi il documento qui sotto come setup.json e lo invii. Sostituisca 61400000000 con il suo numero. Controlla una soluzione per la lettura dei contatori: un elenco di sedi, una connessione a un sistema di fatturazione, un modulo con tre fasi e un consumo calcolato, e due automazioni. Tolga "dry_run": true per applicarlo. I moduli, gli elenchi e le connessioni esistenti con la stessa chiave vengono sostituiti; le automazioni vengono abbinate per nome all'interno del modulo. "preset": "..." al posto delle parti installa uno dei template (GET /submit/presets li elenca).

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

La risposta della chiamata reale (senza 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": []
}

Le altre rotte

  • Impostazioni: GET / PUT /submit/settings.
  • Moduli: elencare, creare (da una definizione o da un template), leggere, aggiornare, eliminare, pubblicare, e POST /submit/forms/{key}/send per inviare un modulo a un numero con valori compilati.
  • Elenchi: PUT /submit/lists/{key} sostituisce le righe di un elenco.
  • Invii: elencare (filtrare per modulo, fase, assegnatario, tag, canale, contatto, testo e date; updated_after per la sincronizzazione; CSV con ?format=csv), creare, leggere per id o riferimento, aggiornare (fase, nota, priorità, assegnatario, scadenza, tag, risposte, campi interni), aggiungere una nota, rispondere con pulsanti, aggiungere un file, eliminare.
  • Automazioni ed esecuzioni: elencare, creare, leggere, aggiornare, eliminare, POST /submit/automations/try e il registro delle esecuzioni.
  • Connessioni: elencare, impostare, eliminare, testare, aggiornare e le funzioni che un'azione può chiamare.
  • Team e report: invitare, aggiornare e rimuovere membri; conteggi per modulo, fase, giorno e assegnatario.

Eventi webhook

Ogni webhook del suo account riceve ogni evento. Ognuno contiene l'invio com'è in quel momento; i link ai file al suo interno funzionano per 7 giorni.

EventoQuando
submission.createdesiste un invio (i suoi file potrebbero ancora arrivare)
submission.files_readyi suoi file sono memorizzati
submission.updatedsono cambiati le risposte, i valori interni, la priorità, i tag o la scadenza
submission.status_changedla fase è cambiata
submission.assignedl'assegnatario è cambiato
submission.note_addedè stata scritta una nota
submission.customer_repliedla persona ha aggiunto testo, file o un follow-up, o ha premuto un pulsante
submission.deletedeliminato o cancellato
submit.automation_failedun'automazione ha rinunciato dopo i suoi nuovi tentativi

Strumenti MCP

Ogni rotta è anche uno strumento sul server MCP ospitato di app2email, così un assistente può fare l'intera configurazione in una conversazione: 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 e altri. Un buon primo messaggio all'assistente: "Leggi la guida di Submit-Info, poi configura un modulo di segnalazione problemi con foto e posizione, e avvisa i miei manager di quelli urgenti."

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

Maggiori informazioni sul collegamento di assistenti e strumenti di automazione: Strumenti di automazione e agenti.

Limiti

LimiteValore
Moduli per numero100
Passaggi in un modulo, domande in un passaggio12 e 12 (60 domande in un modulo, una sola domanda di posizione)
Elenchi50, ciascuno fino a 1.000 righe
Automazioni, connessioni, membri del team200, 30, 200
File in un invio60
Dimensione dei file25 MB da WhatsApp, 10 MB dalla pagina web o dall'API
Una nota o una risposta4.000 caratteri
Tag su un invio20
Chiamate a sistemi esterni60 al minuto e 2.000 al giorno per numero; 15 secondi e 256 KB per chiamata
Registro delle esecuzioniconservato 30 giorni

Non ancora disponibile

  • Incassare un pagamento su un invio (un preventivo viene accettato, non pagato).
  • Inviare un modulo come modulo WhatsApp a chi non Le ha scritto nelle ultime 24 ore: si ottiene invece il suo link web personale, da inviare con un qualsiasi template approvato.
  • Firme.
  • Gruppi ripetuti ("aggiungi un altro elemento").
  • Passare a un altro modulo a metà compilazione.
  • Compilare un modulo senza una connessione.
  • Altre lingue nei testi fissi della pagina web (ogni testo del suo modulo lo scrive Lei).
  • Documenti OpenAPI in YAML o Swagger 2, e server MCP che parlano solo il vecchio trasporto SSE.
  • Leggere valori dalle foto.

Tutto ciò che precede si imposta nella pagina Submit-Info della dashboard (/dashboard/app/submit). Domande: support@app2email.com.