Account
/v1/account
Stiamo per ritirare l'API On-Premises. Questo endpoint non può più essere usato per registrare i numeri di telefono aziendali e ora restituisce il seguente errore:
{
"code": 1005,
"title": "Access denied",
"details": "Unknown error: biz_link_on_prem_reg_blocked"
}
Il nodo account è destinato alla registrazione del client dell'API di WhatsApp Business.
Il Coreapp si riavvia se viene registrato un nuovo numero su un cluster in cui è già registrato un altro numero.
Segmenti
A questo nodo sono collegati i segmenti di seguito:
| Segmento | Descrizione |
|---|---|
Dopo aver ricevuto il codice di registrazione tramite il metodo specificato, utilizza questo segmento per completare la registrazione del tuo account. |
Prima di iniziare
Ecco cosa dovrai fare:
- Token di autenticazione per poter accedere al servizio
- Un numero di telefono valido associato all'account WhatsApp Business
- Un nome visualizzato approvato da WhatsApp associato a tale numero di telefono
Copia del certificato con codifica base64
Viene generata una stringa del certificato con codifica base64, che viene utilizzata per la convalida durante la registrazione del client dell'API di WhatsApp Business.
- Vai alle Impostazioni business nel Business Manager di Meta.
- Clicca su Account WhatsApp nel menu Account e poi seleziona il tuo account WhatsApp dalla lista Account WhatsApp, se non è già evidenziato.
- Vai alla tab Impostazioni e clicca sul pulsante WhatsApp Manager.
- Sotto la tab Numeri di telefono dovrebbero essere elencati i tuoi numeri di telefono. Clicca sul pulsante Visualizza del numero di telefono per il quale desideri il certificato.
Ottenimento del certificato - Una finestra di dialogo pop-up mostrerà la stringa del certificato in una casella grigia. Clicca su Ottieni certificato.
Download della stringa del certificato - Utilizza questa stringa nel parametro
certdurante la registrazione con l'endpointaccount.
Consulta la documentazione sui Nomi visualizzati per maggiori informazioni.
Limitazioni
- Devi usare l'account
adminper registrare l'app. - Se stai registrando nuovamente il tuo account, Coreapp deve essere riavviato una volta completata la registrazione.
Richiesta
Effettua una chiamata POST a questo endpoint per richiedere un codice di registrazione. Nella chiamata, aggiungi il tuo numero di telefono e la stringa del certificato con codifica base64. Puoi ricevere il tuo codice tramite SMS o chiamata vocale.
Esempio
POST /v1/account
{
"cc": "COUNTRY_CODE",
"phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
"method": "sms" or "voice",
"cert": "VERIFIED_NAME_CERT_IN_BASE64",
"pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}
A seconda della risposta ricevuta, la procedura di registrazione può essere considerata completa o richiedere il completamento di un ulteriore passaggio. In caso di azione eseguita correttamente, ricevi uno dei seguenti codici di stato HTTP. Segui le istruzioni relative alla risposta ricevuta:
201 Created: l'account esiste già. Hai già effettuato la registrazione, quindi non devi fare nient'altro.202 Accepted: l'account non esiste. A seconda del metodo selezionato nella richiesta, controlla il numero fornito per l'SMS o la chiamata vocale per la ricezione del codice di registrazione. Questa risposta include un payload restituito contenente ilvnamedecodificato dal parametrocertper consentirti di confermare la corretta impostazione del nome visualizzato. Se è stato impostato correttamente, vai a Completamento della registrazione dell'account per completare la registrazione.
{
"account": [{
"vname": "decoded-vname-from-cert"
}]
}
Se vengono restituiti errori, consulta Messaggi di errore e di stato per ulteriori informazioni.
Parametri
| Nome | Descrizione |
|---|---|
| Obbligatorio. Prefisso internazionale numerico per il numero di telefono che stai registrando. |
| Obbligatorio. Numero di telefono che si sta registrando, senza il prefisso internazionale o il simbolo più ( |
| Obbligatorio. Metodo di ricezione del codice di registrazione |
| Obbligatorio. Certificato con codifica base64 |
| Facoltativo. PIN a 6 cifre esistente: richiesto solo quando sull'account è abilitata la verifica in due passaggi. |
Modifica del PIN di verifica in due passaggi
Per modificare il PIN di verifica in due passaggi del tuo numero di telefono aziendale segui questi passaggi:
- Carica il tuo portfolio business in WhatsApp Manager.
- Se la scheda Numeri di telefono non viene caricata automaticamente, vai a Strumenti per l'account (l'icona della cassetta degli strumenti) > Numeri di telefono.
- Clicca sull'icona delle impostazioni del numero di telefono (ingranaggio).
- Clicca su Verifica in due passaggi.
- Clicca su Modifica PIN e completa il flusso.
Devi fornire il tuo PIN attuale per modificarlo. Tieni presente che puoi anche impostare un nuovo PIN usando le nostre API:
Disabilitazione della verifica in due passaggi
Per disabilitare la verifica in due passaggi, segui la procedura per modificare il PIN, ma clicca sul pulsante Disattiva la verifica in due passaggi come operazione finale. Un'e-mail con un link verrà inviata all'indirizzo e-mail associato al tuo portfolio business. Usa il link per disabilitare la verifica in due passaggi. Una volta disabilitata, puoi riattivarla impostando un nuovo PIN.
FAQ
Sì, possiamo impostare un nuovo numero di telefono o modificare il nome verificato quando sei pronto per la pubblicazione.
I numeri verdi sono consentiti purché sia incluso il prefisso internazionale. Questo perché i numeri verdi senza prefisso internazionale non possono essere identificati in modo univoco: lo stesso numero può essere valido in due Paesi diversi.
Nota inoltre che sono state aggiunte delle complessità relativamente ai numeri verdi. In genere, se chiami un numero verde con il prefisso internazionale quando ti trovi all'interno del Paese, la chiamata non andrà a buone fine. Ciò significa che esiste la possibilità che i clienti che si trovano nel tuo Paese provino a comporre il numero riportato nei contatti aziendali (incluso il prefisso internazionale) e non siano in grado di raggiungerti. Se questo per te rappresenta un problema, dovrai comunicarlo esplicitamente.
Puoi consultare maggiori informazioni sui numeri verdi qui.
Se esegui il backup della configurazione corrente e la ripristini sul nuovo dispositivo, le informazioni di registrazione dovrebbero essere trasferite con il resto dell'implementazione. Consulta la documentazione su backup e ripristino delle impostazioni per ulteriori informazioni.
Puoi registrare nuovi numeri di telefono ed eliminare quello vecchio nel tuo account WhatsApp in Facebook Business Manager.
- Nell'Account WhatsApp, vai a Impostazioni.
- Clicca su WhatsApp Manager.
- Seleziona la scheda Numeri di telefono. Qui puoi gestire tutti i numeri di telefono di questo account.
Se la registrazione non va a buon fine con "sms" a causa di un numero eccessivo di tentativi e viene visualizzato il messaggio "accesso negato", prova a registrarti con la "chiamata vocale"
Sfortunatamente, dovrai scegliere un numero di telefono diverso in grado di ricevere SMS o chiamate vocali per consentirci di inviare il codice di registrazione. In passato, erano consentiti codici di registrazione manuale, ma questo non è più supportato. I numeri di telefono che in precedenza utilizzavano codici di registrazione manuale continueranno a essere supportati come richiesto. Per eventuali nuovi numeri di telefono, forniremo i codici di registrazione solo tramite SMS o chiamata vocale.
Se desideri usare un numero 1800 o un numero verde, leggi questa guida.