Odoo, BOTS4.me’ye Nasıl Bağlanır: Bağlayıcı Kurulum Kılavuzu (Odoo 13–19)

🧭 Önce Yolunuzu Seçin: Odoo’nuz Nerede Çalışıyor?

İki kurulum yolu vardır ve aralarında seçim yapmanızı belirleyen tek şey Odoo barındırma türünüzdür. İkisi de aynı yere çıkar: tek bir bağlantı, Odoo ile çalışan tüm BOTS4.me uygulamalarına hizmet eder.

Hangi barındırmaya sahip olduğunuzdan emin değil misiniz — veya hâlâ mı seçiyorsunuz? Odoo Online, Odoo.sh ve on-premise karşılaştırması: hangisini otomatikleştirebilirsiniz?

Plan notu: Odoo Online, API erişimi için Odoo’nun Custom planını gerektirir; Odoo.sh ve on-premise herhangi bir planda çalışır.

🔌 Yol A: Odoo.sh ve On-Premise — Tek Tıkla Bağlayıcı

• Adım 1 — BOTS4.me hesabınızı oluşturun. bots4.me/bots adresinde kaydolun veya bu adımı atlayıp hesabı 3. Adımda Odoo içinde oluşturun. Ücretsiz başlatılabilen her uygulama daha sonra ücretsiz bir Discovery ayıyla başlar.
• Adım 2 — „BOTS4.me Connect” modülünü yükleyin. apps.odoo.com’da BOTS4.me Connect’i açın, Odoo sürümünüzü (13.0 ile 19.0 arası) seçin ve ücretsiz zip dosyasını indirin; içinde tek bir klasör bulunur: b4m_connect. On-premise: bu klasörü addons yolunuzdaki bir dizine koyun, Odoo hizmetini yeniden başlatın, geliştirici modunu açın, Uygulamalar → Uygulama Listesini Güncelle’yi açın, „BOTS4.me Connect” araması yapın ve Etkinleştir’e tıklayın (eski sürümlerde Yükle). Odoo.sh: klasörü deponuza commit edin (önce bir staging dalında deneyin) ve push edin; derleme yeşil olduğunda modülü o derlemenin veritabanında Uygulamalar’dan yükleyin. Mağazadaki tek uygulamalık modüller (örneğin „Mail2ERP by BOTS4.me”) aynı şekilde yüklenir ve yalnızca kendi uygulamalarını gösterir. Kaynak kod LGPL-3 lisanslıdır; böylece siz veya entegratörünüz yüklemeden önce her satırı okuyabilirsiniz.
• Adım 3 — Bağlantı sihirbazını çalıştırın. Bir Odoo yöneticisi olarak BOTS4.me Connect → Ayarlar yolunu açın ve Bağlan’a tıklayın. „www.bots4.me’de yeni bir hesap oluşturun” (e-postanızı girin; bizi size bir BOTS4.me ortağı önerdiyse, onun kodunu Ortak Kodu alanına yazın) veya „www.bots4.me’de zaten bir hesabım var” (e-posta ve parola) seçeneğini seçin. Ardından e-postanıza veya kullanıyorsanız kimlik doğrulayıcı uygulamanıza gelen 6 haneli kodu girin. Sihirbaz HTTPS üzerinden doğrudan bots4.me ile iletişim kurar; hiçbir kimlik bilgisi üçüncü taraf bir ekrana yazılmaz.
• Adım 4 — Anahtarlar sizin için oluşturulur. Başarılı oturum açmanın ardından BOTS4.me bu Odoo veritabanına özel bir API anahtarı ve bir HMAC imzalama sırrı düzenler ve modül yerel bir teknik kullanıcı, „BOTS4.me Connect”, oluşturur; böylece botlar Odoo kayıtlarını XML-RPC üzerinden asla kişisel yönetici oturumunuzla değil, kendi kimlikleriyle okur ve yazar. Bu kullanıcı yalnızca etkinleştirdiğiniz uygulamaların Odoo haklarını alır. Her dahili kullanıcı gibi, kullanıcı başına Odoo Enterprise aboneliğine dahil sayılır. Odoo 18 ve sonrasında Odoo, API anahtarlarının ne kadar süre geçerli kalacağını sınırlar: modül „API anahtarının süresi yakında doluyor” uyarısını gösterdiğinde Bağlantıyı kes’e, ardından Bağlan’a tıklayın; hiçbir uygulama ayarı kaybolmaz.
• Adım 5 — Kurulum formları önceden doldurulur. Bağlayıcı, BOTS4.me kurulum formlarını önceden doldurmak için Odoo’nuzun meta verilerini (URL, veritabanı UUID’si, şirket fatura bilgileri, IMAP posta sunucusu adresleri) gönderir. Posta parolaları, bir posta kutusunu bir uygulamaya teslim edene kadar — + IMAP postam (1 tık) ile veya e-posta okuyan bir uygulamada Ücretsiz Discovery ayını başlat’a tıklayarak — Odoo’nuzda kalır. Odoo’nuzdan çıkmadan önce şifrelenirler.
• Adım 6 — İlk uygulamanızı etkinleştirin. Uygulamalar altında her uygulama durumunu gösterir (Etkinleştirilmedi, Kurulum gerekli, Aktif, Yapılandırıldı). Bir kez Önce faturalandırmayı tamamlayın’a tıklayın, fatura bilgilerinizi bots4.me’de doldurun, ardından istediğiniz uygulamada Ücretsiz Discovery ayını başlat’a tıklayın. Bu tek tıklama uygulamayı etkinleştirir, bu Odoo’yu ERP’si olarak bağlar ve e-posta okuyan uygulamalar için Odoo IMAP posta kutunuzu teslim eder. Hâlâ eksik olan her şey uygulamada kendi düğmesini alır: + Bu Odoo’yu ERP olarak ekle (1 tık), + IMAP postam (1 tık), + Posta kutusu (Gmail, Microsoft 365) veya + Bulut depolama. Dashboard, Günlükler ve Ayarlar, bots4.me’yi oturum zaten açılmış olarak açar.

