Group invitation incoming message#
חלק זה מתאר פורמט אינטרנט נכנס של אובייקט 'messageData' עבור הודעה נכנסת של הזמנה קבוצתית. לתיאור של הפורמט הכללי של webhooks נכנסות, עיין בסעיף הודעות נכנסות.
כדי לקבל webhooks נכנס מסוג זה, שני תנאים חייבים להתקיים:
typeWebhook
= IncomingMessageReceived
messageData.typeMessage
= groupInviteMessage
התנאים הנדרשים לקבלת הודעת groupInviteMessage
- הפרמטר
incomingWebhook
מופעל בהגדרות המופע; - מספר הטלפון של השולח נשמר באנשי הקשר של הנמען;
- מספר הטלפון של הנמען לא נשמר על ידי השולח באנשי קשר;
- בהגדרות הפרטיות של הנמען, היכולת לשלוח הזמנות לקבוצה מוגדרת רק לאנשי קשר.
כדי לשלוח הזמנה ל-קבוצה חדשה:
- צור קבוצה בוואטסאפ עם מספר המשתתף
- תקבל את ההודעה "לא ניתן להוסיף את <...>. אתה יכול להזמין אותם באופן פרטי להצטרף לקבוצה זו"
- בחר "הזמן לקבוצה".
כדי לשלוח הזמנה ל-קבוצה קיימת:
- עבור לקבוצה קיימת, פתח את "מידע קבוצה, בחר "הוסף חברים", בחר את הנמען שלך
- תקבל את ההודעה "לא ניתן להוסיף את <...>. אתה יכול להזמין אותם באופן פרטי להצטרף לקבוצה זו"
- בחר "הזמן לקבוצה".
לאחר מכן, הנמען יקבל הזמנה לקבוצה והתראת groupInviteMessage
במופע המקושר.
קישורי הזמנה לקבוצה אינם הודעות עם סוג
groupInviteMessage
.קבלת הודעה מסוג זה אפשרית רק על ידי שליחת הזמנה דרך המכשיר. שליחת הזמנה זו באמצעות API אינה אפשרית.
Webhook#
פרמטרים של Webhook#
פרמטרים של אובייקט messageData
פרמטר | הקלד | תיאור |
---|---|---|
typeMessage | מחרוזת | סוג הודעה נכנסת. עבור הודעות מסוג זה הפרמטר מקבל את הערך: groupInviteMessage |
groupInviteMessageData | חפץ | אובייקט נתוני הודעת הזמנה נכנסת לקבוצה |
quotedMessage | חפץ | אובייקט נתוני הודעה מצוטט. |
פרמטרי אובייקט groupInviteMessageData
פרמטר | הקלד | תֵאוּר |
---|---|---|
groupJid | מחרוזת | מזהה צ'אט קבוצתי |
inviteCode | מחרוזת | קוד הזמנה |
inviteExpiration | מחרוזת | תפוגה של הזמנה |
קבוצה שם | מחרוזת | שם הקבוצה |
כיתוב | מחרוזת | כיתוב הודעה |
שם | מחרוזת | שם השולח |
jpeg Thumbnail | מחרוזת | תצוגה מקדימה של תמונה ב-base64 |
פרמטרי אובייקט quotedMessage
פרמטר | הקלד | תיאור |
---|---|---|
stanzaId | מחרוזת | מזהה הודעה מצוטט |
משתתף | מחרוזת | מצוטט מזהה שולח ההודעה |
typeMessage | מחרוזת | סוג הודעה מצוטט |
שאר השדות ממולאים בהתאם לסוג ההודעה המצוטטת והם זהים לשדות ההודעות הנכנסות המתוארות בסעיף הודעות נכנסות
דוגמה לגוף Webhook#
{
"typeWebhook": "incomingMessageReceived",
"instanceData": {
"idInstance": 1234,
"wid": "11001234567@c.us",
"typeInstance": "whatsapp"
},
"timestamp": 1588091580,
"idMessage": "F7AEC1B7086ECDC7E6E45923F5EDB825",
"senderData": {
"chatId": "79001234568@c.us",
"chatName": "John",
"sender": "79001234568@c.us",
"senderName": "John",
"senderContactName": "John Doe"
},
"messageData": {
"typeMessage": "groupInviteMessage",
"groupInviteMessageData": {
"groupJid": "79099197688-1506012221@g.us",
"inviteCode": "a7E5WU/g7rmjaQnv",
"inviteExpiration": "0",
"groupName": "Makhlovka, drawing 4-6",
"caption": "Invitation to my WhatsApp group",
"name": "myname",
"jpegThumbnail": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQY/9k="
}
}
}