Başlamadan önce
Aşağıdakilere sahip olduğunuzdan emin olun:
- Tesisin Exely hesabına yönetici erişimi (secure.exely.net.tr veya bölgesel Exely paneli).
- Tesisin bağlı olduğu şirket için Misfora'da Manager veya Admin hesabı.
- Tesisin Exely'deki Property ID'si — daha sonra Misfora'da gerekecek sayısal kimlik.
Exely'de API bağlantısı oluşturma
Bu bölümdeki her şey Exely panelinde gerçekleşir.
API Connections'ı açın
Exely paneline giriş yapın ve API Connections'ı açın.
Yeni bir bağlantı oluşturun
+ Create connection'a tıklayın.
Bağlantıya bir ad verin
Bağlantıya anlaşılır bir ad verin, örneğin:
Alanya Hotel
Anlaşılır bir ad, özellikle aynı Exely tesisi Misfora'da birden fazla şirkete bağlıysa, ileride bağlantıları ayırt etmeyi kolaylaştırır.
PMS API erişimini etkinleştirin
Bağlantıda PMS API erişiminin etkin olduğundan emin olun.
Bazı Exely API bağlantıları kısıtlı izinlerle oluşturulur (örneğin yalnızca Content API). Bu durumda Misfora kimlik doğrulamasını geçebilir ancak rezervasyonları okuyamaz veya güncelleyemez — Misfora'daki Test connection adımı bunu açıkça bildirecektir.
Kaydedin
Bağlantıyı etkinleştirin
Bağlantıyı On konumuna getirin. Devre dışı bağlantılar Misfora'da kimlik doğrulamasından geçemez.
API bilgilerini kopyalayın
Az önce oluşturduğunuz bağlantıyı açın ve şunları kopyalayın:
client_idclient_secret
Her iki değer de Bölüm B'de gerekecek.
Webhook kurulumu
Bir webhook oluşturun
Aynı API bağlantısında Webhooks bölümünü açın ve şunu gösteren yeni bir webhook oluşturun:
https://misfora.com/reservations/webhook/exely
Bu adres tüm Misfora şirketleri ve tesisleri için ortaktır — Misfora gelen istekleri kendisi tanımlar, her tesis için ayrı bir webhook URL'sine gerek yoktur.
Kimlik doğrulama alanını şimdilik boş bırakın
Exely kimlik doğrulama için bir değer isteyecektir (genellikle API-KEY olarak adlandırılır). Bu alanı şimdilik boş bırakın — gerekli değeri Bölüm B, adım 19'da oluşturacak, ardından buraya dönüp Exely'ye yapıştıracaksınız.
Rezervasyon olaylarına abone olun
Webhook'u aşağıdaki tüm olaylara abone edin:
webpms:create_bookingwebpms:update_bookingwebpms:cancel_bookingwebpms:check_in
Olay adları Exely hesapları arasında biraz farklılık gösterebilir — mevcut tüm rezervasyon yaşam döngüsü olaylarına abone olun.
Kaydedin
Misfora'da tesis bağlantısı
Bu bölümdeki her şey Misfora panelinde gerçekleşir.
Misfora'ya giriş yapın
Tesisin bağlı olduğu şirketin Misfora paneline giriş yapın.
Misfora ayarlarını açın
Tesisin Guest Table'ını açın ve üst panelde ⚙ Exely'ye tıklayın.
Misfora Module Settings panelinde:
Property
Şirketin birden fazla tesisi varsa doğru tesisi düzenlediğinizden emin olun.
Tesisin saat dilimi
Tesisin yerel saat dilimini seçin. Exely check-in ve check-out saatlerini saat dilimi belirtmeden gönderir — Misfora bu ayarı kullanarak söz konusu zaman damgalarını doğru şekilde yeniden hesaplar. Yanlış saat dilimi seçilirse rezervasyon saatleri karşılık gelen UTC farkı kadar kayar.
Otomatik doldurma (backfill)
Automatic backfill'i etkin bırakın. Exely her rezervasyon güncellemesi için webhook göndermez — örneğin mevcut bir rezervasyona misafir eklemek webhook tetiklemez. Otomatik doldurma, rezervasyonları periyodik olarak yeniden senkronize ederek bu tür değişikliklerin de Misfora'ya ulaşmasını sağlar.
Property ID'yi girin
Property ID alanına Exely'deki sayısal Property ID'yi girin.
Bu değer gizli değildir — Exely içindeki tesisin yalnızca bir kimliğidir.
API bilgilerini girin
API Connection bölümünde, Bölüm A'daki client_id ve client_secret'ı yapıştırın, ardından Save'e tıklayın.
Webhook secret'ını kopyalayın
Kaydettikten sonra Misfora bir Exely Webhook Secret oluşturacaktır. Copy'ye tıklayın, ardından daha önce Exely'de oluşturduğunuz webhook'a dönün (Bölüm A, adım 9) ve bu değeri API-KEY / Authentication alanına yapıştırın.
Bu secret, Misfora'nın gelen webhook isteklerinin gerçekten sizin Exely hesabınızdan geldiğini doğrulamasını sağlar. Bu olmadan, webhook URL'sini öğrenen herkes sahte rezervasyon olayları gönderebilir.
Misfora webhook secret'ının Exely webhook'unun Key alanına yapıştırılması.
Bağlantıyı test edin
Test connection'a tıklayın. Aşağıdaki sonuçlardan birini göreceksiniz:
client_id ve client_secret'ın doğru kopyalandığını, değerlerin öncesinde veya sonrasında fazladan boşluk olmadığını ve Exely'de API bağlantısının etkin olduğunu kontrol edin.
Entegrasyonu doğrulama
- Test rezervasyonu aktarın. Exely'de bir test rezervasyonu oluşturun (veya mevcut bir tanesini kullanın), ardından bir sonraki otomatik doldurmayı bekleyin veya Misfora'da ⇩ Pull Bookings from PMS'e tıklayarak hemen senkronize edin.
- Aktarılan verileri kontrol edin. Rezervasyonun Guest Table'da doğru misafir adı, check-in tarihi, check-out tarihi, konaklama birimi ve rezervasyon durumuyla göründüğünden emin olun.
Her şey doğru görünüyorsa entegrasyon tamamlanmıştır.
Misfora'nın KBS'de misafir kaydını nasıl otomatikleştirdiğine bakın — KBS'nin ne olduğu, kimin ihtiyacı olduğu ve yukarıdaki check-in süreciyle nasıl bağlantılı olduğu.
Exely API'sinin bilinen sınırlamaları
Aşağıda listelenenler Exely'nin genel API'sinin sınırlamalarıdır, Misfora'nın değil. Bu özellikleri anlamak, günlük kullanımda kafa karışıklığını önlemeye yardımcı olur.
Misafir adları Exely'de neden güncellenmiyor?
Exely'nin genel API'si misafirin adını veya soyadını güncellemek için bir yöntem sunmuyor. Şu anda güncellenebilen misafirle ilgili tek alanlar belge bilgileri (numara, veriliş tarihi, geçerlilik süresi, veren makam) ve doğum ülkesidir.
Bu sınırlama nedeniyle Misfora, düzeltilmiş bir misafir adını hiçbir zaman Exely'ye geri yazamaz — Exely'de saklanan misafir adı her zaman doğru kaynak (source of truth) olarak kabul edilir. Misfora'daki OCR pasaporttan daha doğru bir yazım tanırsa, bu düzeltme yalnızca Misfora içinde kalır ve otomatik olarak Exely'ye yansımaz.
Misafir adını düzeltmek için Exely panelinde manuel olarak güncelleyin. Bu sınırlama Exely'nin API'sinden kaynaklanır ve Misfora tarafında aşılamaz.
Tek bir Exely bağlantısı birden fazla şirket için kullanılabilir mi?
Aynı fiziksel tesis Misfora'da birden fazla şirkete bağlanabilir, ancak her entegrasyonun kendi Exely API bağlantısı, kendi client_id'si, kendi client_secret'ı ve kendi webhook secret'ı olmalıdır.
Misfora, gelen webhook isteklerini her tesisin yalnızca tek bir entegrasyonu olduğu varsayımına göre değil, webhook secret'ına göre tanımlar — Misfora'da birden fazla tesis için aynı API bilgilerini kullanmayın.
Rezervasyonum neden hemen görünmüyor?
Exely webhook yükü yalnızca rezervasyon kimliğini ve Property ID'yi içerir — hiçbir zaman misafir adlarını, iletişim bilgilerini veya pasaport verilerini içermez. Webhook'u aldıktan sonra Misfora, Exely API'si üzerinden tam rezervasyonu otomatik olarak talep eder.
Webhook alındığı sırada Exely geçici olarak erişilemez durumdaysa, rezervasyon verileri bir sonraki otomatik doldurmada veya manuel Pull Bookings from PMS işleminden sonra senkronize edilir.
Exely OAuth token'ları ne kadar süre geçerli?
Exely'deki OAuth erişim token'ları yaklaşık 30 dakika geçerlidir. Misfora bunları arka planda otomatik olarak yeniler, kullanıcıdan herhangi bir işlem gerekmez. Exely API'sini Misfora dışında doğrudan kullanıyorsanız, hata ayıklama veya test yaparken bu geçerlilik süresini göz önünde bulundurun.
Bir misafir check-in tarihinden önce check-in yapabilir mi?
Hayır. Exely, planlanan check-in tarihinden önce bir rezervasyonun check-in yapılmasına izin vermez. Denendiğinde şu şekilde bir hata döner:
Planned check-in date has not yet arrived
Actual and planned check-in dates must match
Bu sınırlamayı Exely getirmektedir. Misafir daha erken gelirse, rezervasyon planlanan check-in tarihine kadar "check-in bekleniyor" durumunda kalır.