Dokümanlar

Kurulum ve entegrasyon rehberleri

WhatsApp numaranızı bağlayın, mağazanızı ekleyin. Kullandığınız platformu soldaki listeden seçip adımları izleyin.

Başlangıç

İki adımda yayına alın

etkileş kurulumu iki bağımsız adımdan oluşur: WhatsApp numaranızı bağlamak ve mağazanızı eklemek. İkisi tamamlandığında otomasyonları açabilirsiniz.

WhatsApp numaranızı bağlayın

Panel > WhatsApp ekranındaki "Meta ile bağlan" düğmesi, sizi Meta'nın resmî Embedded Signup akışına götürür. İşletme numaranız birkaç dakikada bağlanır. Ayrıntı için aşağıdaki WhatsApp'ı bağlama bölümüne bakın.

Mağazanızı bağlayın

Panel > Mağazalar ekranından e-ticaret platformunuzu seçin. Her platformun kendi adımları soldaki listede ayrı ayrı anlatılıyor. Sipariş ve sepet olayları bağlandığı andan itibaren akmaya başlar.

Sipariş bildirimi göndermek için mesaj şablonlarınızın Meta tarafından onaylanmış olması gerekir. Hazır Türkçe şablonları panelden onaya gönderebilir, durumu oradan izleyebilirsiniz.

Embedded Signup

WhatsApp numaranızı bağlama

etkileş, WhatsApp bağlantısını Meta'nın resmî Embedded Signup akışıyla yapar: panelden açılan Meta penceresinde oturum açar, işletmenizi ve numaranızı seçersiniz. API anahtarı kopyalamak veya Meta geliştirici paneliyle uğraşmak gerekmez.

Başlamadan önce hazır olması gerekenler

Bir Meta Business (işletme) hesabı. Yoksa akış içinde oluşturabilirsiniz.
SMS veya sesli arama ile doğrulama kodu alabilen bir telefon numarası.
Numaranın WhatsApp/WhatsApp Business uygulamasında kayıtlı OLMAMASI. Kayıtlıysa önce uygulamadan hesabı silin.
İşletme adınız ve web siteniz gibi temel profil bilgileri.

Bağlantı akışını başlatın

Panel > WhatsApp ekranında "Meta ile bağlan" düğmesine tıklayın. Açılan pencerede Facebook/Meta hesabınızla oturum açın.

İşletme ve numara seçin

Mevcut Meta Business hesabınızı seçin veya yenisini oluşturun. Ardından WhatsApp Business hesabınızı ve bağlamak istediğiniz telefon numarasını belirleyin.

Numarayı doğrulayın

Numaranıza SMS veya sesli arama ile gelen doğrulama kodunu girin. Akış tamamlandığında pencere kapanır ve numaranız panelde "Bağlı" görünür.

Önemli: Cloud API'ye bağlanan numara, WhatsApp uygulamasında aynı anda kullanılamaz. Günlük iletişimde kullandığınız kişisel numaranız yerine mağazanız için ayrı bir numara bağlamanızı öneririz.

İşletmeniz Meta tarafından doğrulanmışsa profilinizde onaylı işletme (yeşil rozet) görünümü desteklenir. Doğrulama başvurusu Meta Business Manager üzerinden yapılır; süreçte yardıma ihtiyaç duyarsanız bize yazın.

Entegrasyon

ikas mağazanızı bağlama

ikas, etkileş'in ilk ve en derin entegrasyonudur. Bağlantı sonrası sipariş oluşturma, kargoya verme, teslim etme ve sepet terk olayları otomatik olarak etkileş'e akar.

Mağaza ekleyin

Panel > Mağazalar > "Mağaza ekle" adımında platform olarak ikas'ı seçin.

API bilgilerinizi oluşturun

ikas yönetim panelinizden bir özel uygulama / API anahtarı oluşturun ve etkileş'in istediği yetkileri (sipariş ve müşteri okuma) verin. Ekrandaki yönerge, ikas panelindeki adımları birebir gösterir.

Bağlantıyı doğrulayın

