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.
Ogni integrazione ha una sezione Setup file:
| Integrazione | Dove |
|---|---|
| Book-and-Pay | la scheda Overview, in fondo |
| Order-and-Pay | la scheda Import & export, in fondo |
| Tickets-and-Pay | la scheda Settings, in fondo |
| Submit-Info | la scheda Settings, in fondo |
La vedono solo il proprietario e gli amministratori di un numero.
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'è.
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.
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.
Apply esegue esattamente le modifiche mostrate dal controllo. Un controllo resta valido per 1 ora.
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.
Prima di caricare, scelga cosa succede alle cose che il file non elenca:
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.
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.
| Integrazione | Righe |
|---|---|
| Book-and-Pay | booking.settings (una riga per sezione: orari, web, brand, messaggi ...), booking.service, booking.provider (staff) |
| Order-and-Pay | shop.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-Pay | tickets.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-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Tutte | asset: un'immagine, indicata dal nome nelle righe che la usano |
Mai in un file
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).
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.
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:
| Chiamata | Cosa fa |
|---|---|
GET /v1/{number}/setup/guide | ogni tipo di record, i suoi campi e limiti, con esempi. Gli agenti la leggono per prima |
GET /v1/{number}/setup/export | il file attuale: format=jsonl, zip o json |
POST /v1/{number}/setup/check | controlla un file e non cambia nulla: problemi per riga, il piano, un check_id |
POST /v1/{number}/setup/apply | applica un controllo: {"check_id": 123} |
POST /v1/{number}/setup/assets | conserva un'immagine per 7 giorni e risponde con il suo sha256 |
GET /v1/{number}/setup/jobs | gli ultimi controlli, applicazioni e annullamenti |
POST /v1/{number}/setup/jobs/{id}/undo | ripristina 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.
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.
| Cosa | Limite |
|---|---|
| Un file | 20 MB di testo, 50.000 righe (nella dashboard, un caricamento di al massimo 19 MB) |
| Una richiesta con immagini incluse | 60 MB tramite l'API |
| Un'immagine | 5 MB |
| Immagini recuperate tramite indirizzo | 100 per caricamento; Order-and-Pay recupera le immagini dei prodotti in background entro pochi minuti |
| File grandi | più di 1.000 record vengono controllati e applicati in background; la dashboard li attende da sola |
| Un controllo | può essere applicato entro 1 ora, una sola volta |
| Annullamento | 30 giorni |