Fayil ɗin saiti yana riƙe da cikakken saitin haɗin kai a matsayin fayil ɗaya na rubutu. Sauke shi a matsayin ajiyar baya, canja abubuwa da yawa a lokaci ɗaya, kwafa saiti zuwa wata lamba, ko bari wakili na AI ya saita komai ta API ko MCP. Kowane lodawa ana duba shi da farko kuma ana iya mayar da shi baya.
Fayil ɗin saiti yana riƙe da duk abin da ka saita a haɗin kai: saituna, ayyuka da ma'aikata na Book-and-Pay, nau'ikan, zaɓuɓɓuka da kayayyaki na Order-and-Pay, abubuwan da suka faru, ranaku da nau'in tikiti na Tickets-and-Pay, da fom da atomatik na Submit-Info. Fayil ɗaya ne na rubutu, don haka za ka iya ajiye shi a matsayin ajiyar baya, canja shi a kowace edita, sake loda shi, ko kwafa shi zuwa wata lambarka.
Fayil iri ɗaya yana aiki a wurare uku: dashboard, API da MCP server na wakilan AI.
Kowane haɗin kai yana da sashe na Setup file:
| Haɗin kai | Inda yake |
|---|---|
| Book-and-Pay | shafin Overview, a kasa |
| Order-and-Pay | shafin Import & export, a kasa |
| Tickets-and-Pay | shafin Settings, a kasa |
| Submit-Info | shafin Settings, a kasa |
Mai lamba da masu gudanarwarta ne kaɗai ke ganinsa.
Download yana ba da saitin a matsayin fayil .a2e.jsonl. Download with pictures yana ba da .zip mai fayil iri ɗaya da dukan hotuna a ciki: cikakken ajiyar baya ba tare da intanet ba, wanda za ka iya sake lodawa yadda yake.
Buɗe fayil a editan rubutu ka canja, ƙara ko cire layuka. Kowane layi abu ɗaya ne: sabis, kaya, ko taron. Ba a buƙatar spreadsheet.
Upload a file yana duba fayil da farko. Babu abin da ke canzawa tukuna. Za ka ga kowace matsala da lambar layinta da yadda za a gyara ta, ko abin da amfani zai yi: nawa ne sabbi, waɗanda aka canza, waɗanda aka cire, da kuma su waye.
Apply yana yin daidai canje-canjen da duba ya nuna. Duba yana aiki na awa 1.
Kowane apply yana cikin jerin Recent changes by setup file. Undo yana mayar da duk abin da wannan apply ya canza, na kwanaki 30, muddin wani apply na baya-bayan nan bai canza haɗin kai iri ɗaya ba. Ka soke na baya-bayan nan da farko.
Kafin ka loda, zaɓi abin da zai faru da abubuwan da fayil ba ya lissafawa:
Idan kai mai lamba ko mai gudanarwa ne na lambobi fiye da ɗaya, Copy to another number yana kwafa saitin haɗin kai daga lambar da kake kai zuwa wata: reshe na biyu, lambar gwaji, ko samfuri da kake ba kowane sabon shago.
Ana duba kwafin a ɗayar lambar da farko kuma yana nuna abin da zai canza a can. Copy now yana aiwatar da shi. Hotuna suna tafiya tare da shi. Don soke kwafi, buɗe haɗin kai iri ɗaya a ɗayar lambar: kwafin zai kasance a jerin Recent changes a can.
Adireshin yanar gizo na Book-and-Pay, Order-and-Pay da Tickets-and-Pay na lamba ɗaya ne kawai kuma ba a taɓa kwafa shi ba. Saita adireshin ɗayar lambar a dashboard ɗinta.
| Haɗin kai | Layuka |
|---|---|
| Book-and-Pay | booking.settings (layi ɗaya ga kowane sashe: awanni, yanar gizo, alama, saƙonni ...), booking.service, booking.provider (ma'aikata) |
| Order-and-Pay | shop.settings (layi ɗaya ga kowane sashe, har da yadda shafin oda yake), shop.category, shop.option_group, shop.item (tare da bambance-bambance da hotuna) |
| Tickets-and-Pay | tickets.settings (layi ɗaya ga kowane sashe; wa_templates shine kalmominka na saƙonnin WhatsApp), tickets.chart (tsarin kujerun da aka adana), tickets.event (tare da ranaku, nau'in tikiti, iyakoki na bai ɗaya, hotuna da tsarin kujeru), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Duka | asset: hoto, wanda layukan da ke amfani da shi ke ba shi suna |
Ba a taɓa sanya su a cikin fayil ba
Fayil ɗin saiti JSON Lines ne: abu ɗaya na JSON a kowane layi. Layin farko yana nuna menene fayil ɗin; kowane layi na gaba rikodi ɗaya ne mai type da key. Key ɗin yana gano rikodi iri ɗaya a lokaci na gaba: id na sabis, SKU na kaya, adireshin taron.
{"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"]}Tsarin layukan ba shi da muhimmanci. Farashin Book-and-Pay adadi ne (25 yana nufin 25.00, price shi ne lakabin da ake nunawa kusa da shi); farashin Order-and-Pay da Tickets-and-Pay suna cikin mafi ƙarancin rukunin kuɗi (1250 yana nufin 12.50). Ainihin filayen kowane layi suna cikin jagorar API (GET /v1/{number}/setup/guide).
Rikodi yana sunan hoto ta key ɗin layin asset. Hoton yana fitowa daga ɗaya daga cikin:
url: adireshin https://, da mu ke ɗauka.data: hoton kansa, base64.file: hanya a cikin .zip da aka loda.sha256: hoton da wannan lamba ta riga ta ke da shi.Fitarwa tana rubuta adireshin jama'a na kowane hoto. Hoton da ba shi da adireshin jama'a, kamar hoton bene a bayan tsarin kujeru, yana samun hanyar sa hannu da ke aiki na kwanaki 7, don haka fayil da aka kwafa zuwa wata lamba har yanzu yana ɗauke da shi.
{"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"]}Hotuna PNG, JPEG ko WEBP ne, har 5 MB kowanne. A inda haɗin kai ke buƙata, ana rage hoto ko a mayar da shi JPEG: tambarin Book-and-Pay zuwa 300 KB, hoton Tickets-and-Pay zuwa 1 MB.
Wakili yana saita dukan haɗin kai a mataki ɗaya da aka duba, maimakon kira da dama. MCP server https://api.app2email.com/mcp/setup yana da waɗannan kayan aiki: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job da undo_setup. Kiran iri ɗaya suna cikin API:
| Kira | Abin da yake yi |
|---|---|
GET /v1/{number}/setup/guide | kowane nau'in rikodi, filayensa da iyakokinsa, tare da misalai. Wakilai suna karanta shi da farko |
GET /v1/{number}/setup/export | fayil na yanzu: format=jsonl, zip ko json |
POST /v1/{number}/setup/check | yana duba fayil ba tare da canza komai ba: matsaloli ta layi, shirin, da check_id |
POST /v1/{number}/setup/apply | yana aiwatar da duba: {"check_id": 123} |
POST /v1/{number}/setup/assets | yana adana hoto na kwanaki 7 kuma yana amsawa da sha256 ɗinsa |
GET /v1/{number}/setup/jobs | dubawa, apply da undo na baya-bayan nan |
POST /v1/{number}/setup/jobs/{id}/undo | yana mayar da abin da apply ya canza |
Key ɗin yana buƙatar izinin haɗin kai nasa: bookings:manage, orders:manage, tickets:manage ko submissions:manage. Sandbox key na iya fitarwa da dubawa, amma ba apply ba.
Tsarin da aka saba ga wakili: karanta jagorar, fitar da fayil na yanzu, canza ƴan layuka, duba, gyara abin da duba ya nuna, sannan ka tambayi mai amfani kafin ka yi apply na check_id.
| Abin da | Iyaka |
|---|---|
| Fayil | MB 20 na rubutu, layuka 50,000 (a dashboard, lodawa har MB 19) |
| Buƙata da hotuna a ciki | MB 60 ta API |
| Hoto | MB 5 |
| Hotunan da aka ɗauka ta adireshi | 100 a kowane lodawa; Order-and-Pay yana ɗaukar hotunan kaya a bango cikin mintuna |
| Manyan fayiloli | rikodi sama da 1,000 ana duba su kuma ana aiwatar da su a bango; dashboard yana jiran su da kansa |
| Duba | ana iya yin apply a cikin awa 1, sau ɗaya |
| Undo | kwanaki 30 |