פעולת "הקלדה" (sendChatAction) בטלגרם — שיטת אינדיקציה לפעילות בוט המציגה את הסטטוס "מדפיס" בממשק המשתמש...». זהו מרכיב מפתח ב-UX המסמן ביצוע פעולות ארוכות טווח (יצירת תוכן, אחזור נתונים). שלא כמו הודעות טקסט, הקלדה אינה מעבירה תוכן, אך היא מונעת פסק זמן לבקשה ומגבירה את האמון בבוט.
מהן המגבלות של פעולת " הקלדה..."
1. משך הזמן:
- סטטוס פעיל למשך 5 שניות לכל היותר.
- לפעולות >5 שניות → שלח את הפעולה שוב ושוב.
2. אינטרוולים:
- מינימום מרווח בין בקשות: 1 שני.
3. תאימות:
- לא עובד בערוצים (צ ' אטים/קבוצות בלבד).
שגיאות פופולריות בעת שליחת פעולת " הקלדה..."
400 בקשה גרועה: צ ' אט לא נמצא
- סיבה: chat_id שגוי או בוט לא נכלל בצ ' אט.
- פתרון: בדוק את הרלוונטיות של chat_id באמצעות getUpdates.
403 אסור: בוט נחסם על ידי המשתמש
- פתרון: דורש נעילת בוט על ידי המשתמש.
400 בקשה גרועה: סוג פעולה לא חוקי
- סיבה: צוין פעולה שאינה קיימת (למשל ` "thinking"`).
- פתרון: השתמש רק [פעולות רשמיות] (https://core.telegram.org/bots/api#sendchataction).
429 יותר מדי בקשות
- סיבה: בקשות תכופות (>30 / sec).
מידע
מידע טכני עבור"API BOT-MARKET"
- - קוד סוג פעולה (`actionType`): "11" (עבור 'הקלדה').
- תדירות בקשות:
קבוצות: 20 בקשות / שנייה,
אישיים צ ' אטים: 5 בקשות לשנייה.
