LastOutgoingCalls#

גרסת בטא

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

השיטה מחזירה את השיחות היוצאות האחרונות של החשבון.

הגדרות

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

החלת ההגדרות נמשכת עד 5 דקות.

כדי לקבל מידע על שיחות יוצאות שבוצעו לפני חיבור המופע, יש לשמור את ההגדרות במופע, ולאחר מכן לבצע התנתקות והרשאה מחדש.

השיטה מחזירה את 10000 השיחות האחרונות. השיטה LastOutgoingCalls מחזירה רק את ההיסטוריה ש-WhatsApp מעביר למערכת.

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

בקשה#

כדי לקבל את היסטוריית השיחות היוצאות, יש לבצע בקשה לכתובת:

GET

{{apiUrl}}/waInstance{{idInstance}}/lastOutgoingCalls/{{apiTokenInstance}}

לקבלת פרמטרי הבקשה apiUrl, idInstance ו-apiTokenInstance, עיינו בסעיף לפני תחילת העבודה.

פרמטרי כתובת הבקשה (URL)#

פרמטר	סוג	חובה	תיאור
`minutes`	integer	לא	הזמן בדקות שעבורו יש להציג את השיחות (ברירת המחדל: 1440 דקות)

תגובה#

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

מערך אובייקטים עם השדות:

שדה	סוג	תיאור
`type`	string	סוג השיחה, `outgoing` - שיחה יוצאת
`idMessage`	string	מזהה השיחה היוצאת
`timestamp`	integer	זמן סיום השיחה בפורמט UNIX
`typeMessage`	string	סוג השיחה: `outgoingCall` - שיחה יוצאת
`chatId`	string	מזהה הצ'אט שבו בוצעה השיחה
`duration`	integer	משך השיחה בשניות
`isVideo`	boolean	דגל המציין אם זו הייתה שיחת וידאו
`status`	string	סטטוס השיחה. יכול לקבל את הערכים הבאים:
		`pickUp` - לפחות משתתף אחד ענה לשיחה
		`hungUp` - אף אחד מהמשתתפים לא ענה לשיחה, או שלמספר שאליו בוצעה השיחה אין חשבון WhatsApp
		`invalid` - לא ניתן היה להשלים את השיחה או לעבד את הסטטוס. לדוגמה, המספר שאליו בוצעה השיחה אינו קיים
`participants`	array	סטטוס השיחה עבור כל משתתף. בשיחות פרטיות השדה יכיל אובייקט אחד בלבד

שדות האובייקט participants:

שדה	סוג	תיאור
`id`	string	מזהה הצ'אט הפרטי של משתתף השיחה
`status`	string	סטטוס השיחה אצל משתתף מסוים. יכול לקבל את הערכים הבאים:
		`pickUp` - המשתתף ענה לשיחה
		`hungUp` - המשתתף לא ענה לשיחה, או שהמספר שאליו בוצעה השיחה אינו קיים
		`declined` - המשתתף דחה את השיחה
		`invalid` - לא ניתן היה להשלים את השיחה או לעבד את הסטטוס

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

[
    {
        "type": "outgoing",
        "idMessage": "AC0E17D82A7B513089H667F636DD2AE5",
        "timestamp": 1754455789,
        "typeMessage": "outgoingCall",
        "chatId": "120363153000000000@g.us",
        "duration": 22,
        "isVideo": false,
        "status": "pickUp",
        "participants": [
            {
                "id": "79111234567@c.us",
                "status": "pickUp"
            },
            {
                "id": "79222234567@c.us",
                "status": "hungUp"
            }
        ]
    },
    {
        "type": "outgoing",
        "idMessage": "F33E8701AGHY4DE04254CBBAE21EC046",
        "timestamp": 1754455763,
        "typeMessage": "outgoingCall",
        "chatId": "79111234567@c.us",
        "duration": 3,
        "isVideo": false,
        "status": "pickUp",
        "participants": [
            {
                "id": "79111234567@c.us",
                "status": "pickUp"
            }
        ]
    },
    {
        "type": "outgoing",
        "idMessage": "F33E8701AGHY4DE04254CBBAE21EC046",
        "timestamp": 1754455763,
        "typeMessage": "outgoingCall",
        "chatId": "79111234567@c.us",
        "duration": 0,
        "isVideo": false,
        "status": "declined",
        "participants": [
            {
                "id": "79111234567@c.us",
                "status": "declined"
            }
        ]
    },
        {
        "type": "outgoing",
        "idMessage": "F33E8701AGHY4DE04254CBBAE21EC046",
        "timestamp": 1754455763,
        "typeMessage": "outgoingCall",
        "chatId": "79111234567@c.us",
        "duration": 0,
        "isVideo": false,
        "status": "invalid",
        "participants": [
            {
                "id": "79111234567@c.us",
                "status": "invalid"
            }
        ]
    }
]

שגיאות LastOutgoingCalls#

רשימת השגיאות המשותפות לכל השיטות מופיעה בסעיף שגיאות נפוצות

דוגמאות בקשה#

PythoncURLJava - SpringJava - UnirestVBA

import requests

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

payload = {}
headers= {}

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

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

curl --location '{{apiUrl}}/waInstance{{idInstance}}/lastOutgoingCalls/{{apiTokenInstance}}'

var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/lastOutgoingCalls/")
    .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("/lastOutgoingCalls/")
    .append({{apiTokenInstance}});

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

System.out.println(response);

Sub LastOutgoingCalls()
    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}}/lastOutgoingCalls/{{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