ID utente specifici per azienda

Un ID utente specifico per azienda (BSUID) ti permette di scrivere a un utente WhatsApp senza il suo numero di telefono. Identifica l'utente all'interno del tuo portfolio business di Meta.

Nomi utente WhatsApp

Gli utenti WhatsApp con un nome utente possono scriverti senza condividere il numero di telefono. I loro messaggi includono from.bsuid; from.phone_number può mancare. Anche gli utenti senza nome utente possono avere un BSUID.

Meta include il numero di telefono se l'utente è nella tua rubrica Meta o ha scambiato messaggi o chiamate con il tuo numero aziendale negli ultimi 30 giorni. La regola dei 30 giorni si applica a ciascun numero aziendale.

from.username e from.display_name sono facoltativi. Non puoi inviare messaggi a nessuno dei due valori.

Formato del BSUID

Un BSUID contiene un codice paese ISO 3166 alpha-2 in maiuscolo, un punto e fino a 128 lettere o cifre. Ad esempio: US.13491208655302741918.

Salva e invia il valore completo senza modificarlo. Usa un numero mittente dello stesso portfolio business. Meta rifiuta i messaggi inviati da altri portfolio.

Il BSUID cambia quando l'utente cambia numero di telefono, quindi salvalo sotto il tuo ID cliente.

Un BSUID principale funziona nei portfolio registrati da un'azienda gestita. Aggiunge ENT. dopo il codice paese: US.ENT.11815799212886844830. Il limite di 128 caratteri si applica alla parte dopo ENT.. Bird accetta entrambi i formati.

Richiedere un numero di telefono

Questi esempi dell'API di messaggistica mostrano solo i campi necessari per questo scambio.

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918"
  },
  "to": {
    "phone_number": "+14155550100"
  },
  "text": {
    "body": "Can I book a repair?"
  }
}

{
  "direction": "outbound",
  "from": {
    "phone_number": "+14155550100"
  },
  "to": {
    "bsuid": "US.13491208655302741918"
  },
  "interactive": {
    "type": "request_contact_info",
    "body_text": "Share your number."
  }
}

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918",
    "phone_number": "+14155550101"
  },
  "contact_cards": [
    {
      "origin": "contact_request",
      "phone_numbers": [
        {
          "phone_number": "+14155550101"
        }
      ]
    }
  ]
}

Se l'utente chiude la richiesta, non ricevi né un messaggio né un webhook. Imposta un timeout per consentire alla tua app di continuare senza il numero.

Inviare un messaggio

Imposta to sul BSUID e from sul tuo numero aziendale WhatsApp:

{
  "to": "US.13491208655302741918",
  "from": "+14155550100",
  "text": { "body": "Your repair is booked." }
}

Se il messaggio in arrivo contiene solo un BSUID, rispondi a quel BSUID dallo stesso numero aziendale. Un numero di telefono nei tuoi archivi potrebbe non avere una finestra di servizio aperta e causare 422 E15044.

• I modelli di autenticazione richiedono un numero di telefono.
• Un numero di telefono o BSUID non valido restituisce 422 E15001.
• Il prezzo del messaggio dipende dal codice paese del BSUID.

La finestra di assistenza clienti si applica anche ai BSUID. Una risposta 202 indica che l'API ha accettato la richiesta. Controlla lo stato del messaggio per confermare la consegna.

Trovare messaggi

Nei messaggi e nei webhook, from identifica il mittente e to il destinatario. Ciascuno può contenere phone_number, bsuid o entrambi.

Per elencare i messaggi, filtra per:

• from o to per un mittente o destinatario, usando il numero di telefono o BSUID.
• bsuid per i messaggi inviati allo stesso utente WhatsApp o ricevuti da lui.

Il filtro phone_number è deprecato. Usa from o to al suo posto.

Guide correlate

• Ricevere schede contatto
• Richieste di informazioni di contatto WhatsApp
• Inviare messaggi WhatsApp
• Riferimento Meta sugli ID utente specifici per azienda