app2email API Prezzi

Documentazione

File di configurazione

Un file di configurazione contiene l'intera configurazione di un'integrazione in un solo file di testo. Lo scarichi come backup, modifichi molte cose in una volta, copi una configurazione su un altro numero, oppure lasci che un agente AI configuri tutto tramite l'API o MCP. Ogni caricamento viene prima controllato e si può annullare.

Un file di configurazione contiene tutto ciò che imposta in un'integrazione: le impostazioni, i servizi e lo staff di Book-and-Pay, le categorie, le opzioni e i prodotti di Order-and-Pay, gli eventi, le date e i tipi di biglietto di Tickets-and-Pay, e i moduli e le automazioni di Submit-Info. È un unico file di testo, quindi può conservarlo come backup, modificarlo in qualsiasi editor, caricarlo di nuovo o copiarlo su un altro dei suoi numeri.

Lo stesso file funziona in tre posti: la dashboard, l'API e il server MCP per gli agenti AI.

Nella dashboard

Ogni integrazione ha una sezione Setup file:

IntegrazioneDove
Book-and-Payla scheda Overview, in fondo
Order-and-Payla scheda Import & export, in fondo
Tickets-and-Payla scheda Settings, in fondo
Submit-Infola scheda Settings, in fondo

La vedono solo il proprietario e gli amministratori di un numero.

  1. 1. Scaricare

    Download fornisce la configurazione come file .a2e.jsonl. Download with pictures fornisce un .zip con lo stesso file e tutte le immagini al suo interno: un backup offline completo che può caricare di nuovo così com'è.

  2. 2. Modificare

    Apra il file in un editor di testo e modifichi, aggiunga o rimuova righe. Ogni riga è una cosa: un servizio, un prodotto, un evento. Non serve un foglio di calcolo.

  3. 3. Caricare

    Upload a file lo controlla prima. Per ora non cambia nulla. Vede ogni problema con il suo numero di riga e come risolverlo, oppure cosa farebbe l'applicazione: quante cose sono nuove, modificate o rimosse, e quali.

  4. 4. Applicare

    Apply esegue esattamente le modifiche mostrate dal controllo. Un controllo resta valido per 1 ora.

  5. 5. Annullare

    Ogni applicazione è elencata sotto Recent changes by setup file. Undo ripristina tutto ciò che quell'applicazione ha modificato, per 30 giorni, a condizione che nessuna applicazione successiva abbia modificato la stessa integrazione. Annulli prima quella più recente.

Aggiungere e modificare, oppure renderlo identico al file

