Elektraweb API Ayarları Nasıl Yapılır?

ElektraWeb, Türkiye pazarında yaygın kullanılan bir PMS. Hotel WD ile bağladığınızda rezervasyon ve iptaller PMS'e otomatik push edilir, ElektraWeb tarafında oluşan rezervasyonlar webhook üzerinden Hotel WD'ye düşer. Bu kılavuz, ElektraWeb hesabınızı Hotel WD'ye nasıl doğru sırayla bağlayacağınızı, hangi alanın hangi değerle doldurulacağını ve test'in nasıl yeşile çevrileceğini gösterir.

ElektraWeb entegrasyonu çift yönlü ve canlıdır: outbound (Hotel WD → ElektraWeb) push/cancel/modify akışları JSON REST üzerinden, inbound (ElektraWeb → Hotel WD) rezervasyonlar webhook üzerinden çalışır. Bu yazıdaki adımları tamamlayıp Run Test'te READY aldıktan sonra Connect This PMS ile canlıya alabilirsiniz.

İki tarafta da admin erişiminiz olduğundan emin olun:

İlk üç adım sırasıyla yapılmadan bağlantı butonu aktifleşmez. Hotel WD bunu kasten sıkı tutar — kötü bir konfigürasyonla canlıya geçmek, hatalı oda satışı veya çift rezervasyon demek.

Hotel WD'de oturum açtıktan sonra:

Yönetim → Sistem Bağlantısı → ElektraWeb

Açılan sayfa EW logosu, "ElektraWeb" başlığı ve "JSON EXPORT / WEBHOOK" rozeti ile karşılar. Sağ üstte Connect This PMS butonu vardır ama henüz tıklanabilir değildir. Önce gri kalır ve "Complete Room Mapping First" / "Complete Connection Settings" mesajını gösterir.

Hotel WD ElektraWeb bağlantı sayfası — Overview sekmesi, sağ üstte "Complete Room Mapping First" rozeti ve sarı çerçeveli "Complete Connection Settings" uyarısı

Sayfada dört sekme bulunur:

İlk iş Overview sekmesindeki iki değeri kopyalamak, sonra ElektraWeb'e geçmek.

Overview sekmesinin sağ kutusunda iki kayıt görünür:

ElektraWeb Service Key

Otelinize özel, Hotel WD'nin imzaladığı paylaşımlı sır anahtarı. ElektraWeb webhook çağrılarını imzalarken bu anahtarı kullanır. Hotel WD karşıdan gelen her isteği bu anahtarla doğrular — yanlışsa istek reddedilir.

Kopyala butonuna basın. ElektraWeb'in entegrasyon ekranındaki Yetkilendirme / Authorization alanına yapıştıracaksınız.

Webhook Endpoint

Format şöyledir:

https://www.hotelwd.com/api/webhooks/{otel_id}

ElektraWeb rezervasyon ve iptal olaylarını bu URL'ye POST eder. Kanal yöneticisi → ElektraWeb → Hotel WD trafiğinin tek girişidir.

Kopyala butonuna basın. ElektraWeb'in entegrasyon ekranındaki Webhook URL alanına yapıştıracaksınız.

İki değeri de bir not defterine alın. ElektraWeb panelinde bunları yapıştıracağız.

ElektraWeb'e admin hesabıyla giriş yapın. Yönetim panelinde:

ElektraWeb → Entegrasyonlar → API / Webhook

Bu ekranda dört iş yapacaksınız: yukarıda kopyaladığınız iki değeri yapıştırmak, ve ardından Hotel WD'ye götürmek üzere üç değeri buradan almak.

a. Elektra Uç Nokta URL'si

ElektraWeb'in REST API'sinin temel adresidir. Hotel WD bu URL'ye /ping veya doğrulama isteği atar. Tipik form:

https://api.elektraweb.example.com/ping

Kendi tesisinizin URL'si ElektraWeb panelinde Entegrasyonlar → API uç noktası alanında yazılıdır. Tam URL'yi kopyalayın — https:// ile başlamalı, sonunda yatık çizgi olmamalıdır.

Hesap üyeliğinize göre URL api.elektraweb.com veya farklı bir alt etki alanı olabilir. ElektraWeb destek hattı tesisinize ait doğru URL'yi onaylayabilir.

b. API Anahtarı (Token)

ElektraWeb'in kendi yetkilendirme alanında bulunur:

ElektraWeb → Entegrasyonlar → Yetkilendirme → Token / Anahtar

"Yeni token oluştur" diyebilir veya halihazırda mevcut bir token gösterebilir. Bearer token formatındadır; çoğunlukla 40+ karakterli rastgele bir dizidir.

Bu token'ı kimseyle paylaşmayın. Hotel WD'ye bir kez yapıştırdıktan sonra şifreli olarak saklanır ve panelde bir daha gösterilmez. Token'ı yenilerseniz Hotel WD'ye yeni token'ı tekrar girmeniz gerekir.

c. Elektra Tesis Kodu (Property Code)

