Olduğu anda,
sunucunuz bilir
Moderasyon olayları, olduğu anda sunucunuza push'lanır: spam algılamaları, yasaklamalar, katılımlar ve daha fazlası — her teslimat HMAC ile imzalanır, yinelenenler ayıklanır ve uç noktanız onaylayana kadar bir çizelgeye göre yeniden denenir.
- Gerçek zamanlı olaylar
- HMAC imzalı payload'lar
- Teslim edilene kadar yeniden deneme
Yedi olay, doğrudan motordan
Uç nokta başına tam olarak ihtiyaç duyduğunuz olaylara abone olun — spam hükümlerinden üyelik değişikliklerine kadar.
spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.leftHer olay kompakt bir JSON zarfında gelir: id, type, created_at, group_id ve olay verisi — id yeniden denemeler boyunca kararlı kalır, böylece yinelenenleri ayıklamak tek bir küme aramasıdır.
Yeniden deneme çizelgesi, tam çalıştığı gibi
Yaklaşık sekiz saatte altı deneme — kendi tarafınızdaki bir dağıtımı, bir yeniden başlatmayı veya tam bir kesintiyi atlatmaya yeter.
0Anında+1m+5m+30m+2h+6hSon denemeÜzerine inşa edebileceğiniz teslimat
En az bir kez teslimat
Her olay en az bir kez teslim edilir. Uç noktanız herhangi bir 2xx ile onaylar — bunun dışındaki her şey yeniden deneme kuyruğuna geri döner.
Dedup için kararlı id'ler
Her olay, yeniden denemelerden sağ çıkan kararlı bir id'ye sahiptir. Sizin tarafınızda yinelenenleri ayıklamak bir sezgisel değil, tek bir aramadır.
Zombi uç nokta yok
Günlerce başarısız olan bir uç nokta otomatik olarak devre dışı bırakılır — ve verilerinizde sessiz bir boşluk yerine bir Telegram DM'i alırsınız.
Test ping'i
Tek tıkla, gerçeği gibi imzalanan bir test olayı — tek bir gerçek olay ona bağlı hale gelmeden önce handler'ınızı doğrulayın.
İncelenebilir geçmiş
Uç nokta başına tam teslimat geçmişi: her deneme, durum ve zaman damgası — alıcınızı ayıklamak asla tahmin işi içermez.
Yalnızca HTTPS, her zaman imzalı
Uç noktalar herkese açık HTTPS URL'leri olmalıdır ve her payload imzalanır. Hem taşıma hem kaynak kapsanır.
Her teslimatı doğrulayın
Sizin tarafınızda üç satır — ve kimse bir olayı taklit edemez veya yeniden oynatamaz.
# X-Telm-Signature: v1=<hex>
expected = hmac_sha256(secret, timestamp + "." + body)
valid = constant_time_eq("v1=" + hex(expected), header)Yoklama değil, push
Bir API'yi yoklamak size sorduğunuzda ne olduğunu söyler; webhook'lar ise olduğu anda söyler. Bir HTTPS uç noktası kaydedin, önemsediğiniz olayları seçin, Telm bunları JSON olarak sunucunuza push'lamaya başlasın — bir spam dalgası, bir yasaklama, bir katılım baskını — motor harekete geçtiği saniyede.
Her teslimat imzalanır. X-Telm-Signature başlığı, uç noktanızın gizli anahtarıyla hesaplanan, zaman damgası ve gövdenin bir HMAC-SHA256'sını taşır; böylece sunucunuz hem kaynağı hem tazeliği üç satır kodda doğrulayabilir. Payload'lar yalnızca HTTPS üzerinden gider.
Teslimat, alıcıların çöktüğü gerçek internet için tasarlanmıştır. Olaylar, yinelenenleri ayıklamak için kararlı bir id ile en az bir kez teslim edilir; başarısızlıklar büyüyen bir çizelgeyle yeniden denenir — hemen, sonra 1 ve 5 dakika, 30 dakika, 2 ve 6 saat sonra. Günlerce başarısız olmaya devam eden bir uç nokta otomatik olarak devre dışı bırakılır ve sessiz bir boşluk yerine bununla ilgili bir Telegram mesajı alırsınız.
Her şey incelenebilir: yayına almadan önce bir test ping'i gönderin ve teslimat geçmişini gezin — deneme deneme, durum durum — hattın kendi tarafınızı ne zaman ayıklamanız gerekse.
Sık sorulan sorular
Bir olayın gerçekten Telm'den geldiğini nasıl doğrularım?
Her teslimat bir X-Telm-Signature başlığı taşır: uç noktanızın gizli anahtarıyla hesaplanan "timestamp.body" değerinin bir HMAC-SHA256'sı. Bunu kendi tarafınızda yeniden hesaplayın, sabit zamanda karşılaştırın ve tekrar saldırılarını (replay) elemek için birkaç dakikadan eski olan her şeyi reddedin.
Bir olay tetiklendiğinde sunucum kapalıysa ne olur?
Telm büyüyen bir çizelgeyle yeniden dener — hemen, sonra 1 dakika, 5 dakika, 30 dakika, 2 saat ve 6 saat sonra. Herhangi bir 2xx yanıtı teslim edilmiş sayılır. Olaylar kararlı bir id taşır, böylece bir yeniden deneme sisteminizde asla bir kopyaya dönüşmez.
Bozuk bir uç nokta sonsuza kadar sel gibi gönderebilir mi?
Hayır. Üç gün boyunca hiç başarı olmadan arka arkaya yaklaşık yirmi kez başarısız olan bir uç nokta otomatik olarak devre dışı bırakılır ve bir Telegram bildirimi alırsınız. Kendi tarafınızı düzeltin ve tek tıkla yeniden etkinleştirin.
Yayına almadan önce entegrasyonumu nasıl test ederim?
Panodan veya API'den doğrudan herhangi bir uç noktaya bir test ping'i gönderin — tıpkı gerçek bir olay gibi imzalı gelir. Teslimat geçmişi her denemeyi durumuyla birlikte gösterir.
Hangi planlar webhook içerir?
Webhook'lar tam API paketinin bir parçasıdır ve Pro ile Business planlarında bulunur.
İlgili özellikler
Telm'un topluluğunuza yardımcı olabileceği diğer yolları keşfedin