Magento Entegrasyonu

Magento 2 (Open Source / Adobe Commerce) mağazanızı Conviro’ya bağlayın; chatbot’unuz siparişleri takip edebilsin, iptal ve iadeleri yönetsin ve sohbet içinde ürün sorularını yanıtlasın.

Bağlanmanın iki yolu var ve ikisi de aynı akış yeteneklerini açar:

1. Resmi Conviro eklentisiyle — tek tıklık, otomatik kurulum. Çoğu satıcı için önerilir.
2. Hiç eklenti olmadan — Magento’nun yerleşik REST API’si artı küçük bir widget kod parçası ile manuel kurulum. Üçüncü taraf modül kuramıyorsanız (ya da kurmak istemiyorsanız) bunu kullanın.

> Önemli: Eklenti bir kolaylık katmanıdır, zorunluluk değil. Sipariş takibi, iptal, iade ve ürün arama Conviro sunucusunda Magento’nun yerleşik REST API’si üzerinden çalışır — yani her iki yolda da çalışır. Eklenti yalnızca kurulumu, widget yerleştirmeyi ve olay webhook’larını otomatikleştirir.

Gereksinimler

• Pro plan veya üzeri
• Magento 2.4+ (Open Source / Community veya Adobe Commerce)
• Magento mağazanıza yönetici (admin) erişimi
• Conviro API Anahtarınız (Dashboard -> Settings -> API Keys üzerinden oluşturun)

Yöntem A — Resmi Eklenti ile (Önerilen)

En hızlı yol. Tek alan, tek tık ve her şey sizin için bağlanır.

Kurulum

1. Modülü Composer ile kurun:

composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <YOUR_CONVIRO_API_KEY>
composer require conviro/module-aichat
php bin/magento module:enable Conviro_AiChat
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

(Composer kullanmıyorsanız eklenti ZIP’ini Conviro panelinden indirip yükleyin.)

1. Magento Admin’de Stores -> Configuration -> Conviro -> AI Chat yolunu açın.
2. Conviro API Anahtarınızı yapıştırın ve Save Config’e tıklayın.

Otomatik olarak neler olur

API anahtarını kaydettiğinizde eklenti:

• En az yetki ilkesiyle bir Magento Integration (“Conviro AI Chat”) oluşturur (Sales orders, Catalog products, Customers, Carts) ve bir erişim token’ı üretir.
• Akışların verinizi okuyabilmesi için mağazanızı Conviro’ya kaydeder (mağaza URL’si + token).
• Sohbet widget’ını her vitrin sayfasına otomatik yerleştirir — tema düzenlemesi gerekmez.
• Verinin neredeyse gerçek zamanlı güncel kalması için olay webhook’ları gönderir (sipariş oluşturuldu, sipariş durumu değişti, ürün kaydedildi, müşteri kaydı).
• Gelen/giden olayların doğrulanması için imzalı bir webhook secret saklar.

Hepsi bu kadar — akışlarınız yayında.

Yöntem B — Eklentisiz (Manuel Kurulum)

Modül kurmaya gerek yok. Eklentinin otomatik yaptığını ~5 dakikada elle yaparsınız: bir API token’ı oluşturup widget kod parçasını yapıştırırsınız.

Adım 1 — Magento Integration oluşturun (akışlar için)

1. Magento Admin’de System -> Extensions -> Integrations yolunu açın.
2. Add New Integration’a tıklayın.
3. Bir ad verin (ör. “Conviro”) ve yönetici şifrenizi girin.
4. API sekmesini açın ve şu kaynaklara erişim verin:

• Sales -> Operations -> Orders (sipariş arama, durum, iptal)
• Catalog -> Inventory -> Products (ürün arama)
• Customers -> Customer (müşteri / sipariş sahipliği sorgusu)
• (opsiyonel) İade akışını kullanıyorsanız Sales -> Operations -> Returns

