Entegrasyon Rehberi

1. WhatsApp Business API Entegrasyonu

WhatsApp Business API entegrasyonu, müşterilerinizden gelen WhatsApp mesajlarının otomatik olarak siparişe dönüştürülmesini sağlar.

Gerekli Bilgiler

Adım 1: Meta Business Hesabı Oluşturun

1. business.facebook.com adresine gidin.
2. Meta Business hesabınız yoksa yeni bir hesap oluşturun.
3. İşletme doğrulamasını tamamlayın.

Adım 2: Meta Developer Hesabı Oluşturun

1. developers.facebook.com adresine gidin.
2. "Başlayın" butonuna tıklayın ve geliştirici hesabınızı oluşturun.
3. Meta Business hesabınızla ilişkilendirin.

Adım 3: WhatsApp Uygulaması Oluşturun

1. Developer Dashboard'da "Uygulama Oluştur" butonuna tıklayın.
2. Uygulama türü olarak "İşletme" seçin.
3. Uygulama adını girin (örn: "Convord Entegrasyonu").
4. Meta Business hesabınızı seçin ve oluşturun.

Adım 4: WhatsApp Ürününü Ekleyin

1. Uygulamanızın dashboard'unda "Ürün Ekle" bölümüne gidin.
2. "WhatsApp" ürününü bulun ve "Kur" butonuna tıklayın.
3. İlişkilendirilecek Meta Business hesabını onaylayın.

Adım 5: Telefon Numarası ID'sini Alın

1. Sol menüden WhatsApp → Yapılandırma bölümüne gidin.
2. "Telefon Numarası ID" (Phone Number ID) değerini kopyalayın.
3. Bu değeri Convord panelinde "Telefon Numarası ID" alanına yapıştırın.

Adım 6: Erişim Anahtarını (Token) Alın

1. Sol menüden WhatsApp → API Kurulumu bölümüne gidin.
2. "Geçici Erişim Anahtarı" (Temporary Access Token) kısmından token'ı kopyalayın.
3. Bu değeri Convord panelinde "Erişim Anahtarı" alanına yapıştırın.

Adım 7: Webhook Yapılandırması

1. Sol menüden WhatsApp → Yapılandırma bölümüne gidin.
2. "Webhook" kısmında "Düzenle" butonuna tıklayın.
3. Callback URL olarak Convord panelindeki webhook adresini girin:
   https://sizin-domain.com/webhook/whatsapp
4. Doğrulama Anahtarı (Verify Token) olarak .env dosyanızdaki WHATSAPP_VERIFY_TOKEN değerini girin.
5. "Doğrula ve Kaydet" butonuna tıklayın.

Adım 8: Webhook Alanlarına Abone Olun

Webhook yapılandırması altındaki "Webhook Alanları" bölümünde messages alanına abone olun (✓ işareti).

Adım 9: Test Edin

1. WhatsApp numaranıza bir test mesajı gönderin (örn: "2 koli kola, 1 kasa su").
2. Convord panelinde Siparişler bölümünü kontrol edin.
3. Mesajınız otomatik olarak siparişe dönüştürüldüyse entegrasyon başarılıdır!

2. Faturalama / e-Fatura Entegrasyonu

Faturalama Özelliğini Aktifleştirme

1. Entegrasyonlar sayfasında Faturalama bölümündeki toggle'ı açın.
2. Fatura oluşturma yönteminizi seçin:
   • Sistem Faturası: Convord'un kendi PDF şablonuyla fatura oluşturur.
   • Uyumsoft: GİB uyumlu e-Fatura ve e-Arşiv fatura keser.

Genel Fatura Bilgileri

Uyumsoft e-Fatura Kurulumu

1. uyumsoft.com adresinden e-Fatura/e-Arşiv hizmeti satın alın.
2. Hesabınız aktifleştirildikten sonra API erişim bilgilerinizi alın.
3. Fatura oluşturma yöntemi olarak "Uyumsoft" seçin.
4. Uyumsoft tarafından verilen Kullanıcı Adı ve Şifre bilgilerini girin.
5. Kaydet butonuna tıklayın.

3. Telegram Bildirimleri

Telegram entegrasyonu, yeni sipariş ve önemli olaylar hakkında anlık bildirim almanızı sağlar.

Gerekli Bilgiler

Adım 1: Telegram Botu Oluşturun

1. Telegram'da @BotFather botunu arayın ve bir konuşma başlatın.
2. /newbot komutunu gönderin.
3. Botunuza bir isim verin (örn: "Convord Bildirim").
4. Botunuza bir kullanıcı adı verin (örn: convord_notify_bot).
5. BotFather size bir Bot Token verecektir. Bu değeri kopyalayın.

Adım 2: Bot Token'ını Girin

1. Convord panelinde Entegrasyonlar sayfasına gidin.
2. Telegram bölümündeki "Bot Anahtarı" alanına token'ı yapıştırın.

Adım 3: Chat ID'nizi Bulun

Kişisel Chat ID için:

1. Telegram'da @userinfobot veya @RawDataBot botunu arayın.
2. Bota /start gönderin.
3. Size dönen mesajdaki Chat ID değerini kopyalayın.

Grup Chat ID için:

1. Botunuzu bir Telegram grubuna ekleyin.
2. Grupta bir mesaj gönderin.
3. Tarayıcıda şu URL'yi açın:
   https://api.telegram.org/bot<BOT_TOKEN>/getUpdates
4. Dönen JSON'da "chat":{"id":-100XXXXXXXXXX} değerini bulun.

Adım 4: Chat ID'yi Girin ve Test Edin

1. Bulunan Chat ID değerini Convord panelinde "Chat ID" alanına yapıştırın.
2. Kaydet butonuna tıklayın.
3. Yeni bir sipariş oluşturun ve Telegram'dan bildirim gelip gelmediğini kontrol edin.

4. Sorun Giderme

5. Güvenlik Önerileri

• API anahtarlarınızı asla üçüncü kişilerle paylaşmayın.
• WhatsApp kalıcı token kullanıyorsanız, düzenli aralıklarla yenileyin.
• Telegram bot token'ınız ele geçirilirse BotFather'dan /revoke komutuyla iptal edin.
• Uyumsoft API bilgilerinizi güvenli bir ortamda saklayın.
• Platform hesap şifrenizi düzenli olarak değiştirin ve güçlü şifre kullanın.

6. Destek

Entegrasyon kurulumunda yardıma ihtiyacınız olursa:

• E-posta: destek@convord.com
• Telefon: +90 XXX XXX XX XX
• Konu: "Entegrasyon Desteği - [WhatsApp/Telegram/e-Fatura]"