ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

Ονόματα χρήστη του WhatsApp και BSUID: τι αλλάζει στα webhooks του Cloud API

Τα ονόματα χρήστη του WhatsApp επιτρέπουν στους χρήστες να εμφανίζουν ένα όνομα αντί για τον τηλεφωνικό τους αριθμό. Γι' αυτό, από τις αρχές Απριλίου 2026, τα webhooks messages του Cloud API μεταφέρουν επίσης ένα αναγνωριστικό χρήστη σε επίπεδο επιχείρησης (BSUID), όπως το US.13491208655302741918, στα πεδία user_id και from_user_id. Για χρήστη με όνομα χρήστη που δεν έχει στείλει ή λάβει μήνυμα ή κλήση από τον αριθμό τις τελευταίες 30 ημέρες και δεν βρίσκεται στο βιβλίο επαφών, τα wa_id και from παραλείπονται.

Το easyCoexistence συνδέει έναν αριθμό της εφαρμογής WhatsApp Business με το Cloud API μέσω Coexistence και δρομολογεί τα webhooks messages και smb_message_echoes στο endpoint σας όπως τα στέλνει η Meta, με τα πεδία BSUID μέσα, ενώ το get_api_credentials δίνει στον κώδικά σας ό,τι χρειάζεται για να απαντά με recipient.

April 2026

Πότε άρχισαν να εμφανίζονται τα BSUID στα webhooks του Cloud API, πριν τα ονόματα χρήστη φτάσουν στους χρήστες του WhatsApp.

July 2026

Πότε τα API άρχισαν να δέχονται μηνύματα προς BSUID, με τον παραλήπτη στο recipient αντί για το to.

30 days

Η περίοδος παρατήρησης ανά τηλεφωνικό αριθμό επιχείρησης, κατά την οποία κάθε μήνυμα ή κλήση με τον χρήστη διατηρεί τον αριθμό του στα webhooks.

128

Το μεγαλύτερο μέρος των αλφαριθμητικών χαρακτήρων που ακολουθούν τον κωδικό χώρας δύο γραμμάτων και την τελεία του BSUID.

131062

Σφάλμα Messages API: Οι παραλήπτες με αναγνωριστικό χρήστη σε επίπεδο επιχείρησης (BSUID) δεν υποστηρίζονται για αυτό το μήνυμα.

user_changed_user_id

Τύπος μηνύματος συστήματος για αλλαγή BSUID που αναφέρεται χωρίς τηλεφωνικό αριθμό, με το παλιό BSUID στο previous_user_id.

Τι είναι τα ονόματα χρήστη και τα BSUID του WhatsApp;

Το όνομα χρήστη είναι ένα προαιρετικό, μοναδικό όνομα που μπορεί να ορίσει ένας χρήστης του WhatsApp, και εμφανίζεται στην εφαρμογή αντί για τον τηλεφωνικό αριθμό. Η Meta τα διαθέτει σταδιακά το 2026. Το BSUID είναι το αναγνωριστικό backend που πρόσθεσε η Meta ώστε οι επιχειρήσεις να μπορούν να ξεχωρίζουν τους χρήστες: δημιουργείται αυτόματα, είναι μοναδικό για κάθε ζεύγος Business Portfolio και χρήστη, και γράφεται ως κωδικός χώρας ISO 3166 δύο γραμμάτων, τελεία και έως 128 αλφαριθμητικοί χαρακτήρες. Η Meta απαιτεί από τους συνεργάτες και τις άμεσα ενσωματωμένες επιχειρήσεις να το υποστηρίζουν, καθώς καμία επιχείρηση δεν ελέγχει αν οι χρήστες της υιοθετούν ονόματα χρήστη.

Ποια πεδία μεταφέρουν τα νέα αναγνωριστικά;

Νέες ιδιότητες δίπλα σε αυτές που περιείχαν τον τηλεφωνικό αριθμό, σε όλα τα webhooks messages, statuses, system και user_preferences. Τα πεδία γονέα εμφανίζονται μόνο για τα Business Portfolio που έχει εγγράψει η Meta σε γονικά BSUID, τα οποία λειτουργούν σε όλα τα εγγεγραμμένα Business Portfolio:

contacts[].user_idThe user's BSUID, in incoming messages and in sent, delivered and read statuses
messages[].from_user_idThe sender's BSUID, beside from
contacts[].profile.usernameThe username, when the user has one; never on sent statuses
statuses[].recipient_user_idThe recipient's BSUID, unless a send to a phone number failed
parent_user_idA parent BSUID shared by enrolled portfolios, such as US.ENT.11815799212886844830
wa_id, from, recipient_idNow left out when the phone number cannot be shared

Πότε λείπει ο τηλεφωνικός αριθμός;

