# Coming Soon - Important ⚠️
Heads up
The information on this page describes upcoming changes to the WhatsApp API. The rollout is expected to begin in July 2026. Customers will receive this gradually. We strongly recommend preparing your system in advance to receive the new id field.
# English Version
# A new capability from Meta — "username" and increased privacy
In the coming months, Meta will roll out a new capability called username for WhatsApp applications. Customers will start receiving this gradually starting in July 2026.
The main reason we are publishing this document is that systems that rely on the sender's phone number as the identifier will need to make adjustments. Hence the critical update and detailed explanation below.
# What is this new capability?
Similar to what already exists in Telegram, Meta is going to allow users who choose to do so to hide their phone number in WhatsApp by selecting a "username" instead. This capability was created following many requests to Meta from people who wish to remain anonymous when communicating with other people and with businesses.
Once a customer chooses to adopt a username, all of their communication with new people or with an API line will be done with a hidden identity.
# What does this mean in practice?
Today, via webhooks and through our omnichannel system, you are used to receiving the sender's phone number on every incoming message. Once a customer activates the hidden identity, the phone number will not arrive if they have not corresponded with your business WhatsApp before. In other words, if the customer has already corresponded with you, you will continue to receive their phone number. If not — the phone number will not be displayed.
# So what comes instead?
Instead of the phone number, two new fields will be sent: id and username.
# id
The id is essentially the replacement for the phone number. It contains an ISO country code + a dot + a random number.
For example: IL.45634521792468 — so you know you are corresponding with an Israeli number. The number is fixed (never changes) per WhatsApp line.
# username
The username is the username the customer chose. It has no significance for API communication. The username is shown here so you can know which name the customer chose and display it in your system. The customer is also allowed to change their username whenever they wish. The username is unique in the WhatsApp system — there will not be two people with the same username.
# How do you correspond with the customer?
From our omnichannel system's perspective — there is no difference. Communication with a number like IL.45634521792468 will work without any issue, and the system will treat it as it does normally.
From an API perspective, you will be able to send the above id as the destination for sending, and it will reach the recipient just like a phone number (it is possible that another field in the API will be expanded in the future). You will be able to send regular messages, template messages, and everything else exactly the same way.
# What if you must have the phone number for your system / bot?
Meta has thought about this solution and about cases where the phone number is critical, sometimes in order to continue the customer's request. Therefore, Meta is going to allow you to create a new template called "phone number request template".
This is essentially a special template where you do not have control over its content, but you can create it and send it to the customer. The template will include a button with the text: "Do you allow this business to receive your phone number?"
If the customer clicks the button, all of their following communication, including the next message they write, will already include the phone number as it always did, and it will remain fixed for you. It is recommended to create this template together with each new customer. You can run a process in your chatbot where the template appears at the start of the conversation in order to continue.
# Username for businesses too!
The username capability is not limited to WhatsApp customers only. You — the businesses — can also choose a username for yourselves (one that is not taken) in order to allow potential customers to contact you in addition to the phone number (the name requires Meta approval, just like a display name).
This means that soon you will start to see on outdoor billboards the WhatsApp logo next to text such as: "Send us a message: #MaccabiHealth."
You will be able, through our omnichannel system as well as through the API, to request such a username for an API line. The username will be unified across all Meta platforms: WhatsApp, Facebook, and Instagram.
Get ready
We will publish further updates regarding the updated API format and timelines for when this capability goes live. We recommend preparing the above infrastructure in your system to receive the id.
# Frequently Asked Questions
Q: Can I send a message to a username?
A: Through the API — no. The username is mainly for communication between people. People will be able to share their username with each other instead of their phone number to communicate. It will be possible to search for contacts in the WhatsApp app.
Q: If I know the number of a specific customer, and they chose to hide their identity, can I contact them with their number? A: Yes, of course. Hiding the identity does not remove the link of the phone to WhatsApp. If you know the customer's WhatsApp phone number, you can reach out to them just like today. The whole subject of hiding the number is essentially about a situation where the customer reached out to you for the first time, and is not interested in exposing their number.
Q: If the customer has corresponded with me in the past, will I see their number? A: If the customer corresponded with you after April 1, 2026, the phone number will always be displayed to you, even if they activated number hiding. There are essentially two cases where the number will continue to arrive: the customer corresponded with you before they activated number hiding, or when you sent a template message and the customer approved sharing their number with you.
Q: Can I use the id to correspond with the customer on a different WhatsApp API line that I have?
A: No! The id is unique to the WhatsApp line on which you received the message. That is, if you have an additional line, and the same customer sends a message to it, the id will be different. The id is fixed per WhatsApp line and will never change (unlike username, which the customer can change — the customer cannot change or touch the id).
Q: Can the phone number request message be sent only as a template, or also as a free-text message? A: Template only.
# גרסה עברית
# יכולת חדשה במטא — "שם משתמש" והגברת הפרטיות — חשוב
בחודשים הקרובים מטא משחררת יכולת חדשה שנקראת username לאפליקציות WhatsApp. הלקוחות יתחילו לקבל את זה בהדרגה החל מיולי 2026.
הסיבה העיקרית שאנחנו רושמים מסמך זה היא שמערכות שמתבססות על מספר הטלפון כזיהוי של השולח צריכות לעשות התאמה, ולכן העדכון הקריטי וההסבר המפורט שלהלן.
# מה זאת היכולת הזאת?
בדומה למה שיש בטלגרם, מטא מאפשרת למשתמשים אשר יבחרו בכך, להסתיר את מספר הטלפון שלהם ב‑WhatsApp על ידי בחירת ״שם משתמש״ במקום. היכולת הזאת נוצרה בעקבות פניות רבות למטא שאנשים מעוניינים להישאר אנונימיים בתקשורת עם אנשים אחרים ומול עסקים.
ברגע שלקוח בחר לאמץ את שם המשתמש, כל התקשורת שלו עם אנשים חדשים אחרים או מול קו API תהיה בזהות נסתרת.
# מה זה אומר בפועל?
כיום, באמצעות webhooks וגם דרך מערכת האומניצ'אנל שלנו, אתם רגילים לקבל את הטלפון של השולח בהודעה נכנסת. ברגע שלקוח יפעיל את הזהות הנסתרת, מספר הטלפון לא יגיע אם הוא לא התכתב עם ה‑WhatsApp העסקי שלכם לפני כן. כלומר, אם הלקוח כבר התכתב איתכם, אתם תמשיכו לקבל את הטלפון שלו. אם לא — הטלפון לא יוצג לכם.
# אז מה יגיע במקום?
במקום מספר הטלפון, יגיעו 2 שדות חדשים: id ו‑username.
# id
ה‑id הזה בעצם המחליף של מספר הטלפון. הוא מכיל בתוכו קוד מדינה ISO + נקודה + מספר אקראי.
לדוגמא: IL.45634521792468 כדי שתדעו שאתם מתכתבים עם מספר ישראלי. המספר הוא קבוע.
# username
ה‑username זה השם משתמש שהוא בחר. אין לו משמעות מבחינת תקשורת API. השם משתמש הזה מוצג כאן כדי שתוכלו לדעת איזה שם בחר הלקוח ולהציג אותה במערכת שלכם. הלקוח רשאי גם להחליף את שם המשתמש בכל זמן שירצה. שם המשתמש הוא ייחודי במערכת WhatsApp ולא יהיו שני אנשים עם אותו השם משתמש.
# איך מתכתבים עם הלקוח?
מבחינת מערכת האומניצ'אנל שלנו — אין שום הבדל. התקשורת עם מספר IL.45634521792468 תהיה אפשרית ללא בעיה והמערכת מתייחסת אליו בצורה רגילה.
מבחינת ה‑API תוכלו לשלוח את ה‑id הנ"ל כמספר יעד לשליחה וזה יגיע לנמען ממש כמו מספר טלפון (ייתכן שדה אחר ב‑API יורחב בבוא העת). תוכלו לשלוח אליו הודעות רגילות, הודעות תבנית ושאר הדברים בדיוק באותה צורה.
# אתם חייבים את מספר הטלפון בשביל המערכת / בוט שלכם, זה מה שעושים:
מטא חשבו על הפתרון הזה ועל מצב שמספר הטלפון הוא קריטי לפעמים בשביל להמשיך את תהליך הפנייה של הלקוח, ולכן מטא מאפשרת לכם לייצר תבנית חדשה שתקרא ״תבנית בקשה למספר טלפון״.
זה בעצם תבנית מיוחדת, שבה אין לכם שליטה על התוכן שלה, אבל אתם יכולים לייצר ולשלוח אותה ללקוח. התבנית תכלול כפתור, ויהיה כתוב ״האם אתה מאשר לעסק לקבל את מספר הטלפון שלך״.
במידה והלקוח ילחץ על הכפתור, כל התקשורת הבאה שלו, החל מההודעה הבאה שהוא כותב, תכלול כבר את מספר הטלפון כמו שהיה תמיד וזה יישאר עבורכם קבוע. מומלץ לייצר את התבנית יחד עם כל לקוח חדש. אתם יכולים להפעיל בצ'אטבוט שלכם תהליך שבו התבנית מופיעה בתחילת השיחה על מנת להמשיך.
# שם משתמש גם לעסקים!
היכולת של שם משתמש לא מוגבלת רק ללקוחות WhatsApp. אתם, העסקים, יכולים לבחור לעצמכם שם משתמש (שאינו תפוס) על מנת לאפשר ללקוחות פוטנציאליים לתקשר אתכם, בנוסף למספר הטלפון (השם דורש אישור של מטא, ממש כמו שם תצוגה). זאת אומרת שבקרוב נתחיל לראות על שלטי חוצות את הסמליל של WhatsApp ולידו הטקסט: "תשלחו לנו הודעה: #MaccabiHealth".
תהיה לכם אפשרות דרך האומניצ'אנל שלנו וגם דרך ה‑API לבקש בקשה לשם משתמש שכזה בשביל קו ה‑API. השם משתמש יהיה אחיד לכל פלטפורמות מטא: WhatsApp, פייסבוק ואינסטגרם.
בזמן הקרוב נפרסם עוד עדכונים לגבי תצורת ה‑API המעודכנת ולוחות זמנים שהיכולת הזאת תיכנס לפועל. מומלץ להיערך לתשתית הנ"ל במערכת שלכם לקבלת id.
# שאלות נפוצות
ש: האם ניתן לשלוח הודעה ל‑username?
ת: דרך ה‑API לא. השם משתמש הוא בעיקר לתקשורת בין אנשים. כלומר, אנשים יוכלו למסור אחד לשני את שם המשתמש שלהם במקום את מספר הטלפון כדי לתקשר. ניתן יהיה לחפש אנשי קשר באפליקציית WhatsApp.
ש: אם אני יודע את המספר של לקוח מסוים, והוא בחר להסתיר את הזהות, אני יכול לפנות אליו עם המספר שלו? ת: כן, כמובן. הסתרת הזהות לא מעלימה את הקישור של הטלפון ל‑WhatsApp. אם אתם יודעים מספר טלפון WhatsApp של לקוח, ניתן לפנות אליו באותה צורה כמו היום. כל נושא הסתרת המספר מדובר בעצם על מצב שבו לקוח פנה אליכם לראשונה, ולא מעוניין לחשוף את המספר שלו.
ש: אם הלקוח התכתב איתי בעבר, האם אראה את המספר שלו? ת: אם הלקוח התכתב איתכם אחרי 1.4.2026 מספר הטלפון יוצג לכם לתמיד, גם אם הוא הפעיל את הסתרת המספר. יש בעצם שני מצבים שבהם המספר ימשיך להגיע: הלקוח התכתב איתכם לפני שהוא הפעיל את הסתרת המספר, או כאשר שלחתם הודעת תבנית והלקוח אישר לכם לראות את המספר.
ש: האם ניתן להשתמש ב‑id כדי להתכתב עם הלקוח בקו WhatsApp API אחר שיש לי?
ת: לא! ה‑id הוא ייחודי לקו ה‑WhatsApp שאיתו קיבלתם את ההודעה. כלומר, אם ברשותכם קו נוסף, ואותו לקוח שולח לשם הודעה, יהיה id אחר. ה‑id הוא קבוע לקו WhatsApp ולעולם לא ישתנה (בניגוד ל‑username שהלקוח יכול להחליף, הלקוח לא יכול לשנות או לגעת ב‑id).
ש: האם ניתן לשלוח את ההודעה לבקשת חשיפת מספר רק כתבנית או גם כהודעה חופשית? ת: רק תבנית.