1. Save’e tıklayın, ardından entegrasyonu Activate edin.
2. Aktivasyondan sonra görünen Access Token’ı kopyalayın.

Adım 2 — Conviro’da bağlayın

1. Dashboard -> Settings -> Integrations -> Magento yolunu açın.
2. Mağaza URL’nizi (ör. https://magazaniz.com) ve kopyaladığınız Access Token’ı girin.
3. Connect’e tıklayın. Conviro token’ı doğrular ve e-ticaret akışlarını etkinleştirir.

Adım 3 — Sohbet widget’ını ekleyin

Widget’ı otomatik yerleştirecek bir eklenti olmadığından kod parçasını kendiniz ekleyin. Temanızın kapanış body etiketinden hemen önce yapıştırın veya Google Tag Manager ile yükleyin:

<script src="https://cdn.conviro.io/widget/widget.iife.js"></script>
<script>
  cw('init', { publicKey: 'pk_GENEL_ANAHTARINIZ' });
</script>

Magento’da en temiz yer Content -> Design -> Configuration -> [temanız] -> HTML Head / Footer bölümü ya da bir Miscellaneous HTML alanıdır. GTM de işe yarar ve tema güncellemelerinden etkilenmez.

Her Yöntem Size Ne Sağlar

Özet: Müşteriye dönük tüm akışlar her iki modda da çalışır. Eklentisiz modda yalnızca tek tıklık kurulumdan, otomatik widget yerleştirmeden ve gerçek zamanlı webhook senkronundan vazgeçersiniz — hepsinin basit manuel karşılığı var.

Güvenlik: Sipariş Sahipliği Doğrulaması

Her iki yöntem de sipariş numarası tahminine karşı aynı korumayı içerir. Herhangi bir sipariş ayrıntısını göstermeden önce akış, müşteriden siparişteki e-postayı ister:

1. Müşteri bir sipariş numarası verir.
2. Bot, ödeme sırasında kullanılan e-postayı sorar.
3. Conviro sipariş ayrıntılarını yalnızca e-posta siparişle eşleşirse gösterir.
4. Eşleşmezse bot, sipariş bulunamamış gibi yanıt verir — böylece saldırgan bir sipariş numarasının gerçek olup olmadığını anlayamaz.

Bu, eklentiden bağımsız olarak Conviro sunucusunda, sipariş akışının e-posta doğrulama adımıyla uygulanır. Hazır e-ticaret akış şablonları zaten herhangi bir sorgudan önce e-postayı toplar.

E-Ticaret Akışları

Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce altındaki hazır şablonları kullanın:

• Order Status — sipariş numarası + e-posta ile durum, kargo ve takip bilgisini sorgular.
• Cancel & Refund — sahipliği doğrular, ardından uygun bir siparişi iptal eder.
• Returns & Exchanges — sahipliği doğrular, nedeni alır ve bir RMA başlatır.
• Product Search — ürünleri ad/SKU ile bulup sohbette ayrıntıları paylaşır.

Bunların hepsi Yöntem A veya Yöntem B’deki token’ı kullanarak Magento’nun yerleşik REST API’sini çağırır — özel uç nokta gerekmez.

İpuçları

• Mümkünse eklentiyi kullanın — tüm manuel adımları kaldırır ve veriyi webhook’larla güncel tutar.
• Kilitli mağazalarda, pazaryerlerinde veya güvenlik politikası yeni modüllere izin vermediğinde manuel modu kullanın.
• Entegrasyona yalnızca gerçekten kullandığınız asgari kaynakları verin — İade’yi sonra her zaman ekleyebilirsiniz.
• Order Status akışıyla başlayın; 1 numaralı e-ticaret sorusunu yanıtlar ve bağlantının çalıştığını kanıtlar.
• Bağladıktan sonra bota gerçek bir siparişi (eşleşen e-posta ile) ve gerçek bir ürünü/SKU’yu sorarak test edin.