☁️ Yol B: Odoo Online — API Anahtarıyla Sıfır Kodlu Kurulum

Odoo Online (odoo.com’daki SaaS sürümü) özel Python modüllerine izin vermez — bu bir platform kuralıdır, BOTS4.me’nin bir kısıtlaması değildir. Bu nedenle Online yolu, sıfır kodlu bir XML yardımcı modülü ile kendinizin oluşturduğu standart bir Odoo API anahtarını kullanır (harici API erişimi Odoo’nun Custom planının bir parçasıdır):

• Adım 1 — BOTS4.me hesabınızı oluşturun, bots4.me/bots adresinde.
• Adım 2 — Bir Odoo API anahtarı oluşturun. Odoo Online veritabanınızda Ayarlar → Kullanıcılar ve Şirketler → Kullanıcılar → kullanıcınız → Hesap Güvenliği’ne gidin (sekme gizliyse geliştirici modunu açın) ve Yeni API Anahtarı’na tıklayın. Ona „BOTS4.me” adını verin, ne kadar süre geçerli kalacağını seçin (Odoo 18 ve sonrası sorar) ve anahtarı kopyalayın; Odoo onu yalnızca bir kez gösterir. Süresi dolmadan önce yenisini oluşturun ve bots4.me’deki aynı Odoo bağlantısına yapıştırın (Düzenle → ERP Hesabını Güncelle).
• Adım 3 — Uygulamayı başlatın ve anahtarı bots4.me’ye yapıştırın. bots4.me/bots adresinde oturum açın, uygulamanın kartında Ücretsiz Discovery ayını başlat düğmesine tıklayın ve Koşulları bir kez kabul edin — kredi kartı gerekmez. Ardından Ayarlar (dişli) → uygulama → Access Manager yolunu açın, Hedef Ekle veya Kaynak Ekle’ye tıklayın (uygulama ihtiyaç duyduğunu gösterir), ERP → Odoo’yu seçin ve Odoo URL’si alanını (https://yourcompany.odoo.com için Veritabanı Adı kendiliğinden dolar), Kullanıcı Adı olarak oturum açma e-postanızı ve Parola veya API Anahtarı alanına API anahtarını doldurun. ERP Hesabı Ekle’ye tıklayın.
• Adım 4 — Sıfır kodlu yardımcıyı ekleyin (isteğe bağlı). apps.odoo.com’daki „BOTS4.me for Odoo Online” modülü yalnızca veri kayıtları içerir, Python içermez; bu nedenle Odoo Online onu kabul eder. Odoo’nuza Bağlan / Dashboard, Kurulum Kılavuzu ve API Anahtarı Nasıl Oluşturulur içeren bir BOTS4.me uygulaması ekler. Botlar her iki durumda da Odoo’nun standart harici API’si üzerinden bağlanır.
• Adım 5 — DEMO’da doğrulayın. Uygulamanın Kontrol sekmesinde Bot Gücü’nü açın ve Mod’u DEMO’da bırakın. İlk çalıştırmadan sonra botun neyi okuduğunu ve neyi yazacağını listeleyen bir DEMO rapor e-postası alırsınız; Günlükler sekmesi her kararı gösterir; Odoo’da hiçbir şey değişmez. DEMO raporları doğru göründüğünde Kontrol sekmesinde Mod ayarını LIVE yapın — bu seçenek ilk DEMO rapor e-postasından sonra açılır.

🧭 Ücretsiz Discovery Ayınızda Deneyin

Ücretsiz başlatılabilen her uygulamanın ilk ayı ücretsiz bir Discovery ayıdır: Personal planının kullanım hakkı, denemeniz için açılan birçok Family ve Business özelliğiyle birlikte ve kredi kartı gerekmeden. „Bağlandı” durumundan Odoo’daki ilk sonuca giden en kısa yol aşağıdadır.

• 1 — Uygulamayı başlatın. Odoo’da (Odoo.sh, on-premise): BOTS4.me Connect → Ayarlar, bir kez Önce faturalandırmayı tamamlayın’a, ardından uygulamada Ücretsiz Discovery ayını başlat’a tıklayın. Odoo Online’da: bots4.me/bots adresinde oturum açın, uygulamanın kartında Ücretsiz Discovery ayını başlat düğmesine tıklayın ve Koşulları bir kez kabul edin — kredi kartı gerekmez. Her iki durumda da Dashboard ardından „Ücretsiz Discovery ayı — N gün kaldı” bilgisini gösterir.
• 2 — Uygulamanın ihtiyaç duyduklarını bağlayın. Odoo’da uygulamayı başlatmak bu Odoo’yu ve Odoo’nuzda bir IMAP posta sunucusu varsa posta kutusunu zaten bağlar. Hâlâ eksik olanlar için + Bu Odoo’yu ERP olarak ekle (1 tık) veya + Posta kutusu (Gmail, Microsoft 365) kullanın. Odoo Online’da Odoo bağlantısını Yol B’de anlatıldığı gibi Access Manager’da, posta kutusunu ise Kaynak Ekle ile ekleyin.
• 3 — DEMO’da çalıştırın. Uygulamanın Kontrol sekmesini (veya Odoo’da Hızlı kontrol) açın, Bot Gücü’nü açın ve Mod’u DEMO’da bırakın. Kontrol sekmesinde Discovery etiketi taşıyan anahtarlar ücretsiz ayınıza dahildir ve kapalı olarak başlar — denemek istediklerinizi açın.
• 4 — Sonucu kontrol edin. İlk çalıştırmadan sonra DEMO rapor e-postasını ve Günlükler sekmesini okuyun: botun okuduğu her belge ve Odoo’da neyi oluşturacağı veya değiştireceği.
• 5 — LIVE’a geçin. DEMO raporları doğru göründüğünde Kontrol sekmesinde Mod ayarını LIVE yapın — bu seçenek ilk DEMO rapor e-postasından sonra açılır. Bot artık kurduğunuz bağlantı üzerinden, Odoo kullanıcısının haklarıyla Odoo’ya yazar.
• 6 — Aydan sonra. Ay sona erdiğinde uygulama kendiliğinden küçük bir aylık kotayla ücretsiz planda devam eder: kota dolduğunda yeni öğeler bir sonraki aya veya bir plan seçene kadar bekler; başlamış bir öğe her zaman tamamlanır. Tüm özellikleri korumak için bir plan seçin — uygulamanın ürün sayfasındaki plan tablosuna bakın.

🔒 Güvenlik Modeli, Dürüstçe Açıklandı

ERP’nize harici bir hizmete erişim veriyorsunuz, bu yüzden sadece bir “banka düzeyinde güvenlik” rozeti değil, somut ayrıntılar talep etmelisiniz. İşte BOTS4.me Connect’in tam olarak nasıl inşa edildiği:

• Sadece HTTPS, sabit kodlanmış. API uç noktası modül kaynağında https://bots4.me olarak sabitlenmiştir — düzenlenebilir bir ayar alanı değildir, bu nedenle güvenliği ihlal edilmiş bir yapılandırma kaydı API trafiğinizi kötü niyetli bir sunucuya yönlendiremez. API tarafından döndürülen her URL, tarayıcınız onu açmadan önce doğrulanır; HTTPS olmayan veya farklı bir ana bilgisayara ait yanıtlar reddedilir.
• HMAC-SHA256 istek imzalama. Modülün BOTS4.me’ye yaptığı her çağrı, veritabanına özel gizli anahtarla imzalanır, böylece istekler taşınma sırasında sahtelenemez veya değiştirilemez.
• Kimlik bilgileri yöneticilerle sınırlıdır. API anahtarı, imzalama parolası ve teknik kullanıcı alanları, Odoo’nun yönetici grubuyla (base.group_system) sınırlı alan düzeyinde erişime sahiptir. Normal iç kullanıcılar launchpad’i ve uygulama durumlarını görebilir, ancak gizli bilgiler çalıştırabilecekleri hiçbir kayıt okumasında görünmez — ve tüm bağlanma/bağlantı kesme/yapılandırma işlemleri yalnızca yöneticilere açıktır.
• Açık kaynak, LGPL-3. Kaynak kodun tamamı apps.odoo.com’dan indirdiğiniz zip dosyasının içinde gelir; böylece entegratörünüz sunucunuzdan tam olarak neyin çıktığını denetleyebilir: formları önceden doldurmak için meta veriler, yalnızca o posta kutusunu bir uygulamaya teslim ettiğinizde bir posta kutusu parolası (çıkmadan önce şifrelenir) ve asla iş belgeleriniz değil.
• Her iki tarafta da denetim izi. Modül, Odoo içinde bağlanmaların, yapılandırma değişikliklerinin ve hataların yerel bir olay günlüğünü tutar; BOTS4.me kontrol paneli ise her çalıştırma için tam karar günlüklerini tutar.
• Otomatik hak yenileme. Zamanlanmış bir cron görevi aboneliklerinizi düzenli olarak yeniden kontrol eder, böylece launchpad’deki uygulama durumları güncel kalır — ve iptal edilen bir uygulama derhal hizmet vermeyi durdurur.

Platform güvenliği ve kademeli erişim hakkında daha fazlası: bots4.me/security ve erişim düzeyleri. Platform AB’de barındırılır, GDPR gözetilerek tasarlanmıştır ve her hesapta 2FA kullanılabilir.

✅ Bağlandıktan Sonra: Tüm Odoo Uygulamaları İçin Tek Bağlantı

Bağlayıcıyı tam olarak bir kez kurarsınız; uygulama başına ek bir kurulum gerekmez. Tek bir bağlantı Odoo ile çalışan her BOTS4.me uygulamasına hizmet eder: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP ve AutoCASH, ayrıca AutoSTOCK, AutoPURCHASE ve ClientFACTORY. AutoSPAM, Mail2CLOUD ve Mail2KNOW yalnızca bir posta kutusuna ihtiyaç duyar; bağlayıcı bunu Odoo’nuzdan tek tıkla aktarabilir. Her uygulamayı ayrı ayrı, Odoo’daki satırından veya bots4.me/bots adresindeki kartından başlatırsınız.

Her uygulama DEMO’da başlar: okur, karar verir ve size bir DEMO raporu e-postayla gönderir, ancak hiçbir şey yazmaz. DEMO raporları doğru göründüğünde Kontrol sekmesinde Mod ayarını LIVE yapın — bu seçenek ilk DEMO rapor e-postasından sonra açılır. bots4.me’de her uygulamanın Kontrol sekmesi Bot Gücü’nü, Mod’u, Yapay Zeka Modu’nu (uygulamaya bağlı olarak Kapalı, Essential AI, Premium AI veya Ultra), uygulamada varsa Çalışma Zamanlaması ve Çalışma Saatleri’ni ve özellik anahtarlarını barındırır. Günlükler sekmesi her kararı gösterir. Odoo’da uygulama satırındaki Hızlı kontrol; Bot Gücü, Çalışma Zamanlaması, Demo Modu ve Yapay Zeka Modu’nu kapsar. Önce neyi otomatikleştireceğiniz için ana kılavuza bakın: Odoo baştan sona nasıl otomatikleştirilir.

📚 İlgili Kılavuzlar

• Buradan başlayın: Odoo’yu uçtan uca nasıl otomatikleştirirsiniz: e-posta siparişinden ödenmiş faturaya
• Barındırma: Odoo Online, Odoo.sh ve on-premise karşılaştırması: hangisini otomatikleştirebilirsiniz?
• Bağlanacak ilk botlar: Import email orders into Odoo · Match bank payments to invoices automatically
• Entegratörler için: Earn recurring revenue as an Odoo partner

🔗 Kaynaklar ve Ek Okumalar

Bu kılavuzda referans verilen resmi belgeler ve standartlar. Harici bağlantılar yeni sekmede açılır.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions