Incoming messages#
סעיף זה מתאר את הפורמט הכללי של webhooks נכנס עם סוג 'incomingMessageReceived'. תיאור של כל סוגי ה-webhooks הנכנסים ניתן בסעיף סוגי webhooks נכנסים.
המערכת מספקת קבלת הודעות על הודעות נכנסות מהסוגים הבאים:
- הודעת טקסט נכנסת
- הודעת לחצנים נכנסת
- הודעת כפתורי תבנית נכנסת
- הודעת רשימת בחירה נכנסת
- הודעת טקסט נכנסת עם כתובת URL
- תמונה, וידאו, אודיו, הודעת מסמך נכנסת
- הודעת מיקום נכנסת
- הודעה נכנסת ליצירת קשר
- הודעה נכנסת עם מערך של אנשי קשר
- הודעה מצוטטת נכנסת
- הודעה נכנסת עם מדבקה
- הודעה-תגובה נכנסת
- הודעה נכנסת עם הזמנה לקבוצה
- הודעת סקר נכנסת
- הודעת עדכון סקר נכנסת
incomingMessageReceived webhook פרמטרים#
פרמטר | הקלד | תֵאוּר |
---|---|---|
typeWebhook | **string* | סוג webhook נכנס. עבור webhook מסוג זה, ה-paramaeter מקבל את הערך incomingMessageReceived |
instanceData | object | נתוני מופע |
חותמת זמן | integer | חותמת זמן לאירוע בפורמט UNIX |
idMessage | **string* | מזהה הודעה נכנסת |
senderData | object | נתוני שולח ההודעה או הקובץ |
messageData | object | נתוני הודעה או קובץ שהתקבלו |
פרמטרי אובייקט instanceData
פרמטר | הקלד | תֵאוּר |
---|---|---|
idInstance | integer | מזהה מופע גודל המספר השלם הוא int64. טווח הערכים כולל בין 1 ל-10 ספרות |
wid | **string* | זיהוי חשבון בפורמט WhatsApp |
typeInstance | **string* | סוג שליח מופע |
פרמטרים של אובייקט senderData
פרמטר | הקלד | תֵאוּר |
---|---|---|
chatId | **string* | Chat ID, שבו התקבלה הודעה או קובץ |
שולח | **string* | שולח הודעה או קובץ Id |
שם צ'אט | **string* | שם צ'אט |
SenderName | **string* | שם השולח |
senderContactName | **string* | שם השולח לפי רשימת אנשי הקשר של החשבון הנוכחי |
פרמטרי אובייקט messageData
#
לאובייקט messageData
יש פרמטרים שונים בהתאם לסוג ההודעה הנכנסת:
- הודעת טקסט נכנסת
- הודעת טקסט נכנסת עם כתובת URL
- תמונה, וידאו, אודיו, הודעת מסמך נכנסת
- הודעת מיקום נכנסת
- הודעה נכנסת ליצירת קשר
- הודעה נכנסת עם מערך של אנשי קשר
- הודעה מצוטטת נכנסת
- הודעה נכנסת עם מדבקה
- הודעה-תגובה נכנסת
- הודעה נכנסת עם הזמנה לקבוצה
- הודעת סקר נכנסת
- הודעת עדכון סקר נכנסת
דוגמה לגוף Webhook#
{
"typeWebhook": "incomingMessageReceived",
"instanceData": {
"idInstance": 1234,
"wid": "11001234567@c.us",
"typeInstance": "whatsapp"
},
"timestamp": 1588091580,
"idMessage": "F7AEC1B7086ECDC7E6E45923F5EDB825",
"senderData": {
"chatId": "79001234567@c.us",
"sender": "79001234567@c.us",
"chatName": "John",
"senderName": "John",
"senderContactName": "John Doe"
},
"messageData":{
// Depending on typeMessage = textMessage || imageMessage || videoMessage || documentMessage || audioMessage || locationMessage || contactMessage || extendedTextMessage || quotedMessage || pollMessage || pollUpdateMessage
...
...
...
}
}
}