Skip to content

LastIncomingMessages#

Test

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

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

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

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

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

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

בַּקָשָׁה#

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

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

לפרמטרים של בקשת 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 מספר העברות ההודעות

פרמטרים של 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 ממולאים בהתאם לסוג ההודעה המצוטטת והם זהים לשדות המתוארים לעיל

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

[
    {
        "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"
    }
]

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