MAX'ta uygulama ve entegrasyon bağlantısı: Hızlı ve hatasız
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ı
-
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.
-
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.
-
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.
-
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ı
| Entegrasyon | Bağlantı süresi | Maliyet | Özellikler |
|---|---|---|---|
| 1C/CRM | 5–10 dk | ücretsiz | Potansiyel müşteri otomatik senkronizasyonu |
| YooKassa | 3–10 dk | işlem başına % | Sohbet içinde doğrudan ödemeler |
| Tilda-bot | 2–15 dk | servis ücretine bağlı | Hızlı vitrin/sepet |
| GREEN-API | 10–20 dk | aboneliğ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.