app2email API Ọnụahịa

Akwụkwọ

Faịlụ nhazi

Faịlụ nhazi na-ejide nhazi zuru ezu nke mmekọrịta dị ka otu faịlụ ederede. Budata ya dị ka nchekwa, gbanwee ọtụtụ ihe n'otu oge, kpọọ nhazi gaa na nọmba ọzọ, ma ọ bụ kwe ka onye nnọchi AI nhazi ihe niile site na API ma ọ bụ MCP. Ọ bụla bulite na-enyocha ya tupu ya, a na-enwekwa ike ịkwaghachi ya.

Faịlụ nhazi na-ejide ihe niile ị hazigoro na mmekọrịta: ntọala, ọrụ na ndị otu Book-and-Pay, ụdị, nhọrọ na ngwaahịa Order-and-Pay, ihe omume, ụbọchị na ụdị tikiti Tickets-and-Pay, na fom na akpaaka Submit-Info. Ọ bụ otu faịlụ ederede, n'ihi ya ị nwere ike ijide ya dị ka nchekwa, gbanwee ya n'ihe ndezi ederede ọ bụla, bulite ya ọzọ, ma ọ bụ kpọọ ya gaa na nọmba ọzọ gị.

Otu faịlụ a na-arụ ọrụ n'ebe atọ: na dashboard, na API, na MCP server maka ndị onye nnọchi AI.

Na dashboard

Mmekọrịta ọ bụla nwere akụkụ Setup file:

MmekọrịtaEbe ọ dị
Book-and-Paytaabụ Overview, n'ala
Order-and-Paytaabụ Import & export, n'ala
Tickets-and-Paytaabụ Settings, n'ala
Submit-Infotaabụ Settings, n'ala

Naanị onye nwe ya na admin nke nọmba ka ha ga-ahụ ya.

  1. 1. Budata

    Download na-enye nhazi dị ka faịlụ .a2e.jsonl. Download with pictures na-enye .zip nwere otu faịlụ ahụ na foto ọ bụla n'ime ya: nchekwa zuru ezu na-enweghị ịntanet nke ị nwere ike ibulite ọzọ dịka ọ dị.

  2. 2. Gbanwee

    Meghee faịlụ ahụ na ihe ndezi ederede, gbanwee, tinye ma ọ bụ wepụ ahịrịokwu. Ahịrị ọ bụla bụ otu ihe: otu ọrụ, otu ngwaahịa, otu ihe omume. Achọghị spreadsheet.

  3. 3. Bulite

    Upload a file na-enyocha ya tupu. Ihe adịghị agbanwe ozugbo. Ị na-ahụ nsogbu ọ bụla yana nọmba ahịrị ya na otu esi edozi ya, ma ọ bụ ihe ntinye ahụ ga-eme: ole ihe ọhụrụ, ndị agbanwere na ndị wepụru, na ihe ndị ahụ.

  4. 4. Tinye

    Apply na-eme naanị mgbanwe ndị nyocha gosiri. Nyocha na-adị irè ruo 1 awa.

  5. 5. Kwaghachi

    A na-edepụta ntinye ọ bụla n'okpuru Recent changes by setup file. Undo na-eweghachi ihe niile ntinye ahụ gbanwere, ruo ụbọchị 30, ma ọ bụrụ na ntinye ọzọ esoghị gbanwee otu mmekọrịta ahụ. Kwaghachi nke ikpeazụ tupu.

Tinye na gbanwe, ma ọ bụ mee ka ọ dị ka faịlụ ahụ n'ezie

Tupu ibulite, họrọ ihe ga-eme maka ihe faịlụ ahụ adịghị edepụta:

  • Tinye na gbanwe (mkpebi nkịtị): ahịrị dị na faịlụ ahụ a na-emepụta ma ọ bụ gbanwe ya, ihe ndị ọzọ ka ha nọgide dị otu ahụ. Faịlụ nwere naanị ahịrị ise na-agbanwe naanị ihe ise ahụ.
  • Mee ka ọ dị ka faịlụ ahụ n'ezie: ihe ọ bụla nke otu ụdị nke faịlụ adịghị edepụta ga-ewepụ. A na-edebe ngwaahịa, ọ dịghị ahụ hichapụ. Nyocha ahụ na-edepụta ihe niile a ga-ewepụ tupu ị tinye ya.

