כיצד לקבל התראה על קריאת הודעה נכנסת בטלפון#

כדי לקבל התראות על כך שהודעה נכנסת נקראה במכשיר המקושר, יש להשתמש באלגוריתם הבא.

תוכן עניינים

הגדרת ההגדרות הנדרשות ב-instance
כיצד לצפות בהתראת הקריאה ב-webhooks וביומנים

1. הגדרת ההגדרות הנדרשות ב-instance#

יש לכבות את ההגדרה markIncomingMessagesReaded באמצעות השיטה SetSettings על ידי הזנת הערך no בשדה markIncomingMessagesReaded, או בחשבון האישי, בהגדרות ה-instance, יש להעביר את השדה "סמן הודעות נכנסות כנקראו" למצב לא
יש להפעיל את ההגדרות incomingWebhook ו-incomingMessageStatusWebhook באמצעות השיטה SetSettings או בחשבון האישי, בהגדרות ה-instance.

2. כיצד לצפות בהתראת הקריאה ב-webhooks וביומנים#

הגדרות והגבלות חובה

ודאו שכל ההגדרות המצוינות בסעיף 1 הוחלו.
בקריאה אחת ניתן לקרוא לכל היותר 100 הודעות נכנסות. אם יש יותר הודעות שלא נקראו, יש להפעיל את השיטה מספר פעמים.
בתגובת השיטה getChats נוסף השדה unreadCount, המציג את מספר ההודעות שלא נקראו בצ׳אט.
בעת שימוש בשיטה readChat ההודעות מסומנות כנקראו ביומן. אם idMessage לא צוין, כל ההודעות בצ׳אט נקראות. אם idMessage צוין, ההודעות נקראות עד ההודעה שצוינה, כולל.

דוגמה להתראה נכנסת#

{
    "typeWebhook": "incomingMessageStatus",
    "chatId": "79876543210@c.us",
    "instanceData": {
        "idInstance": 1234,
        "wid": "79876543210@c.us",
        "typeInstance": "whatsapp"
    },
    "timestamp": 1586700802, // זמן קריאת ההודעה
    "idMessage": "BAE550673B9C04973",
    "status": "read", // ההודעה נקראה
    "sendByApi": false
}

דוגמה ליומן נכנס#

{
        "type": "incoming",
        "idMessage": "BAE550673B9C04973",
        "timestamp": 1713332139,
        "typeMessage": "textMessage",
        "chatId": "79876543210@c.us",
        "textMessage": "אני משתמש ב-GREEN-API.",
        "senderId": "79876543210@c.uss",
        "senderName": "איוון צארביץ׳",
        "senderContactName": "איוון צארביץ׳",
        "isRead": true, // ההודעה נקראה
        "isReadTimestamp": 1713332139
    },
{
        "type": "incoming",
        "idMessage": "BAE550673B9C04973",
        "timestamp": 1713332139,
        "typeMessage": "textMessage",
        "chatId": "79876543210@c.us",
        "textMessage": "אני משתמש ב-GREEN-API.",
        "senderId": "79876543210@c.uss",
        "senderName": "איוון צארביץ׳",
        "senderContactName": "איוון צארביץ׳",
        "isRead": false // ההודעה לא נקראה
    }