עבודה עם התראה על הקלדת הודעות#

שליחת התראות על הקלדת הודעות – פונקציה שימושית לחיקוי תקשורת חיה בצ'אט. בשירות GREEN-API קיימות הגדרה ידנית ואוטומטית לשליחת התראות. ההגדרה האוטומטית נקבעת פעם אחת בהגדרות המופע, ולאחר מכן מחשבת אוטומטית את השהייה עבור כל הודעה טקסט יוצאת.
הגדרות ידניות יש לקבוע ישירות עבור כל הודעה טקסט יוצאת בנפרד.

שליחת הודעות עם הגדרה ידנית של התראת הקלדה#

1. שליחת התראה על הקלדת הודעה באמצעות שיטת השירות SendTyping

   השיטה משמשת להעברת התראה על הקלדת טקסט או הקלטת קול בצ'אט. זמן ההתראה בצ'אט מוגבל לטווח שבין 1 ל-20 שניות.
   שיטה זו אינה שולחת שום הודעה לצ'אט.

2. שליחת התראה על הקלדת הודעה באמצעות שיטת שליחת ההודעות SendMessage

   יש למלא את השדה האופציונלי typingTime, בציון ערך מספרי בין 1000 ל-20000 אלפיות שנייה.
   בעת שליחת הודעות ניתן לקבוע ערכים עבור זמן הקלדת הטקסט. זמן ההתראה בצ'אט מוגבל לערכים שבין 1000 ל-20000 אלפיות שנייה (שנייה אחת עד 20 שניות).

שליחת הודעות עם התראה אוטומטית על הקלדה במופע#

כדי לעבוד עם התראות הקלדה במופע, יש להפעיל את ההגדרה autoTyping (ברירת המחדל – ההגדרה כבויה).

ניתן להפעיל את ההגדרה באמצעות:

• חשבון אישי, בהגדרות המופע, תוך ציון ערכים מ-1 עד 4, כאשר הערך 0 מכבה את ההגדרה.

• שיטת SetSettings, ציין ערך בין 1 ל-4. כאשר הערך הוא 0, ההגדרה מבוטלת:

      "autoTyping": 2
  

• בשיטת השותף CreateInstance, בעת יצירת מופע ציין ערך בין 1 ל-4. כאשר הערך הוא 0, ההגדרה מבוטלת:

      "autoTyping": 2
  

כיצד לנהל את הגדרת שליחת ההתראה האוטומטית על הקלדה#

חישוב זמן התצוגה של ההתראה על הקלדת הודעה לפני השליחה תלוי באורך הטקסט ובערך הפרמטר autoTyping.

הפרמטר autoTyping שולט בחיקוי מהירות הקלדת ההודעה ויכול לקבל את הערכים הבאים:

• 0 – חיקוי אוטומטי של הקלדה כבוי (התראת הקלדת טקסט לא נשלחת)
• 1 - מהירות הקלדת ההודעה – 5 תווים בשנייה
• 2 - מהירות הקלדת ההודעה – 10 תווים בשנייה. אנחנו ממליצים להשתמש בערך זה
• 3 - מהירות הקלדת ההודעה – 15 תווים בשנייה
• 4 - מהירות הקלדת ההודעה – 20 תווים בשנייה
• 5 - מהירות הקלדת ההודעה – 25 תווים בשנייה. ערכים 5 ומעלה אינם זמינים בהגדרה מהחשבון האישי
• 6 - מהירות הקלדת ההודעה – 30 תווים בשנייה
• 7 - מהירות הקלדת ההודעה – 35 תווים בשנייה
• 8 - מהירות הקלדת ההודעה – 40 תווים בשנייה
• 9 - מהירות הקלדת ההודעה – 45 תווים בשנייה
• 10 - מהירות הקלדת ההודעה – 50 תווים בשנייה
• ערכים גדולים מ-10 – מהירות הקלדת ההודעה תהיה שווה ל-50 תווים בשנייה

זמן תצוגת ההקלדה מחושב לפי הנוסחה:

typingTime = (textLength / (autoTyping × 5)) × 1000, כאשר:

• autoTyping – מהירות הקלדת ההודעה
• textLength – אורך הטקסט מ-0 עד 4096 תווים
• typingTime – זמן הקלדת הטקסט

זמן מקסימלי להצגת סטטוס הקלדה – 20000 אלפיות השנייה

לדוגמה, אם אתה שולח טקסט של שלושה תווים, זמן הצגת ההתראה יהיה 500 אלפיות השנייה.

עבור טקסטים ארוכים, אם זמן ההקלדה לפי הנוסחה יהיה יותר מ-20000 אלפיות השנייה, הסטטוס בכל זאת יוצג 20000 אלפיות השנייה.