app2email API Iye Owó

Ìwé ìtọ́sọ́nà

Àwọn faili ìṣètò

Faili ìṣètò kan ní gbogbo ìṣètò ìbáṣepọ̀ kan gẹ́gẹ́ bí faili ọ̀rọ̀ kan. Gbà á sílẹ̀ gẹ́gẹ́ bí ẹ̀dà ìpamọ́, yí ọ̀pọ̀ nǹkan padà ní ẹ̀ẹ̀kan, dàkọ ìṣètò sí nọ́mbà mìíràn, tàbí jẹ́ kí agent AI ṣètò ohun gbogbo nípasẹ̀ API tàbí MCP. Gbogbo ìgbékalẹ̀ ni a kọ́kọ́ ṣàyẹ̀wò, a sì lè padà ṣe é.

Faili ìṣètò ní gbogbo ohun tí ẹ ṣètò nínú ìbáṣepọ̀ kan: àwọn ètò, iṣẹ́ àti òṣìṣẹ́ Book-and-Pay, ẹ̀ka, àṣàyàn àti ọjà Order-and-Pay, àwọn ìṣẹ̀lẹ̀, ọjọ́ àti irú tikẹ́ẹ̀tì Tickets-and-Pay, àti àwọn fọ́ọ̀mù àti ìṣiṣẹ́ aládàáṣe Submit-Info. Ó jẹ́ faili ọ̀rọ̀ kan, nítorí náà ẹ lè pa á mọ́ gẹ́gẹ́ bí ẹ̀dà ìpamọ́, ẹ lè yí i padà nínú olóòtú ọ̀rọ̀ èyíkéyìí, ẹ lè gbé e sókè lẹ́ẹ̀kan sí i, tàbí ẹ lè dàkọ sí nọ́mbà mìíràn tí ẹ ní.

Faili kan náà ń ṣiṣẹ́ ní ibi mẹ́ta: dashboard, API àti MCP server fún àwọn agent AI.

Nínú dashboard

Ìbáṣepọ̀ kọ̀ọ̀kan ní apá Setup file:

Ìbáṣepọ̀Ibo
Book-and-Paytab Overview, ní ìsàlẹ̀
Order-and-Paytab Import & export, ní ìsàlẹ̀
Tickets-and-Paytab Settings, ní ìsàlẹ̀
Submit-Infotab Settings, ní ìsàlẹ̀

Ẹni tó ni nọ́mbà àti àwọn alákòóso rẹ̀ nìkan ni ó ń rí i.

  1. 1. Gbà sílẹ̀

    Download ń fún ní ìṣètò gẹ́gẹ́ bí faili .a2e.jsonl. Download with pictures ń fún ní .zip pẹ̀lú faili kan náà àti gbogbo àwòrán inú rẹ̀: ẹ̀dà ìpamọ́ kíkún tí kò nílò ayélujára, tí ẹ lè gbé sókè bí ó ṣe wà.

  2. 2. Yí padà

    Ṣí faili náà nínú olóòtú ọ̀rọ̀ kan, kí ẹ yí, fi kún, tàbí yọ àwọn ìlà padà. Ìlà kọ̀ọ̀kan jẹ́ nǹkan kan: iṣẹ́ kan, ọjà kan, ìṣẹ̀lẹ̀ kan. A kò nílò spreadsheet.

  3. 3. Gbé sókè

    Upload a file ń ṣàyẹ̀wò rẹ̀ kọ́kọ́. Kò sí nǹkan tí yóò yípadà síbẹ̀. Ẹ óò rí ìṣòro kọ̀ọ̀kan pẹ̀lú nọ́mbà ìlà rẹ̀ àti bí a ṣe lè tún un ṣe, tàbí ohun tí fífi sí ìṣe yóò ṣe: iye àwọn nǹkan tuntun, àwọn tí a yí padà tàbí tí a yọ kúrò, àti èwo.

  4. 4. Fi sí ìṣe

    Apply ń ṣe gangan àwọn àyípadà tí ìṣàyẹ̀wò fihàn. Ìṣàyẹ̀wò wúlò fún wákàtí 1.

  5. 5. Padà sẹ́yìn

    Gbogbo ìfisí ni a ṣe àkójọ rẹ̀ lábẹ́ Recent changes by setup file. Undo ń dá gbogbo ohun tí ìfisí yẹn yí padà pada, fún ọjọ́ 30, níwọ̀n bí kò ti sí ìfisí tí ó tẹ̀lé e tí ó yí ìbáṣepọ̀ kan náà padà. Ẹ padà sẹ́yìn lórí èyí tó kẹ́yìn kọ́kọ́.

Fi kún àti yí padà, tàbí jẹ́ kí ó bá faili mu gangan

Ṣáájú gbígbé sókè, ẹ yan ohun tí yóò ṣẹlẹ̀ sí àwọn nǹkan tí faili kò ṣe àkójọ wọn:

  • Fi kún àti yí padà (àṣàyàn àtilẹ̀wá): àwọn ìlà inú faili ni a ṣẹ̀dá tàbí yí padà, ohun gbogbo mìíràn wà bí ó ṣe wà. Faili tí ó ní ìlà márùn-ún nìkan yóò yí àwọn nǹkan márùn-ún yẹn padà.
  • Jẹ́ kí ó bá faili mu gangan: ohunkóhun irú kan náà tí faili kò ṣe àkójọ rẹ̀ ni a ó yọ kúrò. Ọjà kan ni a ó fi pamọ́ (archive), kì í ṣe pa rẹ̀ rárá. Ìṣàyẹ̀wò ń ṣe àkójọ gbogbo ìyọkúrò ṣáájú kí ẹ tó fi sí ìṣe.

Dàkọ sí nọ́mbà mìíràn

Tí ẹ bá jẹ́ ẹni tó ni tàbí alákòóso nọ́mbà ju ọ̀kan lọ, Copy to another number ń dàkọ ìṣètò ìbáṣepọ̀ kan láti nọ́mbà tí ẹ wà lórí sí nọ́mbà mìíràn: ẹ̀ka kejì, nọ́mbà ìdánwò, tàbí àwòṣe tí ẹ fún gbogbo ṣọ́ọ̀bù tuntun.

Ìdàkọ náà ni a kọ́kọ́ ṣàyẹ̀wò lórí nọ́mbà mìíràn, ó sì fihàn ohun tí yóò yí padà níbẹ̀. Copy now ń fi sí ìṣe. Àwòrán yóò tẹ̀lé e. Láti padà sẹ́yìn lórí ìdàkọ, ṣí ìbáṣepọ̀ kan náà lórí nọ́mbà mìíràn: ìdàkọ náà wà níbẹ̀ lábẹ́ Recent changes.

Note

Àdírẹ́sì wẹ́ẹ̀bù ti Book-and-Pay, Order-and-Pay àti Tickets-and-Pay jẹ́ ti nọ́mbà kan ṣoṣo, a kò sì ní dàkọ ẹ́ rárá. Ẹ ṣètò àdírẹ́sì nọ́mbà mìíràn nínú dashboard rẹ̀ fúnra rẹ̀.

Ohun tí faili ìṣètò ní

Ìbáṣepọ̀Àwọn ìlà
Book-and-Paybooking.settings (ìlà kan fún apá kọ̀ọ̀kan: wákàtí, wẹ́ẹ̀bù, brand, ìfiránṣẹ́ ...), booking.service, booking.provider (òṣìṣẹ́)
Order-and-Payshop.settings (ìlà kan fún apá kọ̀ọ̀kan, pẹ̀lú ìrísí ojú-ìwé ìpaṣẹ), shop.category, shop.option_group, shop.item (pẹ̀lú variants àti àwòrán)
Tickets-and-Paytickets.settings (ìlà kan fún apá kọ̀ọ̀kan; wa_templates ni ọ̀rọ̀ tiyín fún àwọn ìfiránṣẹ́ WhatsApp), tickets.chart (àwọn ètò ijoko tí a fipamọ́), tickets.event (pẹ̀lú àwọn ọjọ́, irú tikẹ́ẹ̀tì, ààlà pínpín, àwòrán àti ètò ijoko), tickets.promo
Submit-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Gbogboasset: àwòrán kan, tí àwọn ìlà tó ń lò ó dárúkọ rẹ̀