Kpọọ gaa na nọmba ọzọ

Ọ bụrụ na ị bụ onye nwe ma ọ bụ admin nke nọmba karịa otu, Copy to another number na-akpọ nhazi mmekọrịta site na nọmba ị nọ gaa na nọmba ọzọ: alaka ọzọ, nọmba nnwale, ma ọ bụ ihe nlereanya ị nyere ụlọ ahịa ọhụrụ ọ bụla.

A na-enyocha ihe a kpọrọ na nọmba ahụ ọzọ tupu, ọ na-egosi ihe ọ ga-agbanwe ebe ahụ. Copy now na-etinye ya. Foto na-esonyere ya. Iji kwaghachi ihe akpọrọ, meghee otu mmekọrịta ahụ na nọmba ọzọ: a na-edepụta ya ebe ahụ n'okpuru Recent changes.

Note

Adreesị weebụ nke Book-and-Pay, Order-and-Pay na Tickets-and-Pay bụ nke otu nọmba naanị, a gaghị akpọ ya. Tinye adreesị nke nọmba ọzọ n'ime dashboard nke ya.

Ihe faịlụ nhazi nwere

MmekọrịtaAhịrị
Book-and-Paybooking.settings (otu ahịrị maka otu akụkụ: awa, weebụ, brand, ozi ...), booking.service, booking.provider (ndị otu)
Order-and-Payshop.settings (otu ahịrị maka otu akụkụ, gụnyere ọdịdị nke ibe order), shop.category, shop.option_group, shop.item (na ụdị dị iche iche na foto)
Tickets-and-Paytickets.settings (otu ahịrị maka otu akụkụ; wa_templates bụ okwu gị n'onwe gị maka ozi WhatsApp), tickets.chart (ụzọ nkwụ ntebe echekwara), tickets.event (na ụbọchị ya, ụdị tikiti, oke a kekọrịtara, foto na ụzọ nkwụ ntebe), tickets.promo
Submit-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Ihe niileasset: foto, a na-akpọ ya site na ahịrị ndị jiri ya

Ihe ọ bụla n'ime faịlụ ahụ anaghị enwe

  • Ihe nzuzo: igodo ịkwụ ụgwọ, paswọọdụ njikọ na akara. Nzuzo echekwara na-anọgide dị otu ahụ.
  • Ịmalite mmekọrịta. Faịlụ anaghị eme nke a, faịlụ anaghị ebipụta, akagharị ma ọ bụ hichapụ ihe omume nwere tikiti.
  • Ihe ndị ahịa mere: ndebanye, order, tikiti ere, ndabanye, ndị ahịa, ịkwụ ụgwọ.
  • Ndị otu na akaụntụ ndị ọrụ.
  • Ọnụọgụgụ ngwongwo nke Order-and-Pay, ma ọ bụrụ na ị kpachara anya n'ihe Also set the stock figures from the file. Na-enweghị ya, faịlụ ị bupụrụ n'ụtụtụ enweghị ike ikwaghachi ahịa ụbọchị ahụ.

Usoro

Faịlụ nhazi bụ JSON Lines: otu object JSON n'otu ahịrị. Ahịrị mbụ na-egosi ihe faịlụ ahụ bụ; ahịrị ndị ọzọ niile bụ otu ndekọ nwere type na key. Key ahụ na-achọta otu ndekọ ahụ ọzọ mgbe ọ dị: id nke ọrụ, SKU nke ngwaahịa, adreesị nke ihe omume.

{"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"]}

