'n Opstellêer hou die hele opstelling van 'n integrasie as een teksleêr. Laai dit af as 'n rugsteun, verander baie dinge op een slag, kopieer 'n opstelling na 'n ander nommer, of laat 'n KI-agent alles via die API of MCP opstel. Elke oplaai word eers nagegaan en kan ongedaan gemaak word.
'n Opstellêer hou alles wat jy in 'n integrasie opgestel het: die instellings, die dienste en personeel van Book-and-Pay, die kategorieë, opsies en produkte van Order-and-Pay, die gebeurtenisse, datums en kaartiptes van Tickets-and-Pay, en die vorms en outomatiserings van Submit-Info. Dit is een teksleêr, so jy kan dit as rugsteun hou, dit in enige redigeerder verander, dit weer oplaai, of dit na een van jou ander nommers kopieer.
Dieselfde leêr werk op drie plekke: die dashboard, die API en die MCP-bediener vir KI-agente.
Elke integrasie het 'n Setup file-afdeling:
| Integrasie | Waar |
|---|---|
| Book-and-Pay | die Overview-oortjie, onderaan |
| Order-and-Pay | die Import & export-oortjie, onderaan |
| Tickets-and-Pay | die Settings-oortjie, onderaan |
| Submit-Info | die Settings-oortjie, onderaan |
Net die eienaar en die admins van 'n nommer sien dit.
Download gee die opstelling as 'n .a2e.jsonl-leêr. Download with pictures gee 'n .zip met dieselfde leêr en elke prent daarin: 'n volledige aflyn-rugsteun wat jy so weer kan oplaai.
Maak die leêr in 'n teksredigeerder oop en verander, voeg by of verwyder reëls. Elke reël is een ding: 'n diens, 'n produk, 'n gebeurtenis. 'n Sigblad is nie nodig nie.
Upload a file gaan die leêr eers na. Niks verander nog nie. Jy sien elke probleem met sy reëlnommer en hoe om dit reg te maak, of wat toepassing sou doen: hoeveel dinge nuut, verander of verwyder sal word, en watter.
Apply maak presies die veranderinge wat die nagaan gewys het. 'n Nagaan bly 1 uur geldig.
Elke toepassing word onder Recent changes by setup file gelys. Undo sit alles terug wat daardie toepassing verander het, vir 30 dae, solank geen latere toepassing dieselfde integrasie verander het nie. Maak die latere een eerste ongedaan.
Voordat jy oplaai, kies wat gebeur met die dinge wat die leêr nie lys nie:
As jy die eienaar of 'n admin van meer as een nommer is, kopieer Copy to another number 'n integrasie se opstelling van die nommer waarop jy is na 'n ander een: 'n tweede tak, 'n toetsnommer, of 'n sjabloon wat jy aan elke nuwe winkel gee.
Die kopie word eers op die ander nommer nagegaan en wys wat dit daar sou verander. Copy now pas dit toe. Die prente gaan saam. Om 'n kopie ongedaan te maak, open dieselfde integrasie op die ander nommer: die kopie word daar onder Recent changes gelys.
Die webadres van Book-and-Pay, Order-and-Pay en Tickets-and-Pay hoort aan een nommer en word nooit gekopieer nie. Stel die ander nommer se adres in sy eie dashboard.
| Integrasie | Reëls |
|---|---|
| Book-and-Pay | booking.settings (een reël per afdeling: ure, web, handelsmerk, boodskappe ...), booking.service, booking.provider (personeel) |
| Order-and-Pay | shop.settings (een reël per afdeling, insluitend die bladsy se voorkoms), shop.category, shop.option_group, shop.item (met variante en prente) |
| Tickets-and-Pay | tickets.settings (een reël per afdeling; wa_templates is jou eie bewoording van die WhatsApp-boodskappe), tickets.chart (gestoorde sitplanne), tickets.event (met sy datums, kaartiptes, gedeelde limiete, prente en sitplan), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Alles | asset: 'n prent, genoem deur die reëls wat dit gebruik |
Nooit in 'n leêr nie
'n Opstellêer is JSON Lines: een JSON-voorwerp per reël. Die eerste reël sê wat die leêr is; elke ander reël is een rekord met 'n type en 'n key. Die sleutel vind dieselfde rekord weer die volgende keer: 'n diens se id, 'n produk se SKU, 'n gebeurtenis se adres.
{"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"]}Die volgorde van die reëls maak nie saak nie. Book-and-Pay-pryse is bedrae (25 is 25.00, price is die etiket wat langs dit gewys word); Order-and-Pay- en Tickets-and-Pay-pryse is in die kleinste eenheid van die geldeenheid (1250 is 12.50). Die presiese velde van elke reël staan in die API se gids (GET /v1/{number}/setup/guide).
'n Rekord noem 'n prent deur die sleutel van 'n asset-reël. Die prent kom van een van:
url: 'n https://-adres, deur ons gehaal.data: die prent self, base64.file: 'n pad binne die opgelaaide .zip.sha256: 'n prent wat hierdie nommer reeds het.'n Uitvoer skryf elke prent se openbare adres. 'n Prent wat geen openbare adres het nie, soos die vloerprent agter 'n sitplan, kry 'n getekende skakel wat 7 dae werk, sodat 'n leêr wat na 'n ander nommer gekopieer word, dit steeds dra.
{"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"]}Prente is PNG, JPEG of WEBP, hoogstens 5 MB elk. Waar 'n integrasie dit nodig het, word 'n prent kleiner gemaak of in 'n JPEG omgeskakel: 'n Book-and-Pay-logo om by 300 KB te pas, 'n Tickets-and-Pay-prent om by 1 MB te pas.
'n Agent stel 'n hele integrasie in een nagegane stap op, in plaas van dosyne roepings. Die MCP-bediener https://api.app2email.com/mcp/setup het hierdie gereedskap: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job en undo_setup. Dieselfde roepings is in die API:
| Roeping | Wat dit doen |
|---|---|
GET /v1/{number}/setup/guide | elke rekordtipe, sy velde en limiete, met voorbeelde. Agente lees dit eerste |
GET /v1/{number}/setup/export | die huidige leêr: format=jsonl, zip of json |
POST /v1/{number}/setup/check | gaan 'n leêr na en verander niks nie: probleme per reël, die plan, 'n check_id |
POST /v1/{number}/setup/apply | pas 'n nagaan toe: {"check_id": 123} |
POST /v1/{number}/setup/assets | stoor 'n prent vir 7 dae en antwoord met sy sha256 |
GET /v1/{number}/setup/jobs | die jongste nagaansings, toepassings en ongedaan-maakings |
POST /v1/{number}/setup/jobs/{id}/undo | sit terug wat 'n toepassing verander het |
Die sleutel benodig die integrasie se eie toestemming: bookings:manage, orders:manage, tickets:manage of submissions:manage. 'n Sandbox-sleutel mag uitvoer en nagaan, maar nie toepas nie.
Die gewone lus vir 'n agent: lees die gids, voer die huidige leêr uit, verander 'n paar reëls, gaan na, maak reg wat die nagaan rapporteer, en vra dan die gebruiker voordat jy die check_id toepas.
| Wat | Limiet |
|---|---|
| 'n Leêr | 20 MB teks, 50,000 reëls (in die dashboard, 'n oplaai van hoogstens 19 MB) |
| 'n Versoek met prente binne | 60 MB deur die API |
| 'n Prent | 5 MB |
| Prente wat volgens adres gehaal word | 100 per oplaai; Order-and-Pay haal produkprente op die agtergrond binne minute |
| Groot leêrs | meer as 1,000 rekords word in die agtergrond nagegaan en toegepas; die dashboard wag self daarvoor |
| 'n Nagaan | kan binne 1 uur, een keer, toegepas word |
| Ongedaan maak | 30 dae |