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="
    }
  }
}