ในวินาทีที่มันเกิดขึ้น
เซิร์ฟเวอร์ของคุณรู้ทันที
เหตุการณ์การดูแลถูกพุชไปยังเซิร์ฟเวอร์ของคุณในวินาทีที่มันเกิดขึ้น: การตรวจจับสแปม การแบน การเข้าร่วม และอื่น ๆ — ทุกการส่งลงลายเซ็น HMAC กำจัดรายการซ้ำ และลองส่งซ้ำตามตารางจนกว่าปลายทางของคุณจะยืนยัน
- เหตุการณ์แบบเรียลไทม์
- เพย์โหลดลงลายเซ็น HMAC
- ลองส่งซ้ำจนกว่าจะสำเร็จ
เจ็ดเหตุการณ์ ตรงจากเอนจิน
สมัครรับต่อปลายทางตรงกับเหตุการณ์ที่คุณต้องการพอดี — ตั้งแต่คำตัดสินสแปมไปจนถึงการเปลี่ยนแปลงสมาชิก
spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.leftทุกเหตุการณ์ถูกส่งในซอง JSON กะทัดรัด: id, type, created_at, group_id และข้อมูลของเหตุการณ์ — id คงที่ตลอดการลองส่งซ้ำ การกำจัดรายการซ้ำจึงเป็นแค่การค้นหาในเซ็ตเดียว
ตารางการลองส่งซ้ำ ตรงตามที่ทำงานจริง
หกความพยายามในช่วงราวแปดชั่วโมง — เพียงพอที่จะประคองผ่านการดีพลอย การรีสตาร์ต หรือการล่มเต็มรูปแบบที่ฝั่งของคุณ
0ทันที+1m+5m+30m+2h+6hความพยายามสุดท้ายการส่งที่คุณสร้างต่อยอดได้
ส่งแบบอย่างน้อยหนึ่งครั้ง
ทุกเหตุการณ์ถูกส่งอย่างน้อยหนึ่งครั้ง ปลายทางของคุณยืนยันด้วย 2xx ใด ๆ — อย่างอื่นจะถูกส่งกลับเข้าคิวลองส่งซ้ำ
id คงที่สำหรับกำจัดรายการซ้ำ
ทุกเหตุการณ์มี id คงที่ที่คงอยู่ตลอดการลองส่งซ้ำ การกำจัดรายการซ้ำที่ฝั่งของคุณเป็นแค่การค้นหาครั้งเดียว ไม่ใช่การเดา
ไม่มีปลายทางซอมบี้
ปลายทางที่ล้มเหลวหลายวันจะถูกปิดใช้งานโดยอัตโนมัติ — และคุณจะได้รับ DM ทาง Telegram แทนที่จะเป็นช่องว่างที่เงียบหายในข้อมูลของคุณ
Ping ทดสอบ
เหตุการณ์ทดสอบด้วยคลิกเดียว ลงลายเซ็นเหมือนของจริง — ยืนยันตัวจัดการของคุณก่อนที่เหตุการณ์จริงสักรายการจะพึ่งพามัน
ประวัติที่ตรวจสอบได้
ประวัติการส่งเต็มรูปแบบต่อปลายทาง: ทุกความพยายาม สถานะ และ timestamp — การดีบักตัวรับของคุณไม่ต้องอาศัยการเดา
HTTPS เท่านั้น ลงลายเซ็นเสมอ
ปลายทางต้องเป็น URL HTTPS สาธารณะ และทุกเพย์โหลดลงลายเซ็น ทั้งการรับส่งและแหล่งที่มาได้รับการดูแลครบ
ยืนยันทุกการส่ง
สามบรรทัดที่ฝั่งของคุณ — และไม่มีใครปลอมหรือรีเพลย์เหตุการณ์ได้
# X-Telm-Signature: v1=<hex>
expected = hmac_sha256(secret, timestamp + "." + body)
valid = constant_time_eq("v1=" + hex(expected), header)พุช อย่ามัวพอล
การพอลลิง API บอกคุณว่าเกิดอะไรขึ้นตอนที่คุณถาม ส่วน webhook บอกคุณทันทีที่มันเกิดขึ้น ลงทะเบียนปลายทาง HTTPS เลือกเหตุการณ์ที่คุณสนใจ แล้ว Telm จะเริ่มพุชมันไปยังเซิร์ฟเวอร์ของคุณเป็น JSON — คลื่นสแปม การแบน หรือการเข้าร่วมแบบจู่โจม — ในวินาทีที่เอนจินลงมือทำ
ทุกการส่งมีลายเซ็น เฮดเดอร์ X-Telm-Signature บรรจุ HMAC-SHA256 ของ timestamp และ body ที่คำนวณด้วย secret ของปลายทางคุณ เซิร์ฟเวอร์ของคุณจึงยืนยันได้ทั้งแหล่งที่มาและความสดใหม่ในโค้ดสามบรรทัด เพย์โหลดเดินทางผ่าน HTTPS เท่านั้น
การส่งถูกออกแบบมาเพื่ออินเทอร์เน็ตจริง ที่ผู้รับอาจล่มได้ เหตุการณ์ถูกส่งแบบอย่างน้อยหนึ่งครั้ง (at-least-once) พร้อม id ที่คงที่สำหรับการกำจัดรายการซ้ำ เมื่อล้มเหลวจะลองส่งซ้ำตามตารางที่ขยายขึ้นเรื่อย ๆ — ทันที จากนั้น +1m และ +5m, +30m, +2h และ +6h ปลายทางที่ล้มเหลวต่อเนื่องหลายวันจะถูกปิดใช้งานโดยอัตโนมัติ และคุณจะได้รับข้อความ Telegram แจ้งเรื่องนี้ แทนที่จะเป็นช่องว่างที่เงียบหาย
ทุกอย่างตรวจสอบได้: ส่ง ping ทดสอบก่อนใช้งานจริง และดูประวัติการส่ง — ทีละความพยายาม ทีละสถานะ — เมื่อไรก็ตามที่คุณต้องดีบักฝั่งของคุณ
คำถามที่พบบ่อย
จะยืนยันได้อย่างไรว่าเหตุการณ์มาจาก Telm จริง ๆ?
ทุกการส่งมีเฮดเดอร์ X-Telm-Signature: HMAC-SHA256 ของ "timestamp.body" ที่คำนวณด้วย secret ของปลายทางคุณ คำนวณซ้ำที่ฝั่งของคุณ เปรียบเทียบแบบ constant time และปฏิเสธสิ่งที่เก่ากว่าไม่กี่นาทีเพื่อกันการรีเพลย์
จะเกิดอะไรขึ้นถ้าเซิร์ฟเวอร์ของฉันล่มตอนที่เหตุการณ์เกิดขึ้น?
Telm จะลองส่งซ้ำตามตารางที่ขยายขึ้นเรื่อย ๆ — ทันที จากนั้นหลัง 1 นาที, 5 นาที, 30 นาที, 2 ชั่วโมง และ 6 ชั่วโมง การตอบกลับ 2xx ใด ๆ นับว่าส่งสำเร็จ เหตุการณ์มี id ที่คงที่ การลองส่งซ้ำจึงไม่กลายเป็นรายการซ้ำในระบบของคุณ
ปลายทางที่เสียจะส่งท่วมได้ตลอดไปไหม?
ไม่ ปลายทางที่ล้มเหลวราวยี่สิบครั้งติดต่อกันโดยไม่สำเร็จเลยเป็นเวลาสามวันจะถูกปิดใช้งานโดยอัตโนมัติ และคุณจะได้รับการแจ้งเตือนทาง Telegram แก้ไขฝั่งของคุณแล้วเปิดใช้งานใหม่ได้ด้วยคลิกเดียว
จะทดสอบการเชื่อมต่อก่อนใช้งานจริงได้อย่างไร?
ส่ง ping ทดสอบไปยังปลายทางใดก็ได้จากแดชบอร์ดหรือ API โดยตรง — มันจะมาถึงพร้อมลายเซ็นเหมือนเหตุการณ์จริงทุกประการ ประวัติการส่งจะแสดงทุกความพยายามพร้อมสถานะ
แพ็กเกจใดบ้างที่รวม webhook?
Webhook เป็นส่วนหนึ่งของแพ็กเกจ API เต็มรูปแบบ รวมอยู่ในแพ็กเกจ Pro และ Business
ทีมงานใช้สิ่งนี้ที่ไหน
ประเภทชุมชนจริงที่ฟีเจอร์นี้ทำงานหนัก
ทำให้ช่องทางการสนับสนุนสะอาดจากสแปมในขณะที่อนุญาตให้ผู้ใช้ใหม่ถามคำถาม โหมดสนับสนุนทำให้การเริ่มต้นง่ายขึ้น
การกลั่นกรองระดับมืออาชีพสำหรับกลุ่มบริษัทและชุมชนลูกค้า การป้องกันที่แข็งแกร่งพร้อมบันทึกการตรวจสอบที่ละเอียด
ปกป้องฐานแฟนของคุณจากผู้หลอกลวงที่แอบอ้างเป็นคุณ สร้างพื้นที่ปลอดภัยสำหรับชุมชนของคุณในการเชื่อมต่อ
ฟีเจอร์ที่เกี่ยวข้อง
สำรวจวิธีอื่นๆ ที่ Telm สามารถช่วยชุมชนของคุณได้