שבעה אירועים, ישירות מהמנוע
הירשמו לכל נקודת קצה בדיוק לאירועים שאתם צריכים — מפסקי ספאם ועד שינויי חברות.
spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.leftכל אירוע נשלח במעטפת JSON קומפקטית: id, type, created_at, group_id ונתוני האירוע — ה-id נשאר יציב לאורך ניסיונות חוזרים, כך שמניעת כפילויות היא חיפוש בודד בקבוצה.
לוח הניסיונות החוזרים, בדיוק כפי שהוא רץ
שישה ניסיונות לאורך כשמונה שעות — מספיק כדי לצלוח דיפלוי, הפעלה מחדש או תקלה מלאה בצד שלכם.
0מיידי+1m+5m+30m+2h+6hניסיון אחרוןמסירה שאפשר לבנות עליה
מסירה לפחות-פעם-אחת
כל אירוע נמסר לפחות פעם אחת. נקודת הקצה שלכם מאשרת עם כל 2xx — כל דבר אחר חוזר לתור הניסיונות החוזרים.
מזהים יציבים למניעת כפילויות
לכל אירוע יש id יציב ששורד ניסיונות חוזרים. מניעת כפילויות בצד שלכם היא חיפוש בודד, לא היוריסטיקה.
בלי נקודות קצה זומבי
נקודת קצה שנכשלת במשך ימים מושבתת אוטומטית — ואתם מקבלים הודעה פרטית בטלגרם במקום פער שקט בנתונים שלכם.
פינג בדיקה
אירוע בדיקה בלחיצה אחת, חתום כמו הדבר האמיתי — אמתו את המטפל שלכם לפני שאירוע אמיתי בודד תלוי בו.
היסטוריה הניתנת לבדיקה
היסטוריית משלוח מלאה לכל נקודת קצה: כל ניסיון, סטטוס וחותמת זמן — ניפוי הבאגים של המקבל שלכם לעולם אינו כרוך בניחושים.
HTTPS בלבד, תמיד חתום
נקודות קצה חייבות להיות כתובות HTTPS ציבוריות, וכל מטען חתום. גם התעבורה וגם המקוריות מכוסות.
אמתו כל משלוח
שלוש שורות בצד שלכם — ואיש אינו יכול לזייף או לשלוח מחדש אירוע.
# X-Telm-Signature: v1=<hex>
expected = hmac_sha256(secret, timestamp + "." + body)
valid = constant_time_eq("v1=" + hex(expected), header)דחפו, אל תשאלו
תשאול API מספר לכם מה קרה כששאלתם; Webhooks מספרים לכם ברגע שזה קורה. רשמו נקודת קצה של HTTPS, בחרו את האירועים שחשובים לכם, ו-Telm מתחילה לדחוף אותם לשרת שלכם כ-JSON — גל ספאם, חסימה, רייד של הצטרפויות — ברגע שהמנוע פועל.
כל משלוח חתום. הכותרת X-Telm-Signature נושאת HMAC-SHA256 של חותמת הזמן והגוף, המחושב בעזרת הסוד של נקודת הקצה שלכם, כך שהשרת שלכם יכול לאמת גם מקוריות וגם טריות בשלוש שורות קוד. המטענים עוברים רק דרך HTTPS.
המסירה מהונדסת לאינטרנט האמיתי, שבו מקבלים נופלים. אירועים נמסרים לפחות-פעם-אחת עם id יציב לצורך מניעת כפילויות; כשלים גוררים ניסיונות חוזרים בלוח זמנים גדל — מיד, ואז אחרי 1 ו-5 דקות, 30 דקות, 2 ו-6 שעות. נקודת קצה שממשיכה להיכשל במשך ימים מושבתת אוטומטית, ואתם מקבלים על כך הודעה בטלגרם במקום פער שקט.
הכול ניתן לבדיקה: שלחו פינג בדיקה לפני העלייה לאוויר, ועיינו בהיסטוריית המשלוח — ניסיון אחר ניסיון, סטטוס אחר סטטוס — בכל פעם שאתם צריכים לנפות באגים בצד שלכם של הצינור.
שאלות נפוצות
כיצד אני מאמת שאירוע באמת הגיע מ-Telm?
כל משלוח נושא כותרת X-Telm-Signature: HMAC-SHA256 של "timestamp.body" המחושב בעזרת הסוד של נקודת הקצה שלכם. חשבו אותו מחדש בצד שלכם, השוו בזמן קבוע, ודחו כל דבר ישן מכמה דקות כדי לשלול שליחות חוזרות.
מה קורה אם השרת שלי מושבת כשאירוע מופעל?
Telm מנסה שוב בלוח זמנים גדל — מיד, ואז אחרי דקה, 5 דקות, 30 דקות, שעתיים ו-6 שעות. כל תגובת 2xx נספרת כמסירה. האירועים נושאים id יציב, כך שניסיון חוזר לעולם אינו הופך לכפילות במערכת שלכם.
האם נקודת קצה תקולה יכולה להציף לנצח?
לא. נקודת קצה שנכשלת בערך עשרים פעמים ברציפות ללא הצלחה במשך שלושה ימים מושבתת אוטומטית, ואתם מקבלים התראה בטלגרם. תקנו את הצד שלכם והפעילו אותה מחדש בלחיצה אחת.
כיצד אני בודק את האינטגרציה שלי לפני העלייה לאוויר?
שלחו פינג בדיקה לכל נקודת קצה ישירות מלוח הבקרה או מה-API — הוא מגיע חתום בדיוק כמו אירוע אמיתי. היסטוריית המשלוח מציגה כל ניסיון עם הסטטוס שלו.
אילו תוכניות כוללות Webhooks?
Webhooks הם חלק מחבילת ה-API המלאה, הכלולה בתוכניות Pro ו-Business.
היכן צוותים משתמשים בזה
סוגי קהילות אמיתיים שבהם התכונה הזו עושה את העבודה הכבדה.
שמור על ערוצי התמיכה נקיים מספאם תוך מתן אפשרות למשתמשים חדשים לשאול שאלות. מצב התמיכה מקל על תהליך ההצטרפות.
ניהול מקצועי לקבוצות חברות וקהילות לקוחות. הגנה חזקה עם יומני ביקורת מפורטים.
הגן על בסיס המעריצים שלך מנוכלים המתחזים אליך. בנה מרחב בטוח לקהילה שלך להתחבר.
תכונות קשורות
גלה עוד דרכים שבהן Telm יכול לעזור לקהילה שלך