Prima di caricare, scelga cosa succede alle cose che il file non elenca:

  • Add and change (l'impostazione predefinita): le righe del file vengono create o modificate, tutto il resto resta com'è. Un file con solo cinque righe modifica solo quelle cinque cose.
  • Make it exactly like the file: tutto ciò che è dello stesso tipo e che il file non elenca viene rimosso. Un prodotto viene archiviato, mai eliminato. Il controllo elenca ogni rimozione prima che applichi.

Copiare su un altro numero

Se è il proprietario o un amministratore di più di un numero, Copy to another number copia la configurazione di un'integrazione dal numero in cui si trova a un altro: una seconda sede, un numero di prova o un modello che dà a ogni nuovo negozio.

La copia viene prima controllata sull'altro numero e mostra cosa vi cambierebbe. Copy now la applica. Le immagini vengono copiate insieme. Per annullare una copia, apra la stessa integrazione sull'altro numero: la copia è elencata lì sotto Recent changes.

Note

L'indirizzo web di Book-and-Pay, Order-and-Pay e Tickets-and-Pay appartiene a un solo numero e non viene mai copiato. Imposti l'indirizzo dell'altro numero nella sua dashboard.

Cosa contiene un file di configurazione

IntegrazioneRighe
Book-and-Paybooking.settings (una riga per sezione: orari, web, brand, messaggi ...), booking.service, booking.provider (staff)
Order-and-Payshop.settings (una riga per sezione, compreso l'aspetto della pagina degli ordini), shop.category, shop.option_group, shop.item (con varianti e immagini)
Tickets-and-Paytickets.settings (una riga per sezione; wa_templates è la sua formulazione dei messaggi WhatsApp), tickets.chart (piantine dei posti salvate), tickets.event (con le sue date, i tipi di biglietto, i limiti condivisi, le immagini e la piantina dei posti), tickets.promo
Submit-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Tutteasset: un'immagine, indicata dal nome nelle righe che la usano

Mai in un file

  • I segreti: chiavi di pagamento, password di connessione e token. Un segreto memorizzato resta com'è.
  • L'attivazione di un'integrazione. Un file non lo fa mai, e un file non pubblica, non annulla e non elimina mai un evento con biglietti.
  • Ciò che hanno fatto i clienti: prenotazioni, ordini, biglietti venduti, invii di moduli, clienti, pagamenti.
  • I membri del team e gli accessi dello staff.
  • Le giacenze di Order-and-Pay, a meno che selezioni Also set the stock figures from the file. Senza questa opzione, un file esportato la mattina non può annullare le vendite della giornata.

Il formato

Un file di configurazione è in JSON Lines: un oggetto JSON per riga. La prima riga dice cos'è il file; ogni altra riga è un record con un type e una key. La chiave permette di ritrovare lo stesso record la volta successiva: l'id di un servizio, lo SKU di un prodotto, l'indirizzo di un evento.

{"type":"a2e.setup","version":1,"products":["booking"]}
{"type":"booking.service","key":"haircut","name":"Haircut","duration_min":30,"price":"$25","price_amount":25}
{"type":"booking.service","key":"beard","name":"Beard trim","duration_min":15,"price":"$12","price_amount":12}
{"type":"booking.provider","key":"sam","name":"Sam","services":["haircut","beard"]}

L'ordine delle righe non conta. I prezzi di Book-and-Pay sono importi (25 è 25,00, price è l'etichetta mostrata accanto); i prezzi di Order-and-Pay e Tickets-and-Pay sono nella più piccola unità della valuta (1250 è 12,50). I campi esatti di ogni riga sono nella guida dell'API (GET /v1/{number}/setup/guide).

Immagini

Un record indica un'immagine tramite la chiave di una riga asset. L'immagine proviene da una di queste fonti:

  • url: un indirizzo https://, recuperato da noi.
  • data: l'immagine stessa, in base64.
  • file: un percorso all'interno del .zip caricato.
  • sha256: un'immagine che questo numero ha già.

Un'esportazione scrive l'indirizzo pubblico di ogni immagine. Un'immagine senza indirizzo pubblico, come l'immagine della pianta sotto una piantina dei posti, riceve un link firmato che funziona per 7 giorni, così un file copiato su un altro numero la porta con sé.

{"type":"asset","key":"classic-photo","url":"https://example.com/classic.jpg"}
{"type":"shop.item","key":"BURGER-CLASSIC","name":"Classic burger","category":"burgers","price":1250,"images":["classic-photo"]}

Le immagini sono PNG, JPEG o WEBP, al massimo 5 MB ciascuna. Dove un'integrazione lo richiede, un'immagine viene ridotta o trasformata in JPEG: un logo di Book-and-Pay per stare in 300 KB, un'immagine di Tickets-and-Pay per stare in 1 MB.

Per agenti AI e API

Un agente configura un'intera integrazione in un unico passaggio controllato invece che con decine di chiamate. Il server MCP https://api.app2email.com/mcp/setup ha questi strumenti: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job e undo_setup. Le stesse chiamate sono nell'API:

ChiamataCosa fa
GET /v1/{number}/setup/guideogni tipo di record, i suoi campi e limiti, con esempi. Gli agenti la leggono per prima
GET /v1/{number}/setup/exportil file attuale: format=jsonl, zip o json
POST /v1/{number}/setup/checkcontrolla un file e non cambia nulla: problemi per riga, il piano, un check_id
POST /v1/{number}/setup/applyapplica un controllo: {"check_id": 123}
POST /v1/{number}/setup/assetsconserva un'immagine per 7 giorni e risponde con il suo sha256
GET /v1/{number}/setup/jobsgli ultimi controlli, applicazioni e annullamenti
POST /v1/{number}/setup/jobs/{id}/undoripristina ciò che un'applicazione ha modificato

La chiave richiede il permesso proprio dell'integrazione: bookings:manage, orders:manage, tickets:manage o submissions:manage. Una chiave sandbox può esportare e controllare, ma non applicare.

Tip

Il ciclo abituale per un agente: leggere la guida, esportare il file attuale, modificare alcune righe, controllare, correggere ciò che il controllo segnala, poi chiedere all'utente prima di applicare il check_id.

Limiti

CosaLimite
Un file20 MB di testo, 50.000 righe (nella dashboard, un caricamento di al massimo 19 MB)
Una richiesta con immagini incluse60 MB tramite l'API
Un'immagine5 MB
Immagini recuperate tramite indirizzo100 per caricamento; Order-and-Pay recupera le immagini dei prodotti in background entro pochi minuti
File grandipiù di 1.000 record vengono controllati e applicati in background; la dashboard li attende da sola
Un controllopuò essere applicato entro 1 ora, una sola volta
Annullamento30 giorni