Web kancaları
Güncellendi:
Nerede: Ayarlar > Entegrasyonlar > Web kancaları
Ne işe yarar:
"Gelen olayları kendi sunucunuza iletin." SyBox, seçilen her WhatsApp olayının bir kopyasını gerçekleştiği anda sunucunuzdaki bir adrese gönderir. Web kancaları yalnızca WhatsApp numaralarını kapsar. Messenger, Instagram, Telegram, e-posta ve SMS gönderilmez.
Kimler açabilir: Ana yönetici ve "WhatsApp numaralarını yönetin" iznine sahip ekip üyeleri. Bir web kancası oluşturmak veya duraklatılmış bir kancayı tekrar açmak için "Kişi numarasını göster" iznine de ihtiyacınız vardır, çünkü kopyalar müşterilerin gerçek telefon numaralarını içerir.
Seçebileceğiniz olaylar:
- "Gelen mesaj": Bir müşteri mesaj gönderdi.
- "Mesaj durumu": Gönderdiğiniz bir mesaj iletildi, teslim edildi, okundu veya başarısız oldu.
- "Tepki": Bir müşteri bir mesaja tepki verdi.
- "Ses dökümü" (ekstra bir seçenek): Bir sesli not, yazılı metninin de beraberinde gönderilebilmesi için yaklaşık iki dakikaya kadar kısa bir süre bekletilir. Siz açmadığınız sürece kapalıdır.
- Ayarlar > Entegrasyonlar > Web kancaları bölümüne gidin.
- "Web kancası ekle" seçeneğine tıklayın.
- Bir "Ad" girin.
- "Hedef URL"yi girin. "Erişebileceğimiz herkese açık bir https adresi" olmalıdır. Düz http adresleri ile özel veya dahili ağ adresleri reddedilir.
- "Olaylar" altında en az bir olayı açın. "Gelen mesaj" varsayılan olarak açıktır.
- İsteğe bağlı: Sesli notları metinleriyle birlikte almak için "Ses dökümü"nü açın.
- "Numaralar" altında, tüm WhatsApp numaralarını kapsamak için "Tüm numaralar"ı açık bırakın. Ya da kapatıp yalnızca istediğiniz numaraları işaretleyin.
- Kaydet'e tıklayın.
- Açılan pencerede "İmzalama anahtarı" gösterilir. "Şimdi kopyalayın — yalnızca bir kez gösterilir." Sunucunuza kaydedin.
İletimler hakkında:
- Her iletim, Meta'nın kendi WhatsApp web kancalarıyla aynı biçimi kullanır.
- Her iletim, Meta'nın web kancalarını imzaladığı şekilde imzalama anahtarınızla imzalanır. Sunucunuz Meta'nın web kancalarını zaten doğruluyorsa SyBox'ınkileri de SyBox anahtarınızla doğrulayabilir.
- Sunucunuz başarılı bir yanıt vermezse SyBox her seferinde daha uzun süre bekleyerek yaklaşık bir saat boyunca birkaç kez tekrar dener. Ardından o olaydan vazgeçer.
- Aynı olay bazen iki kez gelebilir, örneğin bir zaman aşımından sonra. Sunucunuz yinelenenleri yönetebilmelidir.
- SyBox'ta web kancaları için bir "test gönder" düğmesi yoktur. Test etmek için:
- Web kancasının etkin olduğundan ve kullanacağınız numarayı kapsadığından emin olun.
- Başka bir telefondan o numaraya bir WhatsApp mesajı gönderin.
- Ayarlar > Entegrasyonlar > Web kancaları bölümüne geri dönün. Kart, sunucunuzdan gelen son yanıtı saatiyle birlikte gösterir. Başarılı bir yanıt (örneğin "HTTP 200") yeşil renkte gösterilir. Hata ise kırmızı renkte gösterilir. "Son iletim: hiç", henüz hiçbir şeyin iletilmediği anlamına gelir.
- Adı, adresi, olayları veya numaraları değiştirmek için Düzenle'ye tıklayın.
- İmzalama anahtarını değiştirmek için "İmzalama anahtarı" alanına yenisini yazın. Mevcut anahtarı korumak için boş bırakın ("Mevcut anahtarı korumak için boş bırakın").
- Duraklatmak için Etkinleştir / Devre Dışı Bırak'a tıklayın. Duraklatıldığı sırada gelen olaylar bekletilir. Kısa süre içinde tekrar açarsanız gönderilirler.
- Sil'e tıklayın, ardından "Bu web kancası silinsin mi?" onayını verin.
Kurallar ve mesajlar:
- Ad ve Hedef URL zorunludur ve en az bir olayın açık olması gerekir. Aksi takdirde "Eksik veri" uyarısını görürsünüz.
- Herkese açık https olmayan bir adres "Erişebileceğimiz herkese açık bir https adresi" uyarısıyla reddedilir.
İmzalama anahtarını kaybettim.
Tekrar gösterilemez. Web kancasını düzenleyin, "İmzalama anahtarı" alanına kendinize ait yeni bir anahtar yazın, kaydedin ve sunucunuzda bu yeni anahtarı kullanın.
Web kancam hiçbir şey almıyor.
Şu dört noktayı kontrol edin: (1) Web kancası etkinleştirilmiş mi? (2) En az bir olay seçilmiş mi? (3) Doğru WhatsApp numarasını veya "Tüm numaralar"ı kapsıyor mu? (4) Çalışma alanınızda bağlı bir WhatsApp numarası var mı? Çünkü web kancaları yalnızca WhatsApp olaylarını iletir. Ardından karttaki son iletim sonucuna bakın.
Kartta HTTP 404 veya 500 gibi kırmızı bir hata görünüyor.
SyBox adresinize ulaştı ancak sunucunuz hata yanıtı verdi. Adresi ve sunucunuzun günlüklerini (log) kontrol edin.
Web kancası oluşturamıyorum. İznim olmadığı söyleniyor.
Bir web kancası oluşturmak veya duraklatılmış bir kancayı tekrar açmak için hem "WhatsApp numaralarını yönetin" hem de "Kişi numarasını göster" izinleri gerekir. Yöneticinize danışın.