Bir kurulum dosyası, bir entegrasyonun tüm kurulumunu tek bir metin dosyası olarak tutar. Yedek olarak indirin, birçok şeyi bir seferde değiştirin, bir kurulumu başka bir numaraya kopyalayın ya da bir yapay zeka ajanının her şeyi API veya MCP üzerinden kurmasını sağlayın. Her yükleme önce denetlenir ve geri alınabilir.
Bir kurulum dosyası, bir entegrasyonda kurduğunuz her şeyi tutar: ayarları, Book-and-Pay'in hizmetlerini ve personelini, Order-and-Pay'in kategorilerini, seçeneklerini ve ürünlerini, Tickets-and-Pay'in etkinliklerini, tarihlerini ve bilet türlerini, Submit-Info'nun formlarını ve otomasyonlarını. Tek bir metin dosyasıdır; böylece onu yedek olarak saklayabilir, herhangi bir düzenleyicide değiştirebilir, yeniden yükleyebilir ya da diğer numaralarınızdan birine kopyalayabilirsiniz.
Aynı dosya üç yerde çalışır: panelde, API'de ve yapay zeka ajanları için MCP sunucusunda.
Her entegrasyonun bir Setup file bölümü vardır:
| Entegrasyon | Nerede |
|---|---|
| Book-and-Pay | Overview sekmesi, en altta |
| Order-and-Pay | Import & export sekmesi, en altta |
| Tickets-and-Pay | Settings sekmesi, en altta |
| Submit-Info | Settings sekmesi, en altta |
Bunu yalnızca bir numaranın sahibi ve yöneticileri görür.
Download kurulumu bir .a2e.jsonl dosyası olarak verir. Download with pictures aynı dosyayı ve içinde her resmi barındıran bir .zip verir: olduğu gibi yeniden yükleyebileceğiniz, eksiksiz bir çevrimdışı yedek.
Dosyayı bir metin düzenleyicide açın ve satırları değiştirin, ekleyin ya da kaldırın. Her satır tek bir şeydir: bir hizmet, bir ürün, bir etkinlik. Elektronik tabloya gerek yoktur.
Upload a file önce dosyayı denetler. Henüz hiçbir şey değişmez. Her sorunu satır numarası ve nasıl düzeltileceğiyle birlikte ya da uygulamanın ne yapacağını görürsünüz: kaç şeyin yeni, değişmiş ya da kaldırılmış olduğu ve hangileri.
Apply, denetimin gösterdiği değişiklikleri tam olarak yapar. Bir denetim 1 saat geçerli kalır.
Her uygulama Recent changes by setup file altında listelenir. Undo, o uygulamanın değiştirdiği her şeyi 30 gün boyunca, sonraki hiçbir uygulama aynı entegrasyonu değiştirmediği sürece geri koyar. Önce sonraki uygulamayı geri alın.
Yüklemeden önce, dosyanın listelemediği şeylere ne olacağını seçin:
Birden fazla numaranın sahibi ya da yöneticisiyseniz Copy to another number, bir entegrasyonun kurulumunu bulunduğunuz numaradan başka birine kopyalar: ikinci bir şube, bir test numarası ya da her yeni dükkâna verdiğiniz bir şablon.
Kopya önce diğer numarada denetlenir ve orada neyi değiştireceğini gösterir. Copy now bunu uygular. Resimler de onunla gider. Bir kopyayı geri almak için diğer numarada aynı entegrasyonu açın: kopya orada Recent changes altında listelenir.
Book-and-Pay, Order-and-Pay ve Tickets-and-Pay'in web adresi yalnızca bir numaraya aittir ve asla kopyalanmaz. Diğer numaranın adresini kendi panelinde ayarlayın.
| Entegrasyon | Satırlar |
|---|---|
| Book-and-Pay | booking.settings (bölüm başına bir satır: saatler, web, marka, mesajlar ...), booking.service, booking.provider (personel) |
| Order-and-Pay | shop.settings (bölüm başına bir satır, sipariş sayfasının görünümü dahil), shop.category, shop.option_group, shop.item (varyantlar ve resimlerle) |
| Tickets-and-Pay | tickets.settings (bölüm başına bir satır; wa_templates WhatsApp mesajlarının kendi sözcüklerinizle yazılmış halidir), tickets.chart (kayıtlı oturma planları), tickets.event (tarihleri, bilet türleri, paylaşılan limitleri, resimleri ve oturma planıyla), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Hepsi | asset: kullanan satırlar tarafından adlandırılan bir resim |
Bir dosyada asla bulunmayanlar
Bir kurulum dosyası JSON Lines biçimindedir: satır başına bir JSON nesnesi. İlk satır dosyanın ne olduğunu söyler; diğer her satır bir type ve bir key içeren bir kayıttır. Anahtar, aynı kaydı bir dahaki sefere yeniden bulur: bir hizmetin kimliği, bir ürünün SKU'su, bir etkinliğin adresi.
{"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"]}Satırların sırası önemli değildir. Book-and-Pay fiyatları tutarlardır (25 25,00'dir, price yanında gösterilen etikettir); Order-and-Pay ve Tickets-and-Pay fiyatları para biriminin en küçük birimindedir (1250 12,50'dir). Her satırın tam alanları API'nin rehberindedir (GET /v1/{number}/setup/guide).
Bir kayıt, bir resmi bir asset satırının anahtarıyla adlandırır. Resim şunlardan birinden gelir:
url: bizim çektiğimiz bir https:// adresi.data: resmin kendisi, base64.file: yüklenen .zip içindeki bir yol.sha256: bu numaranın zaten sahip olduğu bir resim.Bir dışa aktarma her resmin herkese açık adresini yazar. Bir oturma planının arkasındaki zemin resmi gibi herkese açık adresi olmayan bir resim, 7 gün çalışan imzalı bir bağlantı alır; böylece başka bir numaraya kopyalanan bir dosya onu yine taşır.
{"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"]}Resimler PNG, JPEG ya da WEBP olmalı ve her biri en fazla 5 MB olmalıdır. Bir entegrasyonun gerektirdiği yerde bir resim küçültülür ya da JPEG'e çevrilir: Book-and-Pay logosu 300 KB'a sığacak şekilde, Tickets-and-Pay resmi 1 MB'a sığacak şekilde.
Bir ajan, onlarca çağrı yerine bir entegrasyonun tamamını tek bir denetlenmiş adımda kurar. https://api.app2email.com/mcp/setup MCP sunucusunda şu araçlar vardır: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job ve undo_setup. Aynı çağrılar API'de de vardır:
| Çağrı | Ne yapar |
|---|---|
GET /v1/{number}/setup/guide | her kayıt türü, alanları ve limitleri, örneklerle. Ajanlar önce bunu okur |
GET /v1/{number}/setup/export | güncel dosya: format=jsonl, zip ya da json |
POST /v1/{number}/setup/check | bir dosyayı denetler ve hiçbir şeyi değiştirmez: satıra göre sorunlar, plan, bir check_id |
POST /v1/{number}/setup/apply | bir denetimi uygular: {"check_id": 123} |
POST /v1/{number}/setup/assets | bir resmi 7 gün saklar ve sha256 değerini yanıtlar |
GET /v1/{number}/setup/jobs | son denetimler, uygulamalar ve geri almalar |
POST /v1/{number}/setup/jobs/{id}/undo | bir uygulamanın değiştirdiğini geri koyar |
Anahtarın, entegrasyonun kendi iznine ihtiyacı vardır: bookings:manage, orders:manage, tickets:manage ya da submissions:manage. Bir sandbox anahtarı dışa aktarabilir ve denetleyebilir, ancak uygulayamaz.
Bir ajan için olağan döngü: rehberi okuyun, güncel dosyayı dışa aktarın, birkaç satırı değiştirin, denetleyin, denetimin bildirdiklerini düzeltin, sonra check_id değerini uygulamadan önce kullanıcıya sorun.
| Ne | Limit |
|---|---|
| Bir dosya | 20 MB metin, 50.000 satır (panelde en fazla 19 MB'lık bir yükleme) |
| İçinde resimler olan bir istek | API üzerinden 60 MB |
| Bir resim | 5 MB |
| Adresten çekilen resimler | yükleme başına 100; Order-and-Pay ürün resimlerini arka planda, dakikalar içinde çeker |
| Büyük dosyalar | 1.000'den fazla kayıt arka planda denetlenir ve uygulanır; panel bunları kendiliğinden bekler |
| Bir denetim | 1 saat içinde, bir kez uygulanabilir |
| Geri alma | 30 gün |