מאפיינים מיוחדים בעבודה עם אנשי קשר באמצעות lid#

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

השינויים של WhatsApp ישפיעו על כל המשתמשים, ולכן חשוב להיות מוכנים לשינויים הצפויים. במאמר זה נבחן אילו שינויים יחולו ב-API ומה יהיה צורך לעשות כדי להמשיך להשתמש ב-API של WhatsApp ביעילות מבלי לאבד קשר עם הלקוחות שלך.

תוכן#

• כיצד נשלחו בעבר הודעות לפי מספר טלפון
• מעבר הדרגתי משימוש בתחילית c.us
• שליחת הודעות באמצעות lid
• קבלת יומנים ו-Webhooks עם lid
• ההכרח במעבר ל-lid

כיצד נשלחו בעבר הודעות לפי מספר טלפון#

לשליחת הודעות השתמש ב-מזהה הצ'אט. ב-GREEN-API נתמכים שני סוגי צ'אטים – צ'אט אישי ו-צ'אט קבוצתי.

בעבר, בגוף הבקשה של השיטה היה מספיק לציין את מספר המקבל עם התחילית @c.us כדי לשלוח הודעת טקסט

    {
    "chatId": "1111111111@c.us",
    "message": "Hello, John Doe"  
    }

מעבר הדרגתי משימוש בתחילית c.us#

בכל שיטות שליחת ההודעות, מזהה הצ'אט, שיטות העבודה עם היומנים וגם ב-וובחוקים – התחילית @c.us משמשת לצורך תאימות לאחור. כעת במקומה תקבל מזהה צ'אט בפורמט lid.

אנחנו ממליצים בתקיפות לעבור לשימוש במזהה הצ'אט האישי lid.

שליחת הודעות באמצעות lid#

באופן כללי, שליחת הודעות דרך lid שונה משליחה דרך מספר טלפון בכך שיש לקבל תחילה את מזהה הצ'אט באמצעות השיטה CheckWhatsapp או מתוך התכתבות עם המשתמש.

אם מזהה הצ'אט אינו ידוע, יש להשתמש תחילה בשיטה CheckWhatsapp, לקבל את ערך chatId ואז לשלוח הודעות באמצעות השיטה SendMessage או שיטות נוספות.

שליחת הודעה באמצעות lid

    {
    "chatId": "120650379300963@lid",
    "message": "Hello, John Doe"
    }

נכון לעכשיו, ביומנים וב-Webhooks יתקבל מספר הטלפון של המשתמש, גם אם השליחה בוצעה דרך @lid.

קבלת יומנים ו-Webhooks עם lid#

{#recive-journals}

בחשבון האישי, בהגדרות המופע, יש להגדיר בשדה Version (גרסה) את הערך 5.44.36.00 ולאחר מכן ללחוץ על כפתור שמור שינויים. לחלופין, באמצעות השיטה SetSettings יש לציין בשדה version את הערך 5.44.36.00.

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

בדוק באמצעות השיטה GetSettings שההגדרות של המופע הוחלו – לשם כך ודא ששדה version אינו ריק.

אם כל ההגדרות הוחלו, ביומנים בשדות chatId ו-senderId יירשם המספר lid, הייחודי לכל מופע.

דוגמה ליומן ההודעות הנכנסות האחרונות עם lid

{
        "type": "incoming",
        "idMessage": "ACB2EA51BD0573D8F64E480908C6017A",
        "timestamp": 1779704763,
        "typeMessage": "textMessage",
        "chatId": "155508384256027@lid",
        "textMessage": "Hello, I use the GREEN-API to send message into WhatsApp!",
        "senderId": "155508384256027@lid",
        "senderName": "John Doe",
        "senderContactName": "",
        "deletedMessageId": "",
        "editedMessageId": "",
        "isEdited": false,
        "isDeleted": false
    },
    {
        "type": "incoming",
        "idMessage": "AC710B072D589F5583ADF9E4C904330E",
        "timestamp": 1779703495,
        "typeMessage": "textMessage",
        "chatId": "155508384256027@lid",
        "textMessage": "Hello, I use the GREEN-API ",
        "senderId": "155508384256027@lid",
        "senderName": "John Doe",
        "senderContactName": "",
        "deletedMessageId": "",
        "editedMessageId": "",
        "isEdited": false,
        "isDeleted": false
    }

דוגמה להודעות נכנסות עם lid

{
  "typeWebhook": "incomingMessageReceived",
  "idMessage": "AC162054DB255E4CF2FBD5C559089191",
  "instanceData": {
    "idInstance": 1101111111,
    "wid": "79876543210@c.us",
    "typeInstance": "whatsapp"
  },
  "timestamp": 1588091580,
  "senderData": {
    "chatId": "155508384256027@lid",
    "sender": "155508384256027@lid",
    "senderName": "John",
    "senderContactName": "",
    "chatName": "John Doe"
  },
  "messageData": {
    "typeMessage": "textMessage",
    "textMessageData": {
      "textMessage": "Hello, I use the GREEN-API to send message into WhatsApp!"
    }
  }
}

ההכרח במעבר ל-lid#

WhatsApp מודיעים כי המעבר ההדרגתי משימוש במספרי טלפון צפוי להימשך בערך עד סוף שנת 2026, ולכן כדאי להיות מוכנים לשינויים.

ממאמר זה למדתם שניתן לבצע את המעבר ל-lid ללא שינויים משמעותיים באינטגרציה ובזמן קצר.

ולכן, כבר היום כדאי להכין את האינטגרציה או הצ'אט-בוט שלך לעבודה עם lid.