app2email API Presyo

Dokumentasyon

Mga setup file

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.

Sa dashboard

Bawat integration ay may seksyong Setup file:

IntegrationSaan
Book-and-Payang tab na Overview, sa ibaba
Order-and-Payang tab na Import & export, sa ibaba
Tickets-and-Payang tab na Settings, sa ibaba
Submit-Infoang tab na Settings, sa ibaba

Tanging ang owner at mga admin ng isang numero ang nakakakita nito.

  1. 1. I-download

    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.

  2. 2. Baguhin

    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.

  3. 3. I-upload

    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.

  4. 4. Ilapat

    Ginagawa ng Apply nang eksakto ang mga pagbabagong ipinakita ng pagsusuri. Valid ang pagsusuri sa loob ng 1 oras.

  5. 5. Bawiin

    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.

Idagdag at baguhin, o gawing eksaktong katulad ng file

Bago kayo mag-upload, piliin kung ano ang mangyayari sa mga bagay na hindi nakalista sa file:

  • Idagdag at baguhin (ang default): ang mga linya sa file ay nagagawa o nababago, at nananatili ang iba. Ang file na limang linya lang ang binabago lamang ang limang bagay na iyon.
  • Gawing eksaktong katulad ng file: anumang kaparehong uri na hindi nakalista sa file ay inaalis. Ang produkto ay ina-archive, hindi kailanman binubura. Ipinapakita ng pagsusuri ang bawat pagtanggal bago ilapat.

Kopyahin sa ibang numero

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.

Note

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.

Ano ang laman ng setup file

IntegrationMga linya
Book-and-Paybooking.settings (isang linya bawat seksyon: oras, web, brand, mga mensahe ...), booking.service, booking.provider (staff)
Order-and-Payshop.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-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Lahatasset: isang larawan, pinangalanan ng mga linyang gumagamit nito

Hindi kailanman nasa file

  • Mga secret: mga susi ng bayad, password at token ng koneksyon. Ang nakaimbak na secret ay nananatili gaya ng dati.
  • Ang pag-on ng isang integration. Hindi ito ginagawa ng file, at hindi rin nito inilalathala, kinakansela, o binubura ang event na may ticket.
  • Ang ginawa ng mga customer: mga booking, order, nabentang ticket, submission, customer, bayad.
  • Mga miyembro ng team at staff login.
  • Mga bilang ng stock ng Order-and-Pay, maliban kung tsinek ninyo ang Also set the stock figures from the file. Kung wala ito, ang file na na-export ninyo sa umaga ay hindi makakabawi sa mga benta ng araw.

Ang format

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.

Mga larawan

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.

Para sa mga AI agent at sa API

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:

TawagAno ang ginagawa nito
GET /v1/{number}/setup/guidebawat uri ng talaan, ang mga field at limitasyon nito, kasama ang mga halimbawa. Binabasa ito ng mga agent muna
GET /v1/{number}/setup/exportang kasalukuyang file: format=jsonl, zip o json
POST /v1/{number}/setup/checksinusuri ang file at walang binabago: mga problema ayon sa linya, ang plano, isang check_id
POST /v1/{number}/setup/applyina-apply ang isang pagsusuri: {"check_id": 123}
POST /v1/{number}/setup/assetsnagtatabi ng larawan sa loob ng 7 araw at sumasagot ng sha256 nito
GET /v1/{number}/setup/jobsang pinakabagong mga pagsusuri, apply at undo
POST /v1/{number}/setup/jobs/{id}/undoibinabalik 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.

Tip

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.

Mga limitasyon

AnoLimitasyon
Isang file20 MB ng teksto, 50,000 linya (sa dashboard, hanggang 19 MB ang upload)
Isang request na may laman na larawan60 MB sa pamamagitan ng API
Isang larawan5 MB
Mga larawang kinukuha sa pamamagitan ng address100 bawat upload; kumukuha ang Order-and-Pay ng mga larawan ng produkto sa background sa loob ng ilang minuto
Malalaking filemahigit 1,000 talaan ang sinusuri at ina-apply sa background; hinihintay ito ng dashboard nang kusa
Isang checkmaaaring i-apply sa loob ng 1 oras, minsan lamang
Undo30 araw