app2email API Fiyatlandırma

Belgeler

Kurulum dosyaları

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.

Panelde

Her entegrasyonun bir Setup file bölümü vardır:

EntegrasyonNerede
Book-and-PayOverview sekmesi, en altta
Order-and-PayImport & export sekmesi, en altta
Tickets-and-PaySettings sekmesi, en altta
Submit-InfoSettings sekmesi, en altta

Bunu yalnızca bir numaranın sahibi ve yöneticileri görür.

  1. 1. İndirin

    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.

  2. 2. Değiştirin

    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.

  3. 3. Yükleyin

    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.

  4. 4. Uygulayın

    Apply, denetimin gösterdiği değişiklikleri tam olarak yapar. Bir denetim 1 saat geçerli kalır.

  5. 5. Geri alın

    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.

Ekleyin ve değiştirin ya da tam dosya gibi yapın

Yüklemeden önce, dosyanın listelemediği şeylere ne olacağını seçin:

  • Add and change (varsayılan): dosyadaki satırlar oluşturulur ya da değiştirilir, geri kalan her şey olduğu gibi kalır. Yalnızca beş satırlı bir dosya yalnızca o beş şeyi değiştirir.
  • Make it exactly like the file: dosyanın listelemediği aynı türden her şey kaldırılır. Bir ürün arşivlenir, asla silinmez. Denetim, siz uygulamadan önce her kaldırmayı listeler.

Başka bir numaraya kopyalayın

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.

Note

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.

Bir kurulum dosyası neleri tutar

EntegrasyonSatırlar
Book-and-Paybooking.settings (bölüm başına bir satır: saatler, web, marka, mesajlar ...), booking.service, booking.provider (personel)
Order-and-Payshop.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-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Hepsiasset: kullanan satırlar tarafından adlandırılan bir resim

Bir dosyada asla bulunmayanlar

  • Sırlar: ödeme anahtarları, bağlantı parolaları ve token'lar. Saklanan bir sır olduğu gibi kalır.
  • Bir entegrasyonu açmak. Bir dosya bunu asla yapmaz ve bir dosya biletli bir etkinliği asla yayınlamaz, iptal etmez ya da silmez.
  • Müşterilerin yaptıkları: rezervasyonlar, siparişler, satılan biletler, gönderimler, müşteriler, ödemeler.
  • Ekip üyeleri ve personel girişleri.
  • Also set the stock figures from the file seçeneğini işaretlemediğiniz sürece Order-and-Pay'in stok rakamları. Bu olmadan, sabah dışa aktardığınız bir dosya günün satışlarını geri alamaz.

Biçim

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).

Resimler

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.

Yapay zeka ajanları ve API için

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/guideher kayıt türü, alanları ve limitleri, örneklerle. Ajanlar önce bunu okur
GET /v1/{number}/setup/exportgüncel dosya: format=jsonl, zip ya da json
POST /v1/{number}/setup/checkbir dosyayı denetler ve hiçbir şeyi değiştirmez: satıra göre sorunlar, plan, bir check_id
POST /v1/{number}/setup/applybir denetimi uygular: {"check_id": 123}
POST /v1/{number}/setup/assetsbir resmi 7 gün saklar ve sha256 değerini yanıtlar
GET /v1/{number}/setup/jobsson denetimler, uygulamalar ve geri almalar
POST /v1/{number}/setup/jobs/{id}/undobir 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.

Tip

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.

Limitler

NeLimit
Bir dosya20 MB metin, 50.000 satır (panelde en fazla 19 MB'lık bir yükleme)
İçinde resimler olan bir istekAPI üzerinden 60 MB
Bir resim5 MB
Adresten çekilen resimleryükleme başına 100; Order-and-Pay ürün resimlerini arka planda, dakikalar içinde çeker
Büyük dosyalar1.000'den fazla kayıt arka planda denetlenir ve uygulanır; panel bunları kendiliğinden bekler
Bir denetim1 saat içinde, bir kez uygulanabilir
Geri alma30 gün