app2email API Amanani

Imibhalo

Amafayela wokusetha

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.

Kudashibhodi

Yonke i-integration inesigaba se-Setup file:

IntegrationWhere
Book-and-Payithebhu ye-Overview, ngaphansi
Order-and-Payithebhu ye-Import & export, ngaphansi
Tickets-and-Payithebhu ye-Settings, ngaphansi
Submit-Infoithebhu ye-Settings, ngaphansi

Ngabaphathi bezinombolo kuphela abanikazi nabaphathi abayibonayo.

  1. 1. Landa

    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.

  2. 2. Shintsha

    Vula ifayela kuhlelo lombhalo bese ushintsha, wengeze noma ususe imigca. Umugca ngamunye uyinto eyodwa: insiza, umkhiqizo, umcimbi. Awudingi i-spreadsheet.

  3. 3. Layisha

    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.

  4. 4. Sebenzisa

    Apply yenza kuphela izinguquko ezikhonjiswe ukuhlola. Ukuhlola kusebenza amahora angu-1.

  5. 5. Hlehlisa

    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.

Engeza nushintsha, noma yenze njengefayela ngokuphelele

Ngaphambi kokulayisha, khetha okuzokwenzeka ezintweni ifayela lingazidwelanga:

  • Add and change (okuzenzakalelayo): imigca yefayela iyadalwa noma iyashintshwa, konke okunye kuhlala njengoba kunjalo. Ifayela elinemigca emihlanu lishintsha lezo zinto ezinhlanu kuphela.
  • Make it exactly like the file: noma yini ohlobweni olufanayo engadweliwe ifayela iyasuswa. Umkhiqizo uyagcinwa njenge-archive, awusoze usulwe. Ukuhlola kudweba konke okuzosuswa ngaphambi kokusebenzisa.

Kopisha kwenye inombolo

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.

Note

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.

Okuqukethwe yifayela lokusetha

IntegrationImigca
Book-and-Paybooking.settings (umugca ngamunye ngesigaba: amahora, web, ibrendi, imilayezo ...), booking.service, booking.provider (abasebenzi)
Order-and-Payshop.settings (umugca ngamunye ngesigaba, kubandakanya nokubukeka kwekhasi lokuoda), shop.category, shop.option_group, shop.item (namavariant nezithombe)
Tickets-and-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Konkeasset: isithombe, esiqanjwe ngemigca esisisebenzisayo

Akusoze kube efayelini

  • Izimfihlo: izinkhiye zokukhokha, amaphasiwedi okuxhuma nezithokheni. Imfihlo egciniwe ihlala njengoba kunjalo.
  • Ukuvula i-integration. Ifayela alisoze lilenze lowo, futhi alisoze lishicilele, likhansele noma lisule umcimbi onamathikithi.
  • Okwenziwe yimakhasimende: ukubhuka, ama-oda, amathikithi athengisiwe, ukuthunyelwa, amakhasimende, nezinkokhelo.
  • Amalungu eqembu namalogini abasebenzi.
  • Izibalo zesitoko se-Order-and-Pay, ngaphandle kokuthi uthike Also set the stock figures from the file. Ngaphandle kwalokho, ifayela olikhiphe ekuseni alikwazi ukuhlehlisa imikhiqizo edayiswe ngosuku.

Ifomethi

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).

Izithombe

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.

Ku-agents ze-AI nase-API

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:

IsiceloYenzani ntoni
GET /v1/{number}/setup/guidezonke izinhlobo zerekhodi, izinkambu zazo nemikhawulo yazo, nezibonelo. Ama-agent afunda lokhu kuqala
GET /v1/{number}/setup/exportifayela lamanje: format=jsonl, zip noma json
POST /v1/{number}/setup/checkihlola ifayela futhi ayishintshi lutho: izinkinga ngomugca, uhlelo, kanye ne-check_id
POST /v1/{number}/setup/applyisebenzisa ukuhlola: {"check_id": 123}
POST /v1/{number}/setup/assetsigcina isithombe izinsuku ezingama-7 iphendule ngesi-sha256 saso
GET /v1/{number}/setup/jobsukuhlola, ukusebenzisa nokuhlehlisa kwakamuva
POST /v1/{number}/setup/jobs/{id}/undoibuyisela 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.

Tip

Umgomo ojwayelekile we-agent: funda umhlahlandlela, khipha ifayela lamanje, shintsha imigca embalwa, hlola, lungisa okubikwa ukuhlola, bese ubuza umsebenzisi ngaphambi kokusebenzisa i-check_id.

Imikhawulo

IntoUmkhawulo
Ifayela20 MB yombhalo, imigca engama-50,000 (kudashibhodi, ukulayisha okudlula i-19 MB akuvunyelwe)
Isicelo esinezithombe ngaphakathi60 MB nge-API
Isithombe5 MB
Izithombe ezilethwa ngekheli100 ngokulayisha ngakunye; i-Order-and-Pay ilethela izithombe zomkhiqizo ngemuva phakathi kwemizuzu
Amafayela amakhulungaphezu kwamarekhodi angama-1,000 ahlolwa futhi asetshenziswe ngemuva; idashibhodi iyalinda ngokwayo
Ukuhlolakungasetshenziswa kanye, phakathi kwehora elingu-1
Ukuhlehlisaizinsuku ezingama-30