Business-scoped user ID

Perché un contatto arriva senza numero di telefono

Aspetto di un BSUID

{
  "from": {
    "bsuid": "US.13491208655302741918",
    "username": "alexr",
    "display_name": "Alex Rivera"
  }
}

• Passa l'intero valore, senza modifiche. Meta rifiuta un BSUID modificato, quindi nessuna parte è facoltativa: il codice paese, il punto e ogni carattere dell'identificativo viaggiano insieme. Bird valida la forma prima di accettare un invio, e il codice paese deve essere maiuscolo e un codice ISO 3166 alpha-2 reale; un prefisso minuscolo o sconosciuto viene rifiutato, non corretto. Il limite di 128 caratteri si applica all'identificativo dopo il codice paese, e dopo il segmento ENT. in un parent BSUID.
• È circoscritto a un portfolio aziendale. Qualsiasi numero di telefono aziendale nello stesso portfolio può inviare messaggi a quel BSUID; un numero in un portfolio diverso no, e l'invio fallisce.
• Non è permanente. Meta documenta che il BSUID di un contatto viene rigenerato quando cambia numero di telefono, quindi identifica un interlocutore anziché fungere da chiave cliente duratura.

Come si svolge di solito una conversazione

1. Il contatto ti scrive. Il messaggio in entrata porta from.bsuid, e from.phone_number può essere assente. Quel messaggio apre la finestra di assistenza clienti, e puoi rispondere liberamente per le 24 ore successive.
2. Chiedi il numero. Invia una richiesta di informazioni di contatto, un singolo pulsante che consente al contatto di condividere un numero di telefono. La stessa richiesta può viaggiare su un template tramite il suo pulsante request_contact_info, che raggiunge un contatto la cui finestra si è chiusa.
3. Il contatto tocca il pulsante. Il numero condiviso arriva come scheda contatto in entrata con origin impostato su contact_request e il numero in phone_numbers. Una scheda contatto condivisa può descrivere un'altra persona o un altro numero. Conserva quei dati condivisi separatamente dall'identità WhatsApp del mittente; usa le identità effettivamente fornite nei messaggi successivi invece di sovrascrivere il record cliente basandoti solo sulla scheda.

Invio a un BSUID

{
  "to": "US.13491208655302741918",
  "from": "+13124495648",
  "text": { "body": "Your order shipped." }
}

• from deve trovarsi nel portfolio a cui il BSUID è circoscritto. È lo stesso requisito di portfolio che Meta applica, e una mancata corrispondenza fallisce a livello di WhatsApp anziché in fase di accettazione.
• I template per codici di verifica monouso richiedono un numero di telefono. Un template gestito da Bird nella categoria authentication, o uno che contiene un pulsante per codice di verifica monouso, viene rifiutato in fase di accettazione con un 422 E15014 WhatsAppRecipientNotSupportedForTemplate. Un template creato dal tuo spazio di lavoro non viene verificato in fase di accettazione: Meta richiede un numero di telefono per i template di autenticazione one-tap, zero-tap e copy-code, quindi un invio di questo tipo viene accettato e poi fallisce.
• Un valore che non è né un numero di telefono né un BSUID ben formato viene rifiutato in fase di accettazione, con un 422 E15001 WhatsAppInvalidRecipient.
• Il prezzo si basa sul prefisso paese del BSUID. Un numero di telefono fornisce il paese su cui viene calcolato il prezzo del messaggio; per un invio tramite BSUID, il prefisso di due lettere lo fornisce al suo posto.

Lettura e filtro per BSUID

• Su un messaggio, from e to contengono ciascuno un phone_number, un bsuid, o entrambi. Un messaggio in entrata indica il contatto su from; uno in uscita lo indica su to.
• Su un webhook, gli stessi indirizzi viaggiano sul payload dell'evento. Vedi eventi WhatsApp per la struttura.
• Nell'elenco messaggi, to e from accettano ciascuno un BSUID oltre che un numero di telefono, e ciascuno corrisponde a un'estremità del messaggio. Il filtro bsuid corrisponde al contatto in entrambe le direzioni. Il filtro precedente phone_number è deprecato: to e from lo sostituiscono e corrispondono a entrambi i tipi di identità.

Prossimi passi

• Ricezione di schede contatto: il tipo di contenuto con cui arriva il numero condiviso
• Richieste di informazioni di contatto WhatsApp: il pulsante che lo chiede
• Invio di messaggi WhatsApp: la struttura della richiesta, il modello 202 e come riprovare in sicurezza
• Riferimento business-scoped user IDs di Meta: il rollout, i parent BSUID e le altre superfici Meta