Όταν ο χρήστης έχει όνομα χρήστη και δεν ισχύει καμία από τις τρεις προϋποθέσεις της Meta. Ο αριθμός παραμένει στα webhooks αν ο τηλεφωνικός αριθμός της επιχείρησης έστειλε μήνυμα ή κάλεσε τον αριθμό του χρήστη τις τελευταίες 30 ημέρες, έλαβε μήνυμα ή κλήση από αυτόν μέσα σε αυτό το διάστημα, ή ο χρήστης βρίσκεται στο βιβλίο επαφών του Business Portfolio. Η περίοδος παρατήρησης των 30 ημερών υπολογίζεται ανά τηλεφωνικό αριθμό επιχείρησης, οπότε ένας δεύτερος αριθμός στο ίδιο Business Portfolio ενδέχεται να λάβει μόνο το BSUID του ίδιου χρήστη. Χρήστες χωρίς όνομα χρήστη συνεχίζουν να φτάνουν με τον τηλεφωνικό τους αριθμό και το BSUID τους.

Πώς μοιάζει πλέον ένα εισερχόμενο μήνυμα;

Όπως πριν, με το BSUID δίπλα στον τηλεφωνικό αριθμό ή στη θέση του. Στο παράδειγμα της Meta για χρήστη με όνομα χρήστη, του οποίου ο αριθμός δεν μπορεί να κοινοποιηθεί, το contacts περιέχει τα profile.name, profile.username και user_id, και το μήνυμα φέρει το from_user_id εκεί όπου παλιότερα υπήρχε το from:

messages webhook: a text from a user known only by BSUID
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "102290129340398",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" },
        "contacts": [{
          "profile": { "name": "Sheena Nelson", "username": "realsheenanelson" },
          "user_id": "US.13491208655302741918"
        }],
        "messages": [{
          "from_user_id": "US.13491208655302741918",
          "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=",
          "timestamp": "1749416383",
          "type": "text",
          "text": { "body": "Does it come in another color?" }
        }]
      }
    }]
  }]
}

Πώς αλλάζουν τα webhooks κατάστασης;

Οι καταστάσεις «απεστάλη», «παραδόθηκε» και «διαβάστηκε» αποκτούν πίνακα contacts με το όνομα του χρήστη, το user_id, το wa_id όταν μπορεί να κοινοποιηθεί ο αριθμός, και το username στις καταστάσεις «παραδόθηκε» και «διαβάστηκε». Στα statuses, το recipient_user_id φέρει το BSUID, ενώ το recipient_id παραλείπεται όταν στείλατε σε BSUID και ο αριθμός δεν μπορεί να κοινοποιηθεί. Μια αποτυχημένη κατάσταση δεν έχει πίνακα contacts και παραλείπει το recipient_user_id όταν το μήνυμα στάλθηκε σε τηλεφωνικό αριθμό, οπότε συνδέστε τις αποτυχίες με το αναγνωριστικό του μηνύματος.

Πώς αποθηκεύετε και αντιστοιχίζετε τους χρήστες;

Πρώτα με το BSUID, με τον τηλεφωνικό αριθμό ως δεύτερο κλειδί όποτε φτάνει. Αποθηκεύστε ολόκληρο το BSUID ως string, με τον κωδικό χώρας και την τελεία, γιατί η Meta απορρίπτει αιτήματα που αλλάζουν οποιοδήποτε μέρος του, και αποθηκεύστε και το γονικό BSUID αν τα Business Portfolio σας είναι εγγεγραμμένα. Συνδέστε τις υπάρχουσες εγγραφές με το wa_id όσο εξακολουθεί να φτάνει, και κρατήστε δίπλα τους το BSUID, επειδή ένας χρήστης που υιοθετεί αργότερα όνομα χρήστη μπορεί να επιστρέψει χωρίς αριθμό. Το FAQ της Meta ζητά τις ίδιες συνδέσεις σε CRM και στα εργαλεία που τροφοδοτούν.

Τι συμβαίνει όταν ένας χρήστης αλλάζει τηλεφωνικό αριθμό;

Το BSUID του δημιουργείται εκ νέου, και η αλλαγή φτάνει στο πεδίο messages ως μήνυμα συστήματος, αφού η Meta δεν έχει πεδίο user_id_update για εγγραφή. Το system.type είναι user_changed_number όταν μπορεί να κοινοποιηθεί ο νέος αριθμός, ή user_changed_user_id όταν μπορεί να αναφερθεί μόνο η αλλαγή του BSUID· το system.user_id φέρει το νέο BSUID και το system.previous_user_id το παλιό, και έτσι μεταφέρεται η εγγραφή. Χειριστείτε και τους δύο τύπους.

Πώς απαντάτε σε χρήστη που γνωρίζετε μόνο μέσω BSUID;

