MAX'ta uygulama ve entegrasyon bağlantısı: Hızlı ve hatasız

Kerem Aydın·13 Temmuz 2026·⏱3 dk

MAX'ta entegrasyonları bağlamak için — kuruluşunuzu doğrulayın, bir bot oluşturun, moderasyon sonrası token alın, mini uygulamanın HTTPS URL'sini belirtin ve token/örnek kimliğini CRM veya ödeme servisine yapıştırın. Neredeyse tüm adımlar dakikalar sürer; token moderasyonu 1–2 gün sürebilir.

Bağlantı öncesi hazırlanması gerekenler

  • Kuruluş doğrulaması yapılmış MAX hesabı (bireysel girişimci veya tüzel kişi).
  • "İş Ortakları Platformu" bölümünde bir bot — oluşturun ve kuruluş profiline ekleyin.
  • Mini uygulama URL'si (geçerli sertifikalı https) veya hazır entegrasyon sağlayıcısı (CRM, ödeme servisi).
  • Token almak ve saklamak için geliştirici/yönetici iletişim bilgileri.

Token yalnızca bot moderasyonundan sonra verilir. Geçerli bir token olmadan harici servisler bağlanamaz.

Adım adım bağlantı talimatları

  1. Giriş ve bot seçimi

    • MAX mobil uygulamasını veya web sürümünü açın.
    • "İş Ortakları Platformu"na gidin → mevcut bir botu seçin veya yeni bir tane oluşturun.
  2. Mini uygulama ayarları

    • Bölüm: "Sohbet Botu ve Mini Uygulama" → "Ayarla".
    • Uygulamanın HTTPS URL'sini yapıştırın (yönlendirme olmadan), başlatma düğmesini belirleyin (Aç/Başlat/Oyna).
    • Kaydedin.
  3. Token alma ve yetkilendirme

    • Moderasyondan sonra bot panelinde API token görünür.
    • Harici sağlayıcılar için Örnek Kimliği ve token'ı ayarlarına girin.
    • Yetkilendirme sırasında genellikle botun telefon numarası ve doğrulama kodu gerekir — bu bilgileri sağlayıcı arayüzüne girin.
  4. Test etme

    • Test mesajı gönderin, sohbatten mini uygulamayı açın, test siparişi/ödemesi gerçekleştirin.

Gerçek istatistikleri etkilememek için test botunda veya CRM'in test ortamında test edin.

Popüler entegrasyonlar ve bunların nasıl bağlanacağı

  • CRM (1C, bulut tabanlı CRM): CRM'de "Uygulamalar" → "MAX" bulun → Örnek Kimliği ve token'ı girin → bot numarasıyla onaylayın. Potansiyel müşteri otomatik senkronizasyonunu kontrol edin.
  • Ödemeler (sanal POS, YooKassa, Sberbank): İş ortakları panelinde servisi bağlayın, hakları onaylayın ve webhook'ta ödeme bildirimlerini ayarlayın.
  • Mağazalar/site oluşturucular (Tilda, CMS): Mini uygulama URL'sini yerleştirin; sepet için dönen olayların (order.created, payment.success) loglara doğru şekilde geldiğinden emin olun.
  • E-posta dağıtım servisleri ve webhook'lar (GREEN-API ve benzerleri): Token ve geri çağrı uç noktasını belirtin; JSON formatını ve istek imzasını kontrol edin.

Entegrasyon karşılaştırması

EntegrasyonBağlantı süresiMaliyetÖzellikler
1C/CRM5–10 dkücretsizPotansiyel müşteri otomatik senkronizasyonu
YooKassa3–10 dkişlem başına %Sohbet içinde doğrudan ödemeler
Tilda-bot2–15 dkservis ücretine bağlıHızlı vitrin/sepet
GREEN-API10–20 dkaboneliğe bağlıDağıtımlar ve webhook'lar

Sık karşılaşılan hatalar ve çözümleri

  • Yetkilendirme hatası: Token yanlış veya tek kullanımlık — bot ayarlarında token'ı yeniden oluşturun.
  • Mini uygulama URL'si açılmıyor: HTTPS, SSL sertifikası, yönlendirme olmaması ve Content-Security-Policy'yi kontrol edin.
  • Moderasyon uzadı: Bot kullanım senaryolarının ayrıntılı açıklamasını ve moderasyon için ekran görüntülerini ekleyin.
  • Webhook alınamıyor: Sağlayıcı panelinde istek loglarını açın, IP ve portun erişilebilir olduğundan emin olun.

SSS

  • Bağlantı ne kadar sürer? 5 dakikadan birkaç saate kadar; token moderasyonu 1–2 iş günü sürebilir.
  • Programcılara ihtiyaç var mı? Standart entegrasyonlar (CRM, ödeme sistemleri, site oluşturucular) için genellikle paneldeki ayarlar yeterlidir; özel entegrasyonlar için geliştirici gerekebilir.
  • Entegrasyonun çalıştığını nasıl kontrol ederim? Test siparişi/ödemesi yapın ve bot paneli ile sağlayıcıdaki logları kontrol edin.

Adım adım bağlayın: önce doğrulama ve test botu, ardından tek bir entegrasyon, log kontrolü ve ancak bundan sonra canlı moda geçiş. Bu, müşteri hizmetlerinde hataları ve gecikmeleri en aza indirir.