API bilgilerini etkileş'e yapıştırıp "Bağlan"a tıklayın. etkileş bağlantıyı test eder ve son siparişlerinizi listeleyerek doğrular.

ikas'ta sepet terk olayları anlık webhook ile gelmediği için etkileş sepetleri düzenli aralıkla kontrol eder. Bu yüzden sepet kurtarma mesajı, siparişe göre birkaç dakika gecikmeli tetiklenebilir.

Entegrasyon

WooCommerce mağazanızı bağlama

WooCommerce için ayrı bir eklenti kurmanıza gerek yok. Bağlantı, WooCommerce'in kendi REST API'siyle kurulur: mağazanızda bir API anahtar çifti oluşturur, adresi ve anahtarları panele girersiniz. Sipariş olaylarını dinlemek için gereken webhook kayıtlarını etkileş sizin adınıza otomatik oluşturur.

API anahtarı oluşturun

WooCommerce yönetim panelinizde WooCommerce > Ayarlar > Gelişmiş > REST API sayfasına gidin, "Anahtar ekle" deyin ve izin olarak Okuma/Yazma seçin. Anahtarı oluşturduğunuzda size bir Consumer Key (ck_ ile başlar) ve Consumer Secret (cs_ ile başlar) verilir. Bu ekran değeri bir kez gösterir, kopyalayıp bir yere alın.

Mağazanızı panele ekleyin

Panel > Mağazalar > "Mağaza ekle" adımında WooCommerce'i seçin. Sitenizin adresini (örn. https://magazaniz.com) ve az önce aldığınız Consumer Key ile Consumer Secret değerlerini girin. Adresin https olması gerekir.

Bağlantıyı doğrulayın

"Bağlan"a tıkladığınızda etkileş anahtarları test eder, son siparişinizi çekerek doğrular ve sipariş olaylarını dinleyecek webhook'ları mağazanıza otomatik kaydeder. Bundan sonra sipariş durumundaki her değişiklik etkileş'e akmaya başlar. Webhook'ları elle eklemenize gerek yok.

Sepet terk mesajları için ayrı bir adım gerekir: WooCommerce terk edilen sepetleri kendi API'siyle bildirmediğinden, bu özelliği kullanmak isterseniz küçük etkileş WordPress eklentisini de kurup mağazanızın webhook adresini eklenti ayarına girmeniz gerekir. Eklenti olmadan sipariş ve kargo bildirimleri sorunsuz çalışır, yalnızca sepet kurtarma devrede olmaz.

Entegrasyon

Shopify mağazanızı bağlama

Shopify bağlantısı, mağaza uygulaması üzerinden kurulur. Yetkilendirme ekranını onayladığınızda sipariş ve sepet olayları etkileş'e iletilmeye başlar.

Mağaza ekleyin

Panel > Mağazalar > "Mağaza ekle" adımında Shopify'ı seçin ve mağaza adresinizi (.myshopify.com) girin.

Uygulamayı yetkilendirin

Açılan Shopify ekranında etkileş uygulamasına istenen izinleri verin. Yetkilendirme tamamlanınca Shopify sizi panele geri gönderir.

Bağlantıyı doğrulayın

etkileş bağlantıyı test eder ve son siparişlerinizi listeleyerek doğrular. Bundan sonra oluşan siparişler otomasyonları tetikler.

Entegrasyon

Ticimax mağazanızı bağlama

Ticimax bağlantısı, mağaza panelinizden aldığınız API bilgisiyle ve etkileş'in verdiği olay adresini tanımlayarak kurulur.

Mağaza ekleyin

Panel > Mağazalar > "Mağaza ekle" adımında Ticimax'i seçin. etkileş size bu mağazaya özel bir olay adresi verir.

API ve olay adresini tanımlayın

Ticimax yönetim panelinizde web servis / API erişimini açın ve sipariş olaylarını, etkileş'in verdiği olay adresine yönlendirin.

Bağlantıyı doğrulayın

