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.
Ìbáṣepọ̀ kọ̀ọ̀kan ní apá Setup file:
| Ìbáṣepọ̀ | Ibo |
|---|---|
| Book-and-Pay | tab Overview, ní ìsàlẹ̀ |
| Order-and-Pay | tab Import & export, ní ìsàlẹ̀ |
| Tickets-and-Pay | tab Settings, ní ìsàlẹ̀ |
| Submit-Info | tab Settings, ní ìsàlẹ̀ |
Ẹni tó ni nọ́mbà àti àwọn alákòóso rẹ̀ nìkan ni ó ń rí i.
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à.
Ṣí 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.
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.
Apply ń ṣe gangan àwọn àyípadà tí ìṣàyẹ̀wò fihàn. Ìṣàyẹ̀wò wúlò fún wákàtí 1.
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ọ́.
Ṣáájú gbígbé sókè, ẹ yan ohun tí yóò ṣẹlẹ̀ sí àwọn nǹkan tí faili kò ṣe àkójọ wọ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.
À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ẹ̀.
| Ìbáṣepọ̀ | Àwọn ìlà |
|---|---|
| Book-and-Pay | booking.settings (ìlà kan fún apá kọ̀ọ̀kan: wákàtí, wẹ́ẹ̀bù, brand, ìfiránṣẹ́ ...), booking.service, booking.provider (òṣìṣẹ́) |
| Order-and-Pay | shop.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-Pay | tickets.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-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Gbogbo | asset: àwòrán kan, tí àwọn ìlà tó ń lò ó dárúkọ rẹ̀ |
Kì í sí nínú faili rárá
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).
À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.
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/guide | gbogbo 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/export | faili 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.
Ì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.
| Kí ni | Ààlà |
|---|---|
| Faili kan | 20 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 kan | 5 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 |