Registrazione
Per usare il tuo numero di telefono aziendale con l'API Cloud devi registrarlo. Registra il tuo numero di telefono aziendale nei seguenti scenari:
- Creazione di account: quando implementi questa API, devi registrare il numero di telefono aziendale che intendi usare per l'invio di messaggi. Applichiamo l'impostazione della verifica in due passaggi durante la creazione di account per aggiungere un ulteriore livello di sicurezza a quegli account.
- Cambio nome: in questo caso, il tuo telefono è già registrato e vuoi cambiare il nome visualizzato. Per farlo, come prima cosa devi richiedere una modifica del nome su WhatsApp Manager. Una volta approvato il nome, devi registrare nuovamente il tuo telefono con il nuovo nome.
- Migrazione del tuo numero dall'API On-Premises all'API Cloud. Vedi Eccezione per la migrazione.
Prima di poter registrare il tuo numero di telefono aziendale, devi verificarne la proprietà.
Eccezione per la migrazione
Per eseguire la migrazione di un numero di telefono dall'API On-Premises all'API Cloud, devi completare passaggi aggiuntivi prima di registrare il numero di telefono con l'API Cloud. Per la procedura completa, consulta Migrazione tra l'API On-Premises e l'API Cloud.
Registrare un numero di telefono
Per registrare il tuo numero di telefono aziendale verificato, effettua una chiamata POST a PHONE_NUMBER_ID/register. Includi i parametri elencati sotto.
| Endpoint | Autenticazione |
|---|---|
(Consulta Acquisizione dell'ID del numero di telefono) |
Solution Partners must authenticate themselves with an access token with the |
Limitazioni
Le richieste all'endpoint di registrazione sono limitate a 10 per numero aziendale in una finestra mobile di 72 ore.
Quando fai una richiesta di registrazione, verifichiamo quante richieste hai inviato per registrare quel numero nelle ultime 72 ore. Se hai già fatto 10 richieste, l'API restituisce il codice di errore 133016 e la registrazione del numero non sarà consentita per le successive 72 ore.
Parametri
| Nome | Descrizione |
|---|---|
| Obbligatorio. Servizio di messaggistica utilizzato. Invialo a |
| Obbligatorio. Se il tuo numero di telefono aziendale verificato ha già abilitato la verifica in due passaggi, imposta questo valore sul PIN di verifica in due passaggi a 6 cifre del tuo numero. Se non riesci a ricordare il PIN, puoi aggiornarlo. Se il tuo numero di telefono aziendale verificato non ha abilitato la verifica in due passaggi, imposta questo valore su un numero a 6 cifre. Sarà il PIN di verifica in due passaggi del numero di telefono aziendale appena verificato. |
| Facoltativo. Se incluso, abilita la memorizzazione locale sul numero di telefono aziendale. Il valore deve essere un codice Paese di 2 lettere in conformità alla norma ISO 3166 (ad es. Valori supportati: APAC
Europa
LATAM
MEA
NORAM
Una volta abilitati, non possono essere disabilitati o modificati direttamente. Occorre annullare la registrazione del numero, poi registrarlo di nuovo senza il parametro (se vuoi disabilitarlo) oppure includendo il parametro con il nuovo codice Paese (se vuoi modificarlo). Per abilitare la memorizzazione locale su un numero già registrato, devi annullare la registrazione del numero, poi registrarlo di nuovo e includere questo parametro. |
Richiesta di esempio senza memorizzazione locale
curl 'https://graph.facebook.com/v19.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834"
}
Richiesta di esempio con memorizzazione locale
curl 'https://graph.facebook.com/v19.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834",
"data_localization_region": "CH"
}
All API calls require authentication with access tokens.
Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.
Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.
Annullare la registrazione di un numero di telefono aziendale
Annullando la registrazione di un numero di telefono aziendale, questo non sarà più utilizzabile con l'API Cloud e la memorizzazione locale sul numero sarà disabilitata, se precedentemente abilitata.
L'annullamento della registrazione non elimina il numero né la relativa cronologia dei messaggi. Per eliminare un numero e la relativa cronologia, consulta Eliminazione di un numero di telefono da un account WhatsApp Business.
Per annullare la registrazione di un numero di telefono aziendale, effettua una chiamata POST a PHONE_NUMBER_ID/deregister:
| Endpoint | Autenticazione |
|---|---|
(Consulta Acquisizione dell'ID del numero di telefono) |
Solution Partners must authenticate themselves with an access token with the |
Limitazioni
Le richieste all'endpoint di annullamento della registrazione sono limitate a 10 per numero aziendale in una finestra mobile di 72 ore.
Quando fai una richiesta di annullamento della registrazione, verifichiamo quante richieste hai inviato per l'annullamento della registrazione del numero nelle ultime 72 ore. Se hai già fatto 10 richieste, l'API restituisce il codice di errore 133016 e l'annullamento della registrazione del numero sarà impedita per le successive 72 ore.
Esempio
Esempio di richiesta:
curl -X POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/deregister' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Una risposta positiva ha un aspetto simile a questo:
{
"success": true
}