API bilgilerini etkileş'e girip "Bağlan"a tıklayın. etkileş bir deneme olayıyla bağlantıyı doğrular.

Entegrasyon

IdeaSoft mağazanızı bağlama

IdeaSoft bağlantısı, mağaza panelinizden oluşturduğunuz API erişimiyle kurulur. Sipariş olayları etkileş'in olay adresine iletilir.

Mağaza ekleyin

Panel > Mağazalar > "Mağaza ekle" adımında IdeaSoft'u seçin.

API erişimi oluşturun

IdeaSoft yönetim panelinizden API erişimi oluşturun ve sipariş okuma yetkisi verin. Ekrandaki yönerge adımları birebir gösterir.

Bağlantıyı doğrulayın

API bilgilerini etkileş'e yapıştırıp "Bağlan"a tıklayın. etkileş bağlantıyı test eder ve son siparişlerinizi listeleyerek doğrular.

Entegrasyon

T-Soft mağazanızı bağlama

T-Soft bağlantısı, mağaza panelinizin web servis erişimiyle kurulur. Sipariş durumundaki değişiklikler etkileş'in olay adresine iletilir.

Mağaza ekleyin

Panel > Mağazalar > "Mağaza ekle" adımında T-Soft'u seçin. etkileş size bir olay adresi verir.

Web servis erişimini açın

T-Soft yönetim panelinizde web servis kullanıcısı oluşturun ve sipariş olaylarını etkileş'in olay adresine yönlendirin.

Bağlantıyı doğrulayın

Erişim bilgilerini etkileş'e girip "Bağlan"a tıklayın. etkileş bir deneme olayıyla bağlantıyı doğrular.

Entegrasyon

OpenCart mağazanızı bağlama

OpenCart'ın kendi altyapısında sipariş olaylarını dışarı bildiren bir webhook ya da sipariş listeleyen bir API ucu yok. Bu yüzden OpenCart bağlantısı, mağazanıza kurduğunuz etkileş eklentisiyle (OCMOD) çalışır. Eklenti, siparişleri anlık olarak etkileş'e iletir. Bağlantı, ancak eklenti kurulduktan sonra doğrulanabilir.

Eklentiyi kurun ve etkinleştirin

etkileş OpenCart eklenti paketini (etkiles.ocmod.zip) OpenCart yönetim panelinizde Extensions > Installer (Eklentiler > Kurucu) sayfasından yükleyin. Ardından Extensions > Extensions sayfasında filtreyi Modules (Modüller) seçip "Etkileş WhatsApp Bildirimleri" modülünü Install edin. Bu adım gerekli olay kayıtlarını oluşturur; çekirdek dosyalara dokunmaz.

Endpoint ile token'ı girin

Panel > Mağazalar > "Mağaza ekle" adımında OpenCart'ı seçin. etkileş size bir webhook adresi gösterir ve bir token belirlersiniz. OpenCart tarafında, modülün Edit (Düzenle) ekranını açıp Durum'u Etkin yapın, etkileş'in verdiği webhook adresini ve aynı token'ı girip kaydedin. Token'ın iki tarafta birebir aynı olması gerekir.

Bağlantıyı doğrulayın

