Ang setup file ay naglalaman ng buong setup ng isang integration bilang iisang text file. I-download ito bilang backup, baguhin ang maraming bagay nang sabay, kopyahin ang setup sa ibang numero, o hayaang i-set up ng AI agent ang lahat sa pamamagitan ng API o MCP. Sinusuri muna ang bawat upload at maaaring bawiin.
Ang setup file ay naglalaman ng lahat ng itinakda ninyo sa isang integration: ang mga setting, serbisyo at staff ng Book-and-Pay, ang mga kategorya, opsyon at produkto ng Order-and-Pay, ang mga event, petsa at uri ng ticket ng Tickets-and-Pay, at ang mga form at automation ng Submit-Info. Iisang text file ito, kaya maaari ninyo itong itago bilang backup, baguhin sa anumang editor, i-upload ulit, o kopyahin sa ibang numero ninyo.
Iisang file ang gumagana sa tatlong lugar: ang dashboard, ang API, at ang MCP server para sa mga AI agent.
Bawat integration ay may seksyong Setup file:
| Integration | Saan |
|---|---|
| Book-and-Pay | ang tab na Overview, sa ibaba |
| Order-and-Pay | ang tab na Import & export, sa ibaba |
| Tickets-and-Pay | ang tab na Settings, sa ibaba |
| Submit-Info | ang tab na Settings, sa ibaba |
Tanging ang owner at mga admin ng isang numero ang nakakakita nito.
Ibinibigay ng Download ang setup bilang .a2e.jsonl na file. Ibinibigay ng Download with pictures ang isang .zip na may parehong file at bawat larawan sa loob: kumpletong offline na backup na maa-upload ulit gaya ng pagkakabigay nito.
Buksan ang file sa text editor at baguhin, magdagdag o magtanggal ng mga linya. Ang bawat linya ay isang bagay: isang serbisyo, isang produkto, isang event. Hindi kailangan ng spreadsheet.
Sinusuri muna ng Upload a file ang file. Wala pang nababago. Makikita ninyo ang bawat problema kasama ang numero ng linya at kung paano ito ayusin, o kung ano ang mangyayari kapag inilapat: ilan ang bago, binago o inalis, at alin-alin ang mga ito.
Ginagawa ng Apply nang eksakto ang mga pagbabagong ipinakita ng pagsusuri. Valid ang pagsusuri sa loob ng 1 oras.
Nakalista sa ilalim ng Recent changes by setup file ang bawat apply. Ibinabalik ng Undo ang lahat ng binago ng apply na iyon, sa loob ng 30 araw, basta walang kasunod na apply na nagbago sa parehong integration. Bawiin muna ang mas bago.
Bago kayo mag-upload, piliin kung ano ang mangyayari sa mga bagay na hindi nakalista sa file:
Kung owner o admin kayo ng higit sa isang numero, kinokopya ng Copy to another number ang setup ng isang integration mula sa numerong kinaroroonan ninyo papunta sa iba: isang pangalawang sangay, isang test number, o isang template na ibinibigay ninyo sa bawat bagong shop.
Unang sinusuri ang kopya sa kabilang numero, at ipinapakita nito kung ano ang babaguhin doon. Ang Copy now ang naglalapat nito. Kasama ng kopya ang mga larawan. Para bawiin ang kopya, buksan ang parehong integration sa kabilang numero: nakalista roon ang kopya sa ilalim ng Recent changes.
Ang web address ng Book-and-Pay, Order-and-Pay at Tickets-and-Pay ay kabilang sa isang numero lamang at hindi kailanman kinokopya. Itakda ang address ng kabilang numero sa sarili nitong dashboard.
| Integration | Mga linya |
|---|---|
| Book-and-Pay | booking.settings (isang linya bawat seksyon: oras, web, brand, mga mensahe ...), booking.service, booking.provider (staff) |
| Order-and-Pay | shop.settings (isang linya bawat seksyon, kasama ang itsura ng order page), shop.category, shop.option_group, shop.item (kasama ang mga variant at larawan) |
| Tickets-and-Pay | tickets.settings (isang linya bawat seksyon; ang wa_templates ay sarili ninyong pagkakasulat ng mga mensahe sa WhatsApp), tickets.chart (mga naka-save na seat plan), tickets.event (kasama ang mga petsa, uri ng ticket, mga shared limit, larawan at seat plan), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Lahat | asset: isang larawan, pinangalanan ng mga linyang gumagamit nito |
Hindi kailanman nasa file
Ang setup file ay JSON Lines: isang JSON object bawat linya. Sinasabi ng unang linya kung ano ang file; bawat ibang linya ay isang talaang may type at key. Ang key ang nakakahanap muli ng parehong talaan sa susunod: ang id ng serbisyo, ang SKU ng produkto, ang address ng event.
{"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"]}Hindi mahalaga ang ayos ng mga linya. Ang mga presyo sa Book-and-Pay ay mga halaga (ang 25 ay 25.00, ang price ay ang label na nasa tabi nito); ang mga presyo sa Order-and-Pay at Tickets-and-Pay ay nasa pinakamaliit na yunit ng pera (ang 1250 ay 12.50). Nasa gabay ng API (GET /v1/{number}/setup/guide) ang eksaktong mga field ng bawat linya.
Pinapangalanan ng isang talaan ang larawan sa pamamagitan ng key ng isang linyang asset. Ang larawan ay galing sa isa sa mga ito:
url: isang https:// na address, kinukuha namin.data: ang mismong larawan, base64.file: isang path sa loob ng na-upload na .zip.sha256: isang larawang mayroon na ang numerong ito.Isinusulat ng export ang pampublikong address ng bawat larawan. Ang larawang walang pampublikong address, gaya ng floor picture sa likod ng seat plan, ay makakakuha ng naka-sign na link na gumagana sa loob ng 7 araw, kaya ang file na kinopya sa ibang numero ay dala pa rin ito.
{"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"]}Ang mga larawan ay PNG, JPEG o WEBP, hanggang 5 MB bawat isa. Kapag kailangan ng integration, ginagawang mas maliit o ginagawang JPEG ang larawan: ang logo ng Book-and-Pay ay kinakasya sa 300 KB, ang larawan ng Tickets-and-Pay ay kinakasya sa 1 MB.
Nagse-set up ang agent ng buong integration sa iisang sinusuring hakbang sa halip na dose-dosenang tawag. Ang MCP server na https://api.app2email.com/mcp/setup ay may mga tool na ito: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job at undo_setup. Pareho ang mga tawag sa API:
| Tawag | Ano ang ginagawa nito |
|---|---|
GET /v1/{number}/setup/guide | bawat uri ng talaan, ang mga field at limitasyon nito, kasama ang mga halimbawa. Binabasa ito ng mga agent muna |
GET /v1/{number}/setup/export | ang kasalukuyang file: format=jsonl, zip o json |
POST /v1/{number}/setup/check | sinusuri ang file at walang binabago: mga problema ayon sa linya, ang plano, isang check_id |
POST /v1/{number}/setup/apply | ina-apply ang isang pagsusuri: {"check_id": 123} |
POST /v1/{number}/setup/assets | nagtatabi ng larawan sa loob ng 7 araw at sumasagot ng sha256 nito |
GET /v1/{number}/setup/jobs | ang pinakabagong mga pagsusuri, apply at undo |
POST /v1/{number}/setup/jobs/{id}/undo | ibinabalik ang binago ng isang apply |
Kailangan ng key ang sarili ng integration na pahintulot: bookings:manage, orders:manage, tickets:manage o submissions:manage. Maaaring mag-export at mag-check ang sandbox key, pero hindi mag-apply.
Ang karaniwang daloy para sa agent: basahin ang gabay, i-export ang kasalukuyang file, baguhin ang ilang linya, i-check, ayusin ang iniulat ng check, saka itanong sa user bago i-apply ang check_id.
| Ano | Limitasyon |
|---|---|
| Isang file | 20 MB ng teksto, 50,000 linya (sa dashboard, hanggang 19 MB ang upload) |
| Isang request na may laman na larawan | 60 MB sa pamamagitan ng API |
| Isang larawan | 5 MB |
| Mga larawang kinukuha sa pamamagitan ng address | 100 bawat upload; kumukuha ang Order-and-Pay ng mga larawan ng produkto sa background sa loob ng ilang minuto |
| Malalaking file | mahigit 1,000 talaan ang sinusuri at ina-apply sa background; hinihintay ito ng dashboard nang kusa |
| Isang check | maaaring i-apply sa loob ng 1 oras, minsan lamang |
| Undo | 30 araw |