Στείλτε στο /<BUSINESS_PHONE_NUMBER_ID>/messages με recipient ορισμένο στο BSUID και χωρίς to· όταν υπάρχουν και τα δύο, υπερισχύει το to και η απάντηση πηγαίνει στον τηλεφωνικό αριθμό. Η καταχώριση contacts της απόκρισης τότε φέρει input και user_id αντί για wa_id. Κάθε τύπος μηνύματος δουλεύει εκτός από τα πρότυπα ταυτοποίησης one-tap, zero-tap και copy code, που απαιτούν τηλεφωνικό αριθμό, και μόνο οι αριθμοί στο ίδιο Business Portfolio μπορούν να φτάσουν σε BSUID. Το σφάλμα 131062 σημαίνει ότι ο τύπος μηνύματος δεν δέχεται παραλήπτες BSUID.

POST /<BUSINESS_PHONE_NUMBER_ID>/messages, sent to a BSUID
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipient": "US.13491208655302741918",
  "type": "text",
  "text": { "body": "Yes, it also comes in blue." }
}

Πώς ζητάτε από χρήστη τον τηλεφωνικό του αριθμό;

Με το κουμπί REQUEST_CONTACT_INFO, που προστίθεται σε πρότυπο utility ή marketing ή αποστέλλεται ως διαδραστικό μήνυμα τύπου request_contact_info. Όταν ο χρήστης το πατήσει, μοιράζεται τον αριθμό του στη συνομιλία, και φτάνει ένα webhook contacts με origin ορισμένο σε contact_request και τον αριθμό στο phones[].wa_id· μια επαφή που κοινοποιείται χειροκίνητα φτάνει με origin other και vCard. Η Meta έθεσε το κουμπί σε λειτουργία από αρχές Ιουλίου 2026, και η ετικέτα του δεν μπορεί να προσαρμοστεί.

Τι είναι το βιβλίο επαφών;

Ένας αποθηκευτικός χώρος που φιλοξενεί η Meta για κάθε Business Portfolio, χωρίς καμία εργασία ενσωμάτωσης: μόλις ένας τηλεφωνικός αριθμός επιχείρησης στείλει μήνυμα, καλέσει ή λάβει από τον αριθμό ενός χρήστη, ο αριθμός και το BSUID καταγράφονται και χρησιμοποιούνται για να συμπληρώνουν αργότερα τα webhooks με τον τηλεφωνικό αριθμό, είτε υπάρχει όνομα χρήστη είτε όχι. Μετρούν μόνο οι αλληλεπιδράσεις μετά την έναρξη λειτουργίας του. Μπορεί να απενεργοποιηθεί στο Meta Business Suite, στις Ρυθμίσεις επιχείρησης και στις Πληροφορίες επιχείρησης, κάτι που διαγράφει όσα περιέχει, και το GET ή DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book με bsuid ελέγχει ή αφαιρεί μία καταχώριση.

Τι πρέπει να αλλάξει μια ενσωμάτωση Coexistence;

Ο χειρισμός των τριών webhooks που λαμβάνει μόνο ένας αριθμός Coexistence, και αυτά αλλάζουν. Στο history, κάθε νήμα αποκτά ένα αντικείμενο context με wa_id, user_id και username, και τα μηνύματά του αποκτούν from_user_id. Στο smb_message_echoes προστίθεται πίνακας contacts, και το message_echoes[].to μπορεί να παραλείπεται ενώ το to_user_id φέρει το BSUID· οι επεξεργασίες και οι διαγραφές που γίνονται στην εφαρμογή WhatsApp Business φτάνουν με τον ίδιο τρόπο. Στο smb_app_state_sync, το phone_number μιας επαφής μπορεί να παραλείπεται, με το user_id και το username δίπλα του. Αντιστοιχίστε τις echoes και τις εισαγόμενες συνομιλίες με βάση το user_id, εκτός από τον αριθμό.

Πώς να δοκιμάσετε πριν οι χρήστες υιοθετήσουν ονόματα χρήστη;

Με το εργαλείο δοκιμών της Meta στο App Dashboard: στις Περιπτώσεις χρήσης, Σύνδεση με πελάτες μέσω WhatsApp, Προσαρμογή, Διαμόρφωση, ο σύνδεσμος Δοκιμή δίπλα στο webhook messages στέλνει ένα δείγμα στο endpoint σας. Καλύπτει εισερχόμενα μηνύματα και καταστάσεις σε τέσσερα σενάρια:

  • Χρήστης χωρίς όνομα χρήστη: πεδία BSUID και τηλεφωνικού αριθμού, και χωρίς όνομα χρήστη.
  • Χρήστης με όνομα χρήστη του οποίου ο αριθμός δεν είναι διαθέσιμος: όνομα χρήστη και BSUID, χωρίς πεδία τηλεφωνικού αριθμού.
  • Χρήστης με όνομα χρήστη του οποίου ο αριθμός είναι διαθέσιμος: όνομα χρήστη, BSUID και τηλεφωνικός αριθμός.
  • Ένα Business Portfolio εγγεγραμμένο σε γονικά BSUID: ένα γονικό BSUID δίπλα στο BSUID του ίδιου του Business Portfolio.