Kì í sí nínú faili rárá

  • Àṣírí: kọ́kọ́rọ́ ìsanwó, ọ̀rọ̀ aṣínà ìsopọ̀ àti tokens. Àṣírí tí a ti fipamọ́ yóò wà bí ó ṣe wà.
  • Títan ìbáṣepọ̀ kan. Faili kì í ṣe bẹ́ẹ̀ rárá, faili kì í sì í tẹ̀jáde, fagilee tàbí pa ìṣẹ̀lẹ̀ tí a ti ta tikẹ́ẹ̀tì fún.
  • Ohun tí àwọn oníbàárà ṣe: àwọn ìwọlé, ìpaṣẹ, tikẹ́ẹ̀tì tí a ti tà, àwọn ìfisílẹ̀ fọ́ọ̀mù, oníbàárà àti ìsanwó.
  • Àwọn ọmọ ẹgbẹ́ ti ẹgbẹ́ yín àti ìwọlé àwọn òṣìṣẹ́.
  • Iye ọjà ti Order-and-Pay, àyàfi tí ẹ bá ṣàmì sí Also set the stock figures from the file. Láìsí rẹ̀, faili tí ẹ kó jáde ní òwúrọ̀ kò lè padà ohun tí a tà ní ọjọ́ náà.

Ìlànà

Faili ìṣètò jẹ́ JSON Lines: ohun JSON kan fún ìlà kọ̀ọ̀kan. Ìlà àkọ́kọ́ sọ ohun tí faili náà jẹ́; ìlà yòókù kọ̀ọ̀kan jẹ́ àkọsílẹ̀ kan pẹ̀lú type àti key. Kọ́kọ́rọ́ náà ń wá àkọsílẹ̀ kan náà padà ní ìgbà tí ó bá yá: id iṣẹ́ kan, SKU ọjà kan, àdírẹ́sì ìṣẹ̀lẹ̀ kan.

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

Ìtòlẹ́sẹẹsẹ àwọn ìlà kò ṣe pàtàkì. Àwọn owó Book-and-Pay jẹ́ iye (25 túmọ̀ sí 25.00, price ni àmì tí a fihàn lẹ́gbẹ̀ẹ́ rẹ̀); àwọn owó Order-and-Pay àti Tickets-and-Pay wà nínú ẹyọ tí ó kéré jùlọ ti owó náà (1250 túmọ̀ sí 12.50). Gbogbo pápá tí ìlà kọ̀ọ̀kan ní wà nínú ìtọ́sọ́nà API (GET /v1/{number}/setup/guide).

Àwòrán

Àkọsílẹ̀ kan ń dárúkọ àwòrán nípasẹ̀ kọ́kọ́rọ́ ìlà asset. Àwòrán wá láti ọ̀kan nínú:

  • url: àdírẹ́sì https:// kan, tí àwa ń gbà.
  • data: àwòrán fúnra rẹ̀, base64.
  • file: ọ̀nà kan nínú .zip tí a gbé sókè.
  • sha256: àwòrán tí nọ́mbà yìí ti ní tẹ́lẹ̀.

Ìkójáde kọ̀ọ̀kan ń kọ àdírẹ́sì gbangba àwòrán kọ̀ọ̀kan. Àwòrán tí kò ní àdírẹ́sì gbangba, bí àwòrán ilẹ̀ lẹ́yìn ètò ijoko, ní ọ̀nà ìsopọ̀ tí a fọwọ́sí tí ó wúlò fún ọjọ́ 7, kí faili tí a dàkọ sí nọ́mbà mìíràn lè gbé e lọ.

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