Usoro ahịrị adịghị mkpa. Ọnụahịa Book-and-Pay bụ ego (25 pụtara 25.00, price bụ akara a na-egosi n'akụkụ ya); ọnụahịa Order-and-Pay na Tickets-and-Pay dị n'obere nkeji ego ahụ (1250 pụtara 12.50). Ihe ọ bụla dị na ahịrị ọ bụla dị n'akwụkwọ nkuzi API (GET /v1/{number}/setup/guide).

Foto

Ndekọ na-akpọ foto site na key nke ahịrị asset. Foto ahụ sitere n'otu n'ime ndị a:

  • url: adreesị https://, anyị na-ewetara ya.
  • data: foto n'onwe ya, base64.
  • file: ebe ọ nọ n'ime .zip a bulitere.
  • sha256: foto nọmba a nwere dị kemgbe.

Ntinye na-ede adreesị ọha nke foto ọ bụla. Foto na-enweghị adreesị ọha, dịka foto ala n'azụ ụzọ nkwụ ntebe, na-enweta njikọ a bịanyere aka nke na-arụ ọrụ ruo ụbọchị 7, ya mere faịlụ a kpọrọ gaa na nọmba ọzọ ka na-ebu ya.

{"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"]}

Foto ga-abụ PNG, JPEG ma ọ bụ WEBP, ruo 5 MB kwa otu. Ebe mmekọrịta chọrọ ya, a na-eme foto ahụ ka nta ma ọ bụ gbanwee ya ka JPEG: logo Book-and-Pay ka ọ dabara na 300 KB, foto Tickets-and-Pay ka ọ dabara na 1 MB.

Maka ndị onye nnọchi AI na API

Onye nnọchi na-ahazi mmekọrịta zuru ezu n'otu nzọụkwụ enyochabeghị, kama ịkpọ dozina oku. MCP server https://api.app2email.com/mcp/setup nwere ngwá ọrụ ndị a: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job na undo_setup. Otu oku ahụ dị na API:

OkuIhe ọ na-eme
GET /v1/{number}/setup/guideụdị ndekọ niile, ndị ubi ha na oke ha, na ihe atụ. Ndị onye nnọchi na-agụ ya tupu ya
GET /v1/{number}/setup/exportfaịlụ ugbu a: format=jsonl, zip ma ọ bụ json
POST /v1/{number}/setup/checkna-enyocha faịlụ ma adịghị agbanwe ihe: nsogbu site na ahịrị, atụmatụ, check_id
POST /v1/{number}/setup/applyna-etinye nyocha: {"check_id": 123}
POST /v1/{number}/setup/assetsna-echekwa foto ruo ụbọchị 7 ma na-azaghachi sha256 ya
GET /v1/{number}/setup/jobsnyocha, ntinye na nkwaghachi kacha ọhụrụ
POST /v1/{number}/setup/jobs/{id}/undona-eweghachi ihe ntinye gbanwere

Igodo ahụ chọrọ ikike nke mmekọrịta ahụ n'onwe ya: bookings:manage, orders:manage, tickets:manage ma ọ bụ submissions:manage. Igodo sandbox nwere ike ịkpọ ihe na nyocha, mana ọ gaghị etinye ihe.

Tip

Usoro a na-ejikarị maka onye nnọchi: gụọ nkuzi, kpọọ faịlụ ugbu a, gbanwee ahịrị ole na ole, nyochaa, dozie ihe nyocha gosiri, mgbe ahụ jụọ onye ọrụ tupu itinye check_id.

Oke

IheOke
Faịlụ20 MB nke ederede, ahịrị 50,000 (na dashboard, ibulite nwere ike ịbụ ruo 19 MB)
Oku nwere foto n'ime ya60 MB site na API
Foto5 MB
Foto a na-enweta site na adreesị100 kwa ibulite; Order-and-Pay na-enweta foto ngwaahịa n'azụ n'ime nkeji
Faịlụ buru ibukarịa ndekọ 1,000 a na-enyocha ma tinye n'azụ; dashboard na-echere ha n'onwe ya
Nyochaa na-etinye ya n'ime 1 awa, otu ugboro
Nkwaghachiụbọchị 30