Πώς διαχειρίζεται το easyCoexistence τα BSUID;

Τα προωθεί όπως τα στέλνει η Meta. Ένας αριθμός που δρομολογείται στο endpoint σας με set_webhook_destination λαμβάνει τα webhooks messages και smb_message_echoes απευθείας από τη Meta, με user_id, from_user_id, to_user_id και username, και όταν τα automations ή η προώθηση είναι ενεργά, το easyCoexistence προωθεί αμετάβλητη την τιμή που έστειλε η Meta. Για να απαντήσετε σε BSUID, ο κώδικάς σας χρησιμοποιεί το get_api_credentials, που επιστρέφει το αναγνωριστικό του αριθμού (phone_number_id), το endpoint αποστολής του και, όταν είναι διαθέσιμο, το δικό σας token· τα εργαλεία send_message και send_template δέχονται τηλεφωνικό αριθμό σε ψηφία διεθνούς μορφής.

Συνηθισμένα λάθη

  • Αντιστοίχιση επαφών μόνο με το wa_id. Ένας χρήστης με όνομα χρήστη που δεν είχε επαφή με τον αριθμό για 30 ημέρες φτάνει μόνο με user_id και from_user_id, και ένας χειριστής που απαιτεί wa_id χάνει το μήνυμα.
  • Αλλοίωση του προθέματος χώρας ενός BSUID. Η Meta θέλει ολόκληρη την τιμή, με κωδικό χώρας και τελεία, και ένα αίτημα με οποιοδήποτε αλλαγμένο μέρος της αποτυγχάνει.
  • Αναμονή για πεδίο user_id_update. Η Meta δεν έχει τέτοιο πεδίο· οι αλλαγές BSUID φτάνουν στο messages ως μηνύματα συστήματος τύπου user_changed_number ή user_changed_user_id.
  • Αντιστοίχιση των echoes του Coexistence μόνο στο to. Στο smb_message_echoes το πεδίο to μπορεί να παραλείπεται, οπότε μια απάντηση που γράφεται στην εφαρμογή μένει αόρατη, εκτός αν αντιστοιχιστεί και το to_user_id.
Κάντε το με EasyCoexistence

Κάθε σύνδεση παρακολουθείται 24/7. Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες είναι δωρεάν δοκιμή.

Συχνές ερωτήσεις

Λαμβάνουν BSUID και οι χρήστες χωρίς όνομα χρήστη;

Ναι. Η Meta ορίζει το user_id στα webhooks messages είτε ο χρήστης έχει όνομα χρήστη είτε όχι, οπότε οι περισσότεροι χρήστες φτάνουν με τον τηλεφωνικό τους αριθμό και το BSUID τους μαζί.

Μπορεί ένας αριθμός Coexistence να έχει όνομα χρήστη επιχείρησης;

Ναι. Από τις 29 Ιουνίου 2026 μια επιχείρηση μπορεί να υιοθετήσει ή να αλλάξει ένα όνομα χρήστη στο Meta Business Suite, στο WhatsApp Manager, στην εφαρμογή WhatsApp Business ή μέσω του Username API. Δεν κρύβει τον επιχειρηματικό αριθμό, και το business_username_updates αναφέρει κάθε αλλαγή κατάστασης.

Λειτουργεί ένα BSUID σε διαφορετικά Business Portfolio;

Όχι. Ένα BSUID ανήκει σε ένα Business Portfolio και σε έναν χρήστη, και ένας αριθμός σε άλλο Business Portfolio δεν μπορεί να του στείλει μήνυμα. Τα διαχειριζόμενα Business Portfolio που εγγράφει η Meta λαμβάνουν γονικά BSUID, με ENT μετά τον κωδικό χώρας, που λειτουργούν σε όλα τα εγγεγραμμένα Business Portfolio τους.

Πόσο κοστίζει το easyCoexistence για έναν αριθμό WhatsApp;

Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, ανάλογα με το πόσες συνδέσεις έχετε, και οι πρώτες 3 ημέρες είναι δωρεάν. Οι χρεώσεις μηνυμάτων της ίδιας της Meta παραμένουν στη μέθοδο πληρωμής του WhatsApp Business Account σας.

Συνεχίστε την ανάγνωση

Έτοιμοι να ξεκινήσετε;

Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.

Ξεκινήστε δωρεάν δοκιμή

Επαληθεύτηκε στις