Gestione di numeri di telefono e certificati
Questa guida fornisce informazioni generali relative ai numeri di telefono per i partner di soluzioni e i clienti. Inoltre, contiene informazioni sulla procedura per i partner di soluzioni nel caso in cui essi debbano gestire il numero di telefono e i certificati di un cliente.
Informazioni preliminari sui numeri di telefono
Ci sono alcuni dettagli che le aziende devono conoscere sui numeri di telefono e sull'iscrizione integrata.
Le aziende hanno bisogno di un numero dedicato per utilizzare WhatsApp tramite l'iscrizione integrata. Se un'azienda ha un numero attivamente registrato su WhatsApp Messenger o sull'app WhatsApp Business, non può utilizzare lo stesso numero di telefono.
Le aziende possono avere più numeri di telefono associati al proprio account business di Meta, quindi devono semplicemente aggiungere un altro numero di telefono e usarlo per WhatsApp.
Un'azienda non può iscriversi utilizzando il flusso di iscrizione integrata con un numero di telefono che è già stato registrato con le versioni dell'app di tipo business o consumatore di WhatsApp.
Per informazioni più dettagliate relative ai numeri di telefono e alla piattaforma WhatsApp for Business, consulta Numeri di telefono.
Per informazioni su come effettuare la migrazione di un numero di telefono WhatsApp registrato esistente, consulta Migrazione del numero di telefono.
Istruzioni per i clienti
Questa sezione è rivolta ai clienti dell'iscrizione integrata e fornisce indicazioni sulle azioni che possono eseguire in relazione ai numeri di telefono.
Aggiunta di numeri di telefono a un account WhatsApp Business
Esistono due metodi per aggiungere altri numeri a un account WhatsApp Business:
- [Consigliato] Completa nuovamente il flusso di iscrizione integrata, seleziona Business Manager e account WhatsApp Business esistenti, aggiungi il numero e verificalo.
- In Business Manager, accedi alla tab Numeri di telefono di WhatsApp Manager e seleziona Aggiungi numero di telefono. Con questa opzione, il partner di soluzioni deve verificare manualmente il numero di telefono poiché la verifica del telefono non è disponibile in Business Manager. Per questo motivo, si consiglia alle aziende di seguire il flusso di iscrizione integrata per aggiungere altri numeri.
Istruzioni per i partner di soluzioni
Questa sezione è rivolta ai partner di soluzioni e fornisce istruzioni per la gestione dei numeri di telefono e dei certificati dei clienti.
Registrazione dei numeri di telefono per l'API Cloud
A seguito di una verifica corretta del numero di telefono dal flusso di iscrizione integrata, la registrazione dovrebbe avere esito positivo con una chiamata API all'endpoint register. Per eseguire questa operazione, indica un code_method qualsiasi (sms | voice). Poiché il numero di telefono è già stato verificato, non devi preoccuparti del codice di registrazione. La chiamata API verify non è obbligatoria.
In alternativa, puoi pre-verificare i numeri di telefono e offrirli ai tuoi clienti nel nuovo flusso di iscrizione integrata. In questo modo, non dovranno contattarti per richiedere una password monouso durante la procedura di registrazione. Consulta Numeri di telefono pre-verificati.
Registrazione dei numeri di telefono per On-Premises
A seguito di una verifica corretta del numero di telefono dal flusso di iscrizione integrata, la registrazione dovrebbe avere esito positivo con una chiamata API all'endpoint account. Per eseguire questa operazione, indica un code_method qualsiasi (sms | voice). Dato che il numero di telefono è già verificato, non devi preoccuparti del codice di registrazione. La chiamata API verify non è obbligatoria.
In alternativa, puoi pre-verificare i numeri di telefono e offrirli ai tuoi clienti nel nuovo flusso di iscrizione integrata. In questo modo, non dovranno contattarti per richiedere una password monouso durante la procedura di registrazione. Consulta Numeri di telefono pre-verificati.
Un numero di telefono deve essere registrato fino a 14 giorni dopo il completamento del flusso di iscrizione incorporata. Se il numero non viene registrato durante tale finestra temporale, deve essere sottoposto di nuovo al flusso di iscrizione incorporata prima della registrazione.
Acquisizione dello stato e del certificato del numero di telefono
L'endpoint phone_numbers ti consente di vedere lo stato del nome visualizzato di un numero di telefono e di recuperare il certificato dopo una modifica del nome. Consulta Leggere i numeri di telefono per maggiori informazioni.
Esempio di richiesta
Nell'esempio seguente, usa l'ID per l'account WhatsApp Business assegnato.
curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
?fields=
display_phone_number,
certificate,
name_status,
new_certificate,
new_name_status
&access_token={system-user-access-token}"Esempio di risposta
{
"data": [
{
"id": "1972385232742141",
"display_phone_number": "+1 631-555-1111",
"last_onboarded_time": "2023-08-22T19:05:53+0000",
"certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
"new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
"name_status": "APPROVED",
"new_name_status": "APPROVED",
}
]
}
Parametri della risposta
| Nome | Descrizione |
|---|---|
| Lo stato del controllo della richiesta del nome visualizzato attuale. Clicca sulla freccia nella colonna sinistra per le opzioni disponibili. |
| Lo stato del controllo di una richiesta di modifica del nome visualizzato. Questo campo restituisce dati solo se è stata inviata una richiesta di modifica del nome visualizzato. |
| Restituisce il certificato attuale per il numero di telefono. |
| Il certificato di un nuovo nome visualizzato, dopo l'approvazione di una modifica del nome visualizzato. Questo campo restituisce i dati solo se la richiesta di modifica del nome visualizzato è stata approvata ed è disponibile fino alla registrazione del numero di telefono con il nuovo certificato. |
Acquisizione dello stato OTP del telefono
Per sapere se un numero di telefono è stato verificato tramite OTP (password monouso), controlla il campo code_verification_status di quello specifico numero. Innanzitutto, effettua una chiamata GET all'endpoint /{whatsapp-business-account-id}/phone_numbers:
curl -i -X GET \
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
?access_token={your-access-token}"
La risposta include code_verification_status con una delle seguenti opzioni: VERIFIED o NOT_VERIFIED. Un esempio di risposta è simile a questo:
[
{
"code_verification_status": "NOT_VERIFIED",
"id": "1754951608042154"
}
]
In alternativa, puoi conoscere lo stato chiamando l'ID di un numero di telefono:
curl -i -X GET \
"https://graph.facebook.com/v21.0/{phone-number-id}
?access_token={your-access-token}"
https://graph.facebook.com/v21.0/{whatsapp-business-account-ID}/phone_numbers. Sostituisci {whatsapp-business-account-ID} con l'ID dell'account WhatsApp Business a cui è associato il numero di telefono. Per un esempio, consulta Recupero dei numeri di telefono.
Filtraggio dei numeri di telefono per modalità account
Puoi inviare query sui numeri di telefono e filtrarli in base all'account_mode. Per la richiesta, puoi usare i parametri elencati di seguito.
Parametri della richiesta
| Nome | Descrizione |
|---|---|
| Contiene il campo utilizzato per il filtro. In questo esempio, devi usare |
| Contiene il modo in cui desideri filtrare gli account. In questo esempio, devi usare |
| Contiene la modalità account che stai cercando. Clicca sulla freccia nella colonna sinistra per i valori supportati. |
Esempio di richiesta
Nell'esempio seguente, usa l'ID per l'account WhatsApp Business assegnato.
curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
?filtering=[{
"field":"account_mode",
"operator":"EQUAL",
"value":"SANDBOX"}]
&access_token={system-user-access-token}"
Esempio di risposta
{
"data": [
{
"id": "1972385232742141",
"display_phone_number": "+1 631-555-1111",
"verified_name": "John’s Cake Shop",
"quality_rating": "UNKNOWN",
}
],
"paging": {
"cursors": {
"before": "abcdefghij"
"after": "klmnopqr"
}
}
}