Panelde mağaza adresinizi (örn. https://magazaniz.com) ve belirlediğiniz token'ı girip "Bağlan"a tıklayın. etkileş eklentinin bağlantı ucunu çağırır; eklenti kurulu ve token doğruysa yeşil sonuç görürsünüz. Ardından bir test siparişi verip siparişin panele düştüğünü doğrulayın.

OpenCart'ta durum adları (Sistem > Yerelleştirme > Sipariş Durumları) mağazaya göre değiştirilebildiğinden, etkileş yaygın varsayılan durumları otomatik eşler. Mağazanızda özel durumlar tanımlıysa eşlemeyi panel > mağaza ayarlarından düzenleyebilirsiniz. Anlık iletime ek olarak etkileş, kaçan olayları yakalamak için düzenli aralıkla yedek senkron da yapar.

Özel altyapı

Genel Webhook / API ile bağlama

Listede olmayan ya da özel geliştirilmiş bir altyapı mı kullanıyorsunuz? İşletme planındaki API erişimiyle sipariş olaylarını doğrudan etkileş'e gönderebilirsiniz. Kendi sunucunuz, her sipariş olayında etkileş'in olay adresine bir istek atar.

Mağaza anahtarınızı alın

Panel > Mağazalar > "Mağaza ekle" adımında "Özel / API" seçeneğini kullanın. etkileş size bu mağazaya özel bir olay adresi ve doğrulama anahtarı verir.

Olayları olay adresine gönderin

Sunucunuz her sipariş olayında aşağıdaki adrese, anahtarı X-Etkiles-Token başlığında göndererek istek atar.

Bağlantıyı doğrulayın

İlk olayı gönderdiğinizde etkileş bunu panelde "Olaylar" altında gösterir. Böylece bağlantının çalıştığını uçtan uca görürsünüz.

Olay adresi kalıbı

Webhook adresi

https://etkiles.com/api/webhooks/<platform>

# Örnekler
https://etkiles.com/api/webhooks/woocommerce
https://etkiles.com/api/webhooks/opencart
https://etkiles.com/api/webhooks/custom

Örnek sipariş olayı

POST /api/webhooks/custom

POST https://etkiles.com/api/webhooks/custom
Content-Type: application/json
X-Etkiles-Token: <panelden aldığınız mağaza anahtarı>

{
  "event": "order.created",
  "order": {
    "id": "2471",
    "status": "created",
    "customer": { "name": "Elif", "phone": "+90 5xx xxx xx xx" },
    "tracking": null
  }
}

Yukarıdaki değerler örnektir. Gerçek anahtarınızı panelden alır, telefon numarasını uluslararası biçimde gönderirsiniz. Desteklenen olay tipleri ve alan adları için entegrasyon ekibimize yazın.

Kurulumda yardıma ihtiyaç duyarsanız entegrasyon ekibimize yazın.

Yardım

Sık sorulan sorular

WhatsApp uygulamasında aktif kullandığım numarayı bağlayabilir miyim?

Bir numara aynı anda hem WhatsApp/WhatsApp Business uygulamasında hem de Cloud API'de kullanılamaz. Uygulamada kayıtlı bir numarayı bağlamak için önce uygulamadan hesabı silmeniz (numara kaydını kaldırmanız) gerekir. Çoğu işletme, mağaza iletişimi için ayrı bir numara kullanmayı tercih eder.

Sabit hat veya sanal numara kullanabilir miyim?

Evet. SMS veya sesli arama ile doğrulama kodu alabilen her numara kullanılabilir; sabit hatlar sesli arama doğrulamasıyla bağlanır.

Şablon onayı ne kadar sürer?

Onay süresi Meta'ya bağlıdır; çoğu şablon kısa sürede sonuçlanır ancak bazı durumlarda inceleme uzayabilir. Onay durumunu panelden takip edebilirsiniz; reddedilen şablonlarda ret gerekçesi gösterilir ve düzenleyip yeniden gönderebilirsiniz.

Bağladığım mağazadaki geçmiş siparişlere mesaj gider mi?

Hayır. Otomasyonlar yalnızca bağlantı kurulduktan sonra oluşan olaylarla tetiklenir. Böylece eski müşterilerinize istemeden mesaj gitmez.

Birden fazla mağazam var; hepsini bağlayabilir miyim?

Evet. Planınızın mağaza limitine kadar mağazayı aynı hesaba bağlayabilirsiniz. Her mağazanın otomasyonları, segmentleri ve raporları ayrı yönetilir.

Listede olmayan bir altyapı kullanıyorum; ne yapabilirim?

İşletme planındaki API erişimiyle sipariş olaylarını doğrudan etkileş'e gönderebilirsiniz. Webhook / API bölümündeki adımları izleyin veya entegrasyon ekibimize yazın.

Aradığınızı bulamadınız mı?

Destek ekibimiz kurulumun her adımında yanınızda.

Destek ekibiyle iletişime geçin