Ifayela lokusetha ligcina konke ukusetha kwe-integration njengefayela lombhalo elilodwa. Liphakele njengekhophi yokuphepha, shintsha izinto eziningi ngesikhathi esisodwa, kopisha ukusetha kwenye inombolo, noma uvumele i-agent ye-AI ikusethe konke nge-API noma nge-MCP. Konke ukulayisha kuhlolwa kuqala futhi kungabuyiselwa emuva.
Ifayela lokusetha ligcina konke osethe kwi-integration: izilungiselelo, izinsiza nabasebenzi be-Book-and-Pay, izigaba, izinketho nemikhiqizo ye-Order-and-Pay, imicimbi, izinsuku nezinhlobo zamathikithi ze-Tickets-and-Pay, nezimo nezenzakalelo ze-Submit-Info. Liyifayela lombhalo elilodwa, ngakho ungaligcina njengekhophi yokuphepha, ulihlele kunoma yiliphi uhlelo lombhalo, ulilayishe futhi, noma ulikopishe kwenye yezinombolo zakho.
Ifayela elifanayo lisebenza ezindaweni ezintathu: kudashibhodi, ku-API nakwi-MCP server yama-agent e-AI.
Yonke i-integration inesigaba se-Setup file:
| Integration | Where |
|---|---|
| Book-and-Pay | ithebhu ye-Overview, ngaphansi |
| Order-and-Pay | ithebhu ye-Import & export, ngaphansi |
| Tickets-and-Pay | ithebhu ye-Settings, ngaphansi |
| Submit-Info | ithebhu ye-Settings, ngaphansi |
Ngabaphathi bezinombolo kuphela abanikazi nabaphathi abayibonayo.
Download inikeza ukusetha njenge-fayela .a2e.jsonl. Download with pictures inikeza .zip nefayela elifanayo nazo zonke izithombe ngaphakathi: ikhophi ephelele yokuphepha engasebenzi ngaphandle kwe-inthanethi, ongayilayisha futhi ngokuyiphelele.
Vula ifayela kuhlelo lombhalo bese ushintsha, wengeze noma ususe imigca. Umugca ngamunye uyinto eyodwa: insiza, umkhiqizo, umcimbi. Awudingi i-spreadsheet.
Upload a file iyihlola kuqala. Akukho okushintshayo okwamanje. Ubona inkinga ngayinye nenombolo yomugca wayo nokuthi ungayilungisa kanjani, noma ukuthi ukusebenzisa kuzokwenzani: ukuthi zingaki izinto ezintsha, eziguquliwe nezisusiwe, nokuthi yiziphi.
Apply yenza kuphela izinguquko ezikhonjiswe ukuhlola. Ukuhlola kusebenza amahora angu-1.
Konke ukusebenzisa kudweliwe ngaphansi kwe-Recent changes by setup file. Undo ibuyisela konke okushintshwe ukusebenzisa lokho, izinsuku ezingama-30, uma nje kungekho ukusebenzisa okulandelayo okushintshe i-integration efanayo. Hlehlisa okulandelayo kuqala.
Ngaphambi kokulayisha, khetha okuzokwenzeka ezintweni ifayela lingazidwelanga:
Uma ungumnikazi noma umphathi wezinombolo ezedlula ezisodwa, Copy to another number ikopisha ukusetha kwe-integration kusuka kunombolo oyikhona kuya kwenye: igatsha lesibili, inombolo yokuvivinya, noma ithempulethi onika yona sonke isitolo esisha.
Ukukopisha kuqala kuhlolwa kwenye inombolo, futhi kukhombise okuzoshintsha khona. Copy now iyasebenzisa. Izithombe ziyahamba nakho. Ukuhlehlisa ukukopisha, vula i-integration efanayo kwenye inombolo: ukukopisha kudweliwe lapho ngaphansi kwe-Recent changes.
Ikheli lewebhu le-Book-and-Pay, Order-and-Pay ne-Tickets-and-Pay libhekisela kunombolo eyodwa kuphela futhi alikaze likopishwe. Bekela enye inombolo ikheli layo kudashibhodi yayo.
| Integration | Imigca |
|---|---|
| Book-and-Pay | booking.settings (umugca ngamunye ngesigaba: amahora, web, ibrendi, imilayezo ...), booking.service, booking.provider (abasebenzi) |
| Order-and-Pay | shop.settings (umugca ngamunye ngesigaba, kubandakanya nokubukeka kwekhasi lokuoda), shop.category, shop.option_group, shop.item (namavariant nezithombe) |
| Tickets-and-Pay | tickets.settings (umugca ngamunye ngesigaba; wa_templates ngumbhalo wakho wemilayezo ye-WhatsApp), tickets.chart (izinhlelo zezihlalo ezigciniwe), tickets.event (namasuku, izinhlobo zamathikithi, imikhawulo ehlanganyelwe, izithombe nohlelo lwezihlalo), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Konke | asset: isithombe, esiqanjwe ngemigca esisisebenzisayo |
Akusoze kube efayelini
Ifayela lokusetha yi-JSON Lines: into ye-JSON ngomugca ngamunye. Umugca wokuqala uveza ukuthi liyini ifayela; yonke imigca eseleyo ingurekhodi elilodwa elinesi-type nesi-key. Ukhiye uthola futhi lelo rekhodi ngesikhathi esilandelayo: i-id yensiza, i-SKU yomkhiqizo, ikheli lomcimbi.
{"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"]}Ukuhleleka kwemigca akubalulekile. Amanani e-Book-and-Pay ngama-amount (25 kuyi-25.00, price ngumbhalo obonakala eduze kwawo). Amanani e-Order-and-Pay nawe-Tickets-and-Pay asemagcekeni amancane kakhulu emali (1250 kuyi-12.50). Zonke izinkambu zomugca ngamunye zichazwe kumhlahlandlo we-API (GET /v1/{number}/setup/guide).
Irekhodi libiza isithombe ngokhiye womugca we-asset. Isithombe sivela kwenye yalezi:
url: ikheli le-https://, esilethwa yithi.data: isithombe ngokwaso, nge-base64.file: indlela ngaphakathi kwe-.zip elayishiwe.sha256: isithombe sale nombolo sesivele sinaso.Ukukhipha kubhala ikheli elingaphezulu lesithombe ngasinye. Isithombe esingenaleli elingaphezulu, njengesithombe sansi sohlelo lwezihlalo, sithola isixhumanisi esisayiniwe esisebenza izinsuku ezingama-7, ukuze ifayela elikopishwe kwenye inombolo lisaphathe nesithombe.
{"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"]}Izithombe ziyi-PNG, JPEG noma WEBP, ezingaphezu kwe-5 MB ngalinye. Lapho i-integration idinga, isithombe siyancishiswa noma siguqulwe sibe yi-JPEG: ilogo ye-Book-and-Pay ukuze ilingane ne-300 KB, nesithombe se-Tickets-and-Pay ukuze silingane ne-1 MB.
I-agent isetha yonke i-integration ngesinyathelo esisodwa esihlolwayo, esikhundleni sezinkulungwane zezicelo. I-MCP server https://api.app2email.com/mcp/setup inalezi zinsiza: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job kanye no-undo_setup. Izicelo ezifanayo zikwi-API:
| Isicelo | Yenzani ntoni |
|---|---|
GET /v1/{number}/setup/guide | zonke izinhlobo zerekhodi, izinkambu zazo nemikhawulo yazo, nezibonelo. Ama-agent afunda lokhu kuqala |
GET /v1/{number}/setup/export | ifayela lamanje: format=jsonl, zip noma json |
POST /v1/{number}/setup/check | ihlola ifayela futhi ayishintshi lutho: izinkinga ngomugca, uhlelo, kanye ne-check_id |
POST /v1/{number}/setup/apply | isebenzisa ukuhlola: {"check_id": 123} |
POST /v1/{number}/setup/assets | igcina isithombe izinsuku ezingama-7 iphendule ngesi-sha256 saso |
GET /v1/{number}/setup/jobs | ukuhlola, ukusebenzisa nokuhlehlisa kwakamuva |
POST /v1/{number}/setup/jobs/{id}/undo | ibuyisela lokho okushintshwe ukusebenzisa |
Ukhiye udinga imvume yalelo integration: bookings:manage, orders:manage, tickets:manage noma submissions:manage. Ukhiye wesandbox ungakhipha futhi uhlole, kodwa awukwazi ukusebenzisa.
Umgomo ojwayelekile we-agent: funda umhlahlandlela, khipha ifayela lamanje, shintsha imigca embalwa, hlola, lungisa okubikwa ukuhlola, bese ubuza umsebenzisi ngaphambi kokusebenzisa i-check_id.
| Into | Umkhawulo |
|---|---|
| Ifayela | 20 MB yombhalo, imigca engama-50,000 (kudashibhodi, ukulayisha okudlula i-19 MB akuvunyelwe) |
| Isicelo esinezithombe ngaphakathi | 60 MB nge-API |
| Isithombe | 5 MB |
| Izithombe ezilethwa ngekheli | 100 ngokulayisha ngakunye; i-Order-and-Pay ilethela izithombe zomkhiqizo ngemuva phakathi kwemizuzu |
| Amafayela amakhulu | ngaphezu kwamarekhodi angama-1,000 ahlolwa futhi asetshenziswe ngemuva; idashibhodi iyalinda ngokwayo |
| Ukuhlola | kungasetshenziswa kanye, phakathi kwehora elingu-1 |
| Ukuhlehlisa | izinsuku ezingama-30 |