Çok mülklü hesaplarda hangi tesisin entegre edileceğini belirten tanımlayıcıdır:

ElektraWeb → Mülk / Tesis Profili → Tesis Kodu

Genellikle ELK-001, ELK-AZURE-PALM gibi kısa bir koddur. Token ile aynı mülk hesabına ait olmalıdır — başka tesisin token'ıyla bu tesisin kodunu karıştırmak en yaygın hatadır.

ElektraWeb panelinde tesis adı altında veya tesis listesinde küçük gri yazıyla yazar. Sayısal bir kod ise tam parantez içinde gösterildiği gibi (boşluksuz) girin.

Hotel WD'ye dönün, Test sekmesine geçin. Üç alan görürsünüz:

Yıldızlı (\*) alanlar zorunludur. Token alanı şifreli işaretlenmiştir; yazdığınız değer maskelenir.

Save Settings butonuna basın. "Provider settings saved" mesajını gördüğünüzde değerler şifreli olarak veritabanına yazılmıştır.

İkinci kez bu sayfaya geldiğinizde token alanı boş görünür ama altında "Stored secret is active" yazısı belirir. Token'ı değiştirmek istemiyorsanız alanı boş bırakmak yeterlidir.

Room Mapping sekmesine geçin. Otelinizdeki her oda tipi için iki değer bekler:

Bu iki değeri ElektraWeb'in eşleşme sayfasından bakın:

ElektraWeb → Entegrasyonlar → Kanal / PMS Eşleşmesi

Hotel WD'deki oda satırlarını birebir ElektraWeb kodlarıyla doldurun. Save Mappings butonuna basın.

Tüm odaların ikisi de dolu olmalı. Bir tane bile boş kalırsa Connect butonu açılmaz. Ekranın üstünde "Mapped: 4 / 5" şeklinde bir sayaç ilerlemenizi gösterir.

Sağlayıcıda kod tamamen sayısal ise (örn. 120), tam parantez veya tırnak içinde değil sadece sayıyı yazın.

Test sekmesine dönüp Run Test butonuna basın. Hotel WD şunları sırayla kontrol eder:

Sağ kutuda sonuç görünür. İki etiket önemlidir:

Sonuç PASS değilse "Origin: Configuration" çoğunlukla 3a / 3b / 3c değerlerinden birinin yanlış kopyalandığını gösterir. ElektraWeb'den yeniden alıp Hotel WD'ye yapıştırın, Save Settings + Run Test'i tekrarlayın.

Test sonucu PASS / READY olduğunda sağ üstteki buton aktifleşir ve "Connect This PMS" yazısına döner. Tıklayın.

Hotel WD son bir doğrulama daha çalıştırır, başarılıysa sayfa yeniden yüklenir ve buton CONNECTED rozeti ile yeşil görünür. Aynı zamanda:

"Complete Connection Settings" mesajı kalmıyor.

Üç zorunlu alanı (URL, token, tesis kodu) doldurup Save Settings'e bastığınızdan emin olun. Token'ı sadece girip kaydetmeden test çalıştırırsanız Hotel WD veritabanında token bulamaz, bağlantı hata döner.

"Origin: Provider Side, Code: AUTH_FAILED"

Token ya yanlış kopyalandı ya da ElektraWeb tarafında iptal edildi/yeniden oluşturuldu. ElektraWeb yetkilendirme ekranından mevcut token'ı tekrar alın.

"Origin: Configuration, Code: INVALID_PROPERTY"

Tesis kodu ve token farklı mülk hesaplarına ait. ElektraWeb'de doğru tesise geçtiğinizden emin olun, kodu ve token'ı birlikte aynı tesisten alın.

Webhook olayları gelmiyor.

ElektraWeb tarafında Webhook URL ve Service Key alanlarını yapıştırdığınızı, ElektraWeb'in bu webhook'u "aktif" olarak işaretlediğinizi doğrulayın. Bazı planlarda webhook'u tetiklemek için ek bir "Aktif" anahtarı vardır.

Token'ı değiştirmek istiyorum.

Test sekmesinde Token alanına yeni değeri yazıp Save Settings'e basın. Hotel WD eski şifreli token'ı silip yenisiyle değiştirir; "Stored secret is active" mesajı yeni değere geçer.

İki tarafın aynı mülk hesabına ait kimlik bilgileriyle eşlendiğini bir kez doğru kurarsanız, gerisini Hotel WD halleder. Test READY dönüyor ve Connect tıklandıysa entegrasyon tamamen canlıdır: Hotel WD'den çıkan her rezervasyon ve iptal ElektraWeb'e push edilir, ElektraWeb tarafında oluşan rezervasyonlar Events sekmesine düşer.

Sorularınız için [email protected] ya da panel sağ alttaki canlı destek baloncuğu.

YAZAR

Tahir Dinç

Turkey•27+ YIL DENEYİM

I have been working in the digital field since 1999. I still hold the position of Digital Marketing Manager at Türk SEM. I have also been involved in tourism-related activities since 2005.

Profili Görüntüle

Hotel WD·Strategy Team