Àwòrán jẹ́ PNG, JPEG tàbí WEBP, kò tóbi ju 5 MB kọ̀ọ̀kan. Níbi tí ìbáṣepọ̀ kan bá nílò rẹ̀, a máa ń sọ àwòrán di kékeré tàbí yí i padà sí JPEG: logo Book-and-Pay láti bá 300 KB mu, àwòrán Tickets-and-Pay láti bá 1 MB mu.

Fún àwọn agent AI àti API

Agent kan ń ṣètò ìbáṣepọ̀ kíkún nínú ìgbésẹ̀ kan tí a ti ṣàyẹ̀wò, dípò dídá ọ̀pọ̀ ìpè dúró. MCP server https://api.app2email.com/mcp/setup ní àwọn irinṣẹ́ wọ̀nyí: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job àti undo_setup. Àwọn ìpè kan náà wà nínú API:

ÌpèOhun tí ó ń ṣe
GET /v1/{number}/setup/guidegbogbo irú àkọsílẹ̀, àwọn pápá wọn àti ààlà wọn, pẹ̀lú àpẹẹrẹ. Àwọn agent ń kà á kọ́kọ́
GET /v1/{number}/setup/exportfaili lọ́wọ́lọ́wọ́: format=jsonl, zip tàbí json
POST /v1/{number}/setup/checkń ṣàyẹ̀wò faili kan, kò sì yí nǹkan padà: àwọn ìṣòro nípasẹ̀ ìlà, ètò, check_id
POST /v1/{number}/setup/applyń fi ìṣàyẹ̀wò sí ìṣe: {"check_id": 123}
POST /v1/{number}/setup/assetsń fi àwòrán pamọ́ fún ọjọ́ 7, ó sì ń dá sha256 rẹ̀ padà
GET /v1/{number}/setup/jobsàwọn ìṣàyẹ̀wò, ìfisí àti ìpadàsẹ́yìn tuntun jùlọ
POST /v1/{number}/setup/jobs/{id}/undoń dá ohun tí ìfisí kan yí padà pada

Kọ́kọ́rọ́ náà nílò àṣẹ ìbáṣepọ̀ náà fúnra rẹ̀: bookings:manage, orders:manage, tickets:manage tàbí submissions:manage. Kọ́kọ́rọ́ sandbox lè kó faili jáde àti ṣàyẹ̀wò, ṣùgbọ́n kì í fi sí ìṣe.

Tip

Ìlànà tí agent máa ń tẹ̀lé: ka ìtọ́sọ́nà, kó faili lọ́wọ́lọ́wọ́ jáde, yí ìlà díẹ̀ padà, ṣàyẹ̀wò, ṣàtúnṣe ohun tí ìṣàyẹ̀wò fihàn, lẹ́yìn náà béèrè lọ́wọ́ olùlò kí ó tó fi check_id sí ìṣe.

Àwọn ààlà

Kí niÀàlà
Faili kan20 MB ọ̀rọ̀, 50,000 ìlà (nínú dashboard, gbígbé sókè tó pọ̀jùlọ 19 MB)
Ìbéèrè tí àwòrán wà nínú rẹ̀60 MB nípasẹ̀ API
Àwòrán kan5 MB
Àwọn àwòrán tí a gbà láti àdírẹ́sì100 fún gbígbé sókè kọ̀ọ̀kan; Order-and-Pay ń gba àwòrán ọjà ní abẹ́lẹ̀ láàrin ìṣẹ́jú díẹ̀
Àwọn faili ńláàwọn àkọsílẹ̀ tó ju 1,000 lọ ni a ń ṣàyẹ̀wò, a sì ń fi sí ìṣe ní abẹ́lẹ̀; dashboard yóò dúró dè wọ́n fúnra rẹ̀
Ìṣàyẹ̀wòa lè fi sí ìṣe láàrin wákàtí 1, lẹ́ẹ̀kan
Ìpadàsẹ́yìnọjọ́ 30