Skip to content

LastIncomingMessages#

Test Postman Apidog

השיטה מחזירה את ההודעות הנכנסות האחרונות של החשבון. במצב ברירת המחדל מוחזרות ההודעות הנכנסות למשך 24 שעות.

כדי לקבל הודעות נכנסות, עליך להפעיל את ההגדרה 'קבל חיבורים באינטרנט על הודעות וקבצים נכנסים' באמצעות SetSettings שיטה או דרך console.

ייתכן שיחלפו עד 5 דקות עד שההגדרות ייכנסו לתוקף.

כדי לקבל הודעות שנשלחו והתקבלו בטלפון שלך לפני חיבור המופע, לאחר שמירת ההגדרות במופע, עליך לבצע התנתק and לְאַשֵׁר again.

שיטת LastIncomingMessages מחזירה רק את ההיסטוריה ש-WhatsApp מספקת למערכת.

הופעת ההודעות ביומן עשויה להימשך עד 2 דקות. יש להשתמש בשיטות יומן רק לאחזור היסטוריית הצ'אט. לאחזור מהיר יותר של הודעות, השתמש ב- מערכת הודעות.

בַּקָשָׁה#

כדי לקבל הודעות נכנסות, עליך לבצע בקשה בכתובת:

GET 
{{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}

לפרמטרים של בקשת apiUrl, idInstance ו-apiTokenInstance, עיין ב לפני שמתחילים סָעִיף.

פרמטרים של בקשת כתובת URL#

פָּרָמֶטֶר סוּג הֶכְרֵחִי תֵאוּר
minutes integer לֹא זמן בדקות שעבורו יש להציג את ההודעות (ברירת המחדל היא 1440 דקות)

תְגוּבָה#

פרמטרי תגובה#

מערך אובייקטים עם פרמטרים:

פָּרָמֶטֶר סוּג הֶכְרֵחִי
type string סוג הודעה, incoming - הודעה נכנסת
idMessage string מזהה הודעה נכנסת
timestamp integer זמן קבלת הודעה בפורמט UNIX
typeMessage string סוג הודעה, גרסאות אפשריות:
textMessage -הודעת טקסט
imageMessage - הודעת תמונה
videoMessage - הודעת וידאו
documentMessage - הודעת קובץ מסמך
audioMessage - הודעת שמע
stickerMessage - הודעת מדבקה
reactionMessage - הודעת תגובה
locationMessage - הודעת מיקום
contactMessage - הודעת קשר
extendedTextMessage - קישור והודעה מקדימה
pollMessage - הודעת סקר
pollUpdateMessage - עדכון הודעת סקר
incomingBlock - הודעה על הוספת צ'אט לרשימת אנשי הקשר החסומים (השיטה לא פועלת באופן זמני)
quotedMessage - הודעה מצוטטת
buttonsMessage - הודעת כפתורים (השיטה לא עובדת באופן זמני)
templateMessage - הודעת כפתורי תבנית (השיטה לא עובדת באופן זמני)
listMessage - הודעת לחצן רשימה (השיטה לא עובדת באופן זמני)
buttonsResponseMessage - תגובת כפתורים (השיטה לא עובדת באופן זמני)
templateButtonsReplyMessage - תגובת לחצני תבנית (השיטה לא עובדת באופן זמני)
listResponseMessage - תגובת רשימה (השיטה לא עובדת באופן זמני)
chatId string זיהוי צ'אט, היכן התקבלה ההודעה. כברירת מחדל, לוקח את הערך 10000000000@c.us, if typeMessage = incomingBlock
senderId string שולח הודעה Id. כברירת מחדל, לוקח את הערך 10000000000@c.us, אִם typeMessage = incomingBlock
senderName string שם שולח ההודעה
senderContactName string שם שולח ההודעה בהתאם לרשימת אנשי הקשר של החשבון הנוכחי
isForwarded boolean הדגל מציין אם ההודעה מועברת
forwardingScore integer מספר העברות ההודעות
textMessage string הודעת טקסט, אם typeMessage=textMessage/extendedTextMessage
downloadUrl string קישור להורדת קובץ, אם typeMessage = imageMessage/videoMessage /documentMessage/audioMessage/stickerMessage
caption string כיתוב קובץ, אם typeMessage = imageMessage/videoMessage /documentMessage/audioMessage/stickerMessage
fileName string שם הקובץ, אם typeMessage = imageMessage/videoMessage /documentMessage/audioMessage/stickerMessage. השדה מולא נכון רק עבור typeMessage = documentMessage, במקרים אחרים שם הקובץ נוצר באופן אוטומטי
jpegThumbnail string base64-תצוגה מקדימה של תמונה מקודדת, אם typeMessage = imageMessage /videoMessage/documentMessage/audioMessage/stickerMessage
mimeType string סוג הקובץ לפי סוגי מדיה, אִם typeMessage = imageMessage /videoMessage/documentMessage/audioMessage/stickerMessage
isAnimated boolean הדגל מציין אם הקובץ מונפש, אם typeMessage = imageMessage/videoMessage/documentMessage/audioMessage/stickerMessage
chatState string מצב צ'אט, אם typeMessage = incomingBlock
location object אובייקט מבנה מיקום, אם typeMessage = locationMessage
contact object אובייקט מבנה קשר, אם typeMessage = contactMessage
extendedTextMessage object אובייקט הודעת טקסט (מתקדם), אם typeMessage = extendedTextMessage/quotedMessage
extendedTextMessageData object אובייקט נתוני הודעת תגובה, אם typeMessage = reactionMessage
pollMessageData object אובייקט מבנה נתונים של סקר, אם typeMessage = pollMessage/pollUpdateMessage
quotedMessage object אובייקט נתוני הודעה מצוטט, אם typeMessage = quotedMessage/reactionMessage

פרמטרים של location לְהִתְנַגֵד:

פָּרָמֶטֶר סוּג תֵאוּר
nameLocation string שם המיקום
address string כתובת המיקום
latitude double קו רוחב מיקום
longitude double קו אורך מיקום
jpegThumbnail string base64-תצוגה מקדימה של תמונה מקודדת
isForwarded boolean הדגל מציין אם ההודעה מועברת
forwardingScore integer מספר העברות ההודעות

פרמטרים של contact לְהִתְנַגֵד:

פָּרָמֶטֶר סוּג תֵאוּר
displayName string שם תצוגה של איש קשר
vcard string מבנה VCard (כרטיס ביקור ליצירת קשר)
isForwarded boolean הדגל מציין אם ההודעה מועברת
forwardingScore integer מספר העברות ההודעות

פרמטרים של extendedTextMessage לְהִתְנַגֵד:

פָּרָמֶטֶר סוּג תֵאוּר
text string טקסט הקישור
description string תיאור הקישור
title string כותרת הקישור
previewType string סוג התצוגה המקדימה של הקישור. previewType:None הוצא משימוש
jpegThumbnail string תצוגה מקדימה של תמונה בקידוד Base64
stanzaId string מזהה ההודעה המצוטטת. קיים רק אם typeMessage = quotedMessage
participant string מזהה הצ'אט של המקבל/השולח. קיים רק אם typeMessage = quotedMessage
isForwarded boolean דגל המציין אם ההודעה הועברה
forwardingScore integer מספר ההעברות של ההודעה
showAdAttribution boolean אינדיקציית מודעה
mediaType string סוג המדיה של ההודעה, לדוגמה "IMAGE" (רק להודעות פרסומת)
sourceId string מזהה הפרסומת (רק להודעות פרסומת)
sourceType string סוג המקור, לדוגמה "ad" (רק להודעות פרסומת)
sourceUrl string כתובת ה-URL של הפרסומת (רק להודעות פרסומת)
thumbnailUrl string כתובת ה-URL של התצוגה המקדימה של הפרסומת (רק להודעות פרסומת)
greetingMessageBody string טקסט הודעת הברכה שנשלחה אוטומטית למשתמש. (רק עבור הודעות פרסום)
ctwaClid string מזהה המרה של "לחיצה לוואטסאפ" מפרסומת. משמש לקישור השיחה לקמפיין הפרסומת (רק להודעות פרסומת)
automatedGreetingMessageShown boolean מציין אם למשתמש הוצגה הודעת ברכה אוטומטית (רק להודעות פרסומת)
sourceApp string האפליקציה שממנה יזמו את האינטראקציה עם וואטסאפ: לדוגמה, Facebook, Instagram, או אפליקציית Meta אחרת. (רק להודעות פרסומת)
originalImageUrl string הקישור המקורי לתמונה המשויכת לפרסומת. (רק להודעות פרסומת)
videoNote boolean רק להודעות וידאו. השדה מקבל את הערך true להודעת וידאו מיידית ו-false להודעת וידאו רגילה.

פרמטרים של extendedTextMessageData לְהִתְנַגֵד:

פָּרָמֶטֶר סוּג תֵאוּר
text string תגובה (אימוג'י) להודעה

פרמטרים של pollMessageData לְהִתְנַגֵד:

פָּרָמֶטֶר סוּג תֵאוּר
stanzaId string מזהה הודעת סקר יוצא. הצג רק עבור typeMessage=pollUpdateMessage
name string טקסט הסקר
options array מערך אפשרויות סקר. הצג רק עבור typeMessage= pollMessage
votes array מערך ההצבעות בסקר. הצג רק עבור typeMessage=pollUpdateMessage
multipleAnswers boolean סמן כדי לאפשר מספר תשובות

פרמטרים של options array:

פָּרָמֶטֶר סוּג תֵאוּר
optionName string טקסט אפשרות בחירת סקר

פרמטרים של votes array:

פָּרָמֶטֶר סוּג תֵאוּר
optionName string טקסט אפשרות בחירת סקר
optionVoters array מזהה חשבון הצבעה של מערך סקר

פרמטרים של quotedMessage לְהִתְנַגֵד:

פָּרָמֶטֶר סוּג תֵאוּר
stanzaId string מזהה הודעה מצוטט
participant string מזהה צ'אט של הנמען
typeMessage string סוג הודעה מצוטט

שאר השדות של האובייקט quotedMessage ממולאים בהתאם לסוג ההודעה המצוטטת והם זהים לשדות המתוארים לעיל

פרמטרי אובייקט groupInviteMessageData

פרמטר הקלד תֵאוּר
groupJid **string* מזהה צ'אט קבוצתי
inviteCode **string* קוד הזמנה
inviteExpiration **string* תפוגה של הזמנה
groupName **string* שם הקבוצה
caption **string* כיתוב הודעה
name **string* השדה אינו פעיל ונותר בשביל תאימות לאחור
jpeg Thumbnail **string* תצוגה מקדימה של תמונה ב-base64

בקשת גוף לדוגמה#

[
    {
        "type": "incoming",
        "idMessage": "9DB14F14A253D33F4A9CD84123456789",
        "timestamp": 1706522263,
        "typeMessage": "textMessage",
        "chatId": "120363153000000000@g.us",
        "textMessage": "Hi",
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "EAAE5A5CD000000000",
        "timestamp": 1706601620,
        "typeMessage": "imageMessage",  //"videoMessage"/`documentMessage`/`audioMessage`/`stickerMessage`
        "chatId": "120363153000000000@g.us",
        "downloadUrl": "https://api.green-api.com/waInstance1234/downloadFile/EA1BD1AE042DC4F3609867126309D67C.jpg",
        "caption": "What do you think?",
        "fileName": "03963bac-6020-423c-80df-1aa123456789.jpg",
        "jpegThumbnail": "/9j/4AAQSkZJ/aAAgBAwEBPwCVYw//xAApEAACAx/2kOVh/VKAoAH/leFhX//+AAMA/9k=",
        "mimeType": "image/jpeg",
        "isAnimated": false,
        "isForwarded": true,
        "forwardingScore": 1,
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "3A1EBA0F23004BD415BB",
        "timestamp": 1706601621,
        "typeMessage": "reactionMessage",
        "chatId": "70000000012@c.us",
        "extendedTextMessageData": {
            "text": "😄"
        },
        "quotedMessage": {
            "stanzaId": "B4D7D8A1A7D887D5580F000000000000",
            "participant": "70000000012@c.us",
        },
        "senderId": "70000000013@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "3A8427EF85F000000000",
        "timestamp": 1706674611,
        "typeMessage": "locationMessage",
        "chatId": "70000000012@c.us",
        "location": {
            "nameLocation": "Cafe",
            "address": "Astana",
            "jpegThumbnail": "/9j/4AAQSkZJRgABAQAASABIAAD/4QBYRX",
            "latitude": 51.1280000000000,
            "longitude": 71.4307620000000,
            "forwardingScore": 0,
            "isForwarded": false
        },
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "3AA2C1D83560000000000",
        "timestamp": 1706675513,
        "typeMessage": "contactMessage",
        "chatId": "70000000012@c.us",
        "contact": {
            "displayName": "Anastasia",
            "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;Anastasia;;;\nFN:Anastasia\nTEL;type=CELL;type=VOICE;waid=70000000013:+7 000 000-00-13\nEND:VCARD",
            "forwardingScore": 0,
            "isForwarded": false
        },
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "3A66D7F0B50000000000",
        "timestamp": 1706675928,
        "typeMessage": "extendedTextMessage",
        "chatId": "70000000012@c.us",
        "textMessage": "Hqhqhhqh\nhttps://greenapi.com",
        "extendedTextMessage": {
            "text": "Hqhqhhqh\nhttps://greenapi.com",
            "description": "GREEN-API: WhatsApp API on any language PHP, JavaScript, 1C, Python, Java, C#, VBA etc.",
            "title": "GREEN-API: send and receive WhatsApp messages",
            "previewType": "None",
            "jpegThumbnail": "/9j/4AAQSkZJRgABAQAAAQABZ",
            "forwardingScore": 0,
            "isForwarded": false
        },
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "3A71511C3A0000000000",
        "timestamp": 1706676278,
        "typeMessage": "pollMessage",
        "chatId": "70000000012@c.us",
        "pollMessageData": {
            "name": "Choose your favorite color",
            "options": [
                {
                    "optionName": "Red"
                },
                {
                    "optionName": "Green"
                }
            ],
            "multipleAnswers": true
        },
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "3A0493ED90000000000000",
        "timestamp": 1706676447,
        "typeMessage": "pollUpdateMessage",
        "chatId": "70000000012@c.us",
        "pollMessageData": {
            "name": "Where will we go?",
            "stanzaId": "46618B98B3B9DF50F123456789123456",
            "votes": [
                {
                    "optionName": "Beach",
                    "optionVoters": [
                        "70000000012@c.us"
                    ]
                },
                {
                    "optionName": "Mountains",
                    "optionVoters": []
                }
            ],
            "multipleAnswers": true
        },
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "typeMessage": "incomingBlock",  //Notification is temporarily not working
        "timestamp": 1706676650,
        "chatId": "10000000000@c.us",
        "senderId": "10000000000@c.us",
        "chatState": "blocked"
    },
    {
        "type": "incoming",
        "idMessage": "3AB0EB938BA0000000000",
        "timestamp": 1706677013,
        "typeMessage": "quotedMessage",
        "chatId": "70000000012@c.us",
        "extendedTextMessage": {
            "text": "For the beach",
            "stanzaId": "46618B98B3B9DF50F123456789123456",
            "participant": "70000000012@c.us"
        },
        "quotedMessage": {
            "stanzaId": "46618B98B3B9DF50F123456789123456",
            "participant": "70000000012@c.us",
            "typeMessage": "pollMessage",
            "pollMessageData": {
                "name": "Where will we go?",
                "options": [],
                "multipleAnswers": true
            }
        },
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "3A70B27A6020000000000",
        "timestamp": 1706677254,
        "typeMessage": "quotedMessage",
        "chatId": "70000000012@c.us",
        "extendedTextMessage": {
            "text": "Great!",
            "stanzaId": "EAAE5A5CD000000000",
            "participant": "70000000012@c.us"
        },
        "quotedMessage": {
            "stanzaId": "EAAE5A5CD000000000",
            "participant": "70000000012@c.us",
            "typeMessage": "imageMessage", //"videoMessage"/`documentMessage`/`audioMessage`/`stickerMessage`
            "downloadUrl": "",
            "caption": "",
            "fileName": "",
            "jpegThumbnail": "/9j/4AAQSkZJRgABAQAAA=",
            "mimeType": "image/jpeg",
            "isAnimated": false,
            "isForwarded": false,
            "forwardingScore": 0
        },
        "senderId": "70000000012@c.us",
        "senderName": "Rachel",
        "senderContactName": "Rachel 2"
    },
    {
        "type": "incoming",
        "idMessage": "A5044C1535772B4D060C57C62A530AAB",
        "timestamp": 1774943001,
        "typeMessage": "groupInviteMessage",
        "chatId": "70000000012@c.us",
        "groupInviteMessageData": {
            "groupJid": "120363425469355954@g.us",
            "inviteCode": "B060dkNctUdXvUHC",
            "inviteExpiration": "1775202192",
            "groupName": "ntcn",
            "caption": "Invitation to join my WhatsApp group",
            "jpegThumbnail": "",
        },
        "senderId": "70000000012@c.us",
        "senderName": "Jane",
        "senderContactName": "Jane Doe",
        "deletedMessageId": "",
        "editedMessageId": "",
        "isEdited": false,
        "isDeleted": false
    },
    {
        "type": "incoming",
        "idMessage": "3AC3BB68475D6EC5BBD1",
        "timestamp": 1785992892,
        "typeMessage": "extendedTextMessage",
        "chatId": "70000000012@c.us",
        "textMessage": "Hello! I'd like to place an order",
        "extendedTextMessage": {
            "text": "Hello! I'd like to place an order",
            "description": ":thinking_face:Thinking about what to choose today?\n\Chat with customers in the best messenger on Earth.\nSales managers are ready to answer you.\n:mailto: support@green-api.com",
            "title": "Write to us",
            "previewType": "None",
            "jpegThumbnail": "",
            "forwardingScore": 0,
            "isForwarded": false,
            "containsAutoReply": false,
            "mediaType": "VIDEO",
            "showAdAttribution": true,
            "sourceId": "120252186701100169",
            "sourceType": "ad",
            "sourceUrl": "https://www.instagram.com/p/187 ... xWK/",
            "thumbnailUrl": "https://instagram.ftse3-2.fna.fbcdn.net/ ... =6A79CE3D",
            "greetingMessageBody": "Hello! We are happy to help you!",
            "ctwaClid": "Afh6oztQClFhp ... bjQ",
            "automatedGreetingMessageShown": true,
            "sourceApp": "instagram",
            "originalImageUrl": "https://instagram.ftse3-2.fna.fbcdn.net/ ... =6A79CE3D"
        },
        "senderId": "70000000012@c.us",
        "senderName": "Jane",
        "senderContactName": "Jane Doe",
        "deletedMessageId": "",
        "editedMessageId": "",
        "isEdited": false,
        "isDeleted": false
    }
]

LastIncomingMessages errors#

For a list of errors common to all methods, refer to Common errors section

Request examples#

import requests

url = "{{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}"

payload = {}
headers= {}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

curl --location '{{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}?minutes=3240'

var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/lastIncomingMessages/")
    .append({{apiTokenInstance}});

var response = restTemplate.exchange(requestUrl.toString(), HttpMethod.GET, null, String.class);
System.out.println(response);

var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/lastIncomingMessages/")
    .append({{apiTokenInstance}});

var response = Unirest.get(requestUrl.toString())
    .header("Content-Type", "application/json")
    .asString();

System.out.println(response);

Sub LastIncomingMessages()
    Dim url As String
    Dim http As Object
    Dim response As String

    ' The apiUrl, idInstance and apiTokenInstance values are available in console, double brackets must be removed
    url = "{{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}"

    Set http = CreateObject("MSXML2.XMLHTTP")

    http.Open "GET", url, False
    http.send

    response = http.responseText

    Debug.Print response

    ' Outputting the answer to the desired cell
    Range("A1").Value = response

    Set http = Nothing
End Sub