Group invitation incoming message#

חלק זה מתאר פורמט אינטרנט נכנס של אובייקט 'messageData' עבור הודעה נכנסת של הזמנה קבוצתית. לתיאור של הפורמט הכללי של webhooks נכנסות, עיין בסעיף הודעות נכנסות.

כדי לקבל webhooks נכנס מסוג זה, שני תנאים חייבים להתקיים:

typeWebhook = IncomingMessageReceived

messageData.typeMessage = groupInviteMessage

התנאים הנדרשים לקבלת הודעת groupInviteMessage

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

כדי לשלוח הזמנה ל-קבוצה חדשה:

צור קבוצה בוואטסאפ עם מספר המשתתף
תקבל את ההודעה "לא ניתן להוסיף את <...>. אתה יכול להזמין אותם באופן פרטי להצטרף לקבוצה זו"
בחר "הזמן לקבוצה".

כדי לשלוח הזמנה ל-קבוצה קיימת:

עבור לקבוצה קיימת, פתח את "מידע קבוצה, בחר "הוסף חברים", בחר את הנמען שלך
תקבל את ההודעה "לא ניתן להוסיף את <...>. אתה יכול להזמין אותם באופן פרטי להצטרף לקבוצה זו"
בחר "הזמן לקבוצה".

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

קישורי הזמנה לקבוצה אינם הודעות עם סוג groupInviteMessage.

קבלת הודעה מסוג זה אפשרית רק על ידי שליחת הזמנה דרך המכשיר. שליחת הזמנה זו באמצעות API אינה אפשרית.

Webhook#

פרמטרים של Webhook#

פרמטרים של אובייקט messageData

פרמטר	הקלד	תיאור
`typeMessage`	*string	סוג הודעה נכנסת. עבור הודעות מסוג זה הפרמטר מקבל את הערך: `groupInviteMessage`
`groupInviteMessageData`	object	אובייקט נתוני הודעת הזמנה נכנסת לקבוצה
`quotedMessage`	object	אובייקט נתוני הודעה מצוטט.

פרמטרי אובייקט groupInviteMessageData

פרמטר	הקלד	תֵאוּר
`groupJid`	*string	מזהה צ'אט קבוצתי
`inviteCode`	*string	קוד הזמנה
`inviteExpiration`	*string	תפוגה של הזמנה
`קבוצה שם`	*string	שם הקבוצה
`כיתוב`	*string	כיתוב הודעה
`שם`	*string	שם השולח
`jpeg Thumbnail`	*string	תצוגה מקדימה של תמונה ב-base64

פרמטרי אובייקט quotedMessage

פרמטר	הקלד	תיאור
`stanzaId`	*string	מזהה הודעה מצוטט
`משתתף`	*string	מצוטט מזהה שולח ההודעה
`typeMessage`	*string	סוג הודעה מצוטט

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

דוגמה לגוף Webhook#

{
  "typeWebhook": "incomingMessageReceived",
  "instanceData": {
    "idInstance": 1234,
    "wid": "11001234567@c.us",
    "typeInstance": "whatsapp"
  },
  "timestamp": 1588091580,
  "idMessage": "F7AEC1B7086ECDC7E6E45923F5EDB825",
  "senderData": {
    "chatId": "79001234567@c.us",
    "chatName": "John",
    "sender": "79001234567@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="
    }
  }
}