Risoluzione dei problemi della coesistenza di WhatsApp

La configurazione della coesistenza avviene nella finestra di Meta. Dopo che hai inserito il numero, è Meta a decidere se segue il percorso dell'app WhatsApp Business, quindi non devi attivare nulla prima nel tuo spazio di lavoro Bird. Collega il tuo numero dell'app WhatsApp Business descrive una configurazione riuscita.

Le sezioni riportano i messaggi di Meta e il codice dopo #, quindi cerca quello che ti mostra Meta. Per i problemi che riguardano anche i numeri collegati senza l'app, come il controllo di sicurezza di Meta o un account aziendale bloccato, consulta Risoluzione dei problemi dei numeri WhatsApp.

Per cercare un codice non trattato in questa pagina, consulta Errori di connessione e coesistenza di WhatsApp.

Se Meta mostra "Bird B.V. can't onboard customers right now" o "Bird B.V. can't onboard customers at the moment", riprova più tardi.

Meta mostra le opzioni Text message e Phone call

Dopo che hai inserito il numero, il passaggio del telefono di Meta elenca le opzioni di verifica Text message e Phone call. Sembra la configurazione standard del numero e il codice QR non compare ancora.

Questa schermata è normale. Meta mostra lo stesso passaggio del telefono prima di passare al percorso dell'app WhatsApp Business.

1. Scegli Enter a new phone number e digita il numero che usi nell'app WhatsApp Business. Se Meta indica il tuo numero come non idoneo alla condivisione, ignora quella voce e digita il numero.
2. Lascia invariata l'opzione di verifica e seleziona Next.
3. Prosegui con il profilo aziendale e il portafoglio aziendale. Il codice QR compare dopo questi passaggi.

Se una schermata successiva ti chiede di inserire un codice a sei cifre, Meta ha avviato la registrazione standard. Chiudi la finestra e segui Meta chiede un codice di verifica a sei cifre.

Meta indica che il tipo di account non supporta la condivisione con i partner

Dopo che hai inserito il numero, Meta mostra questo messaggio nel passaggio del telefono (#2655115): "This account type doesn't support partner sharing. Contact support for options."

Se il numero usa l’app WhatsApp Business, controlla quale percorso hai scelto in Bird. Set up a number avvia la configurazione standard del numero. Per continuare a usare l’app, scegli Keep using the Business app:

1. Chiudi la finestra di Meta.
2. In Bird, scegli New number, poi Keep using the Business app, e ricomincia.

Se il numero non usa l’app WhatsApp Business, oppure l’errore persiste nel percorso per l’app, contatta l’assistenza indicando il codice di Meta e il Session ID mostrato in Bird.

Meta non riesce a caricare le informazioni di associazione

Meta interrompe la connessione dell'app WhatsApp Business con l'errore #4563004.

Riprova.

Meta segnala autorizzazioni mancanti per l’associazione

Meta segnala autorizzazioni Graph API mancanti per l’associazione di dispositivi complementari tramite Cloud API (#4563039).

Un account di messaggistica di tipo WhatsApp Business App rimasto da un tentativo precedente può causare questo errore. Il numero appare come Offline in quell'account. L'app di Bird dispone delle autorizzazioni necessarie.

1. In Meta Business Suite, apri l'account di messaggistica di tipo WhatsApp Business App che mostra il tuo numero come Offline. Questo account non ha la scheda Two-step verification.
2. Scegli Remove from business portfolio. Se l'account risulta ancora elencato come disattivato, rimuovilo di nuovo.
3. Attendi 5 minuti, poi collega di nuovo il numero a Bird.

Meta indica che il numero è già registrato su un account WhatsApp

Appena digiti il numero, Meta mostra questo messaggio sotto il campo del telefono (#2494064): "This phone number is already registered to a WhatsApp account. To use this number, disconnect it from the existing account. Then, return to this page and try again. It can take up to 3 minutes for the number to refresh."

Di solito questo errore indica che il numero è registrato in WhatsApp, l'app personale, e non nell'app WhatsApp Business. La coesistenza collega account dell'app WhatsApp Business, quindi Meta rifiuta un numero WhatsApp personale.

1. Sul telefono, verifica in quale app è registrato il numero.
2. Se è WhatsApp, trasferisci l'account nell'app WhatsApp Business. La guida di WhatsApp su come trasferire l'account WhatsApp Messenger a WhatsApp Business spiega come eseguire il backup e trasferire le chat.
3. In Bird, scegli New number, poi Keep using the Business app, e ricomincia.

Non eliminare l'account per scollegare il numero, come suggerisce il messaggio. Eliminandolo si cancellano le sue chat, e la coesistenza richiede che il numero resti nell'app WhatsApp Business.

Se il numero è già attivo nell'app WhatsApp Business, Meta non lo sta trattando come un numero dell'app Business. Lo stesso vale quando Meta mostra #2388091 o #2655095, oppure quando non compare alcun passaggio con il codice QR:

1. Aggiorna l'app WhatsApp Business all'ultima versione.
2. Nell'app, disattiva la verifica in due passaggi.
3. In WhatsApp Manager, apri Phone numbers ed elimina qualsiasi voce del numero contrassegnata come in sospeso o scollegata. Se Bird mostra il numero come Failed, scollegalo anche in Bird.
4. Attendi 5 minuti.
5. In Bird, scegli New number e ricomincia. La finestra di dialogo seleziona Set up a number per impostazione predefinita, quindi passa prima a Keep using the Business app.

Se il percorso è corretto, Meta mostra Verify your account details e poi un codice QR. Se invece Meta chiede un codice a sei cifre, segui Meta chiede un codice di verifica a sei cifre.

Meta chiede un codice di verifica a sei cifre

Dopo che selezioni Next nel passaggio del telefono, una schermata successiva ti chiede di digitare un codice a sei cifre che Meta ha inviato tramite SMS o chiamata. Non compare alcun codice QR.

Le opzioni Text message e Phone call nel passaggio del telefono sono previste, e lì selezioni Next. Se una schermata successiva ti chiede di digitare il codice, Meta ha avviato la registrazione standard del numero invece del percorso dell'app WhatsApp Business. Lascia vuoto il codice, chiudi la finestra di Meta e controlla una volta questi punti:

1. In Bird, scegli Keep using the Business app prima di selezionare Connect WhatsApp.
2. Aggiorna l'app WhatsApp Business all'ultima versione. Meta richiede la versione 2.24.17 o successiva.
3. Nell'app, apri Settings > Account > Business Platform. Se è collegata una piattaforma aziendale, scollegala e attendi 15 minuti.
4. In WhatsApp Manager, apri Phone numbers e cerca una voce per il numero contrassegnata come disconnessa, in sospeso o non verificata. Apri la relativa scheda Two-step verification e seleziona Turn off two-step verification, in modo che il numero possa registrarsi di nuovo senza il suo PIN. Poi elimina la voce.
5. Ricomincia in Bird da un computer con Chrome o Safari.

Meta non riesce a inviare un codice di verifica

Meta mostra "Request code failed: Our servers are temporarily unavailable..." (#2388091) nel passaggio di verifica del telefono.

Questo errore proviene dal passaggio del codice della registrazione standard del numero, quindi la registrazione non segue il percorso dell'app WhatsApp Business. Richiedere un altro codice non collega il numero in coesistenza. Esegui i controlli indicati in Meta chiede un codice di verifica a sei cifre, poi ricomincia.

Meta chiede di contattare Bird B.V. dopo la scansione del codice QR

Scansioni il codice QR e la finestra di Meta indica di contattare il partner Bird B.V. per risolvere il problema di connessione del numero di telefono. Il numero non compare in Bird.

Una voce per il numero creata da un tentativo precedente è ancora presente in un WhatsApp Business Account e blocca la connessione dell'app WhatsApp Business.

1. Nell'app WhatsApp Business, apri Settings > Account > Business Platform. Se è collegata una piattaforma aziendale, scollegala e attendi 15 minuti.
2. In WhatsApp Manager, apri Phone numbers e trova la voce per il numero contrassegnata come disconnessa, in sospeso o non verificata.
3. Apri la scheda Two-step verification della voce e seleziona Turn off two-step verification, così il numero potrà registrarsi di nuovo senza il suo PIN. Poi elimina la voce.
4. In Bird, scegli New number, poi Keep using the Business app, e ricomincia.

Il numero mostra Failed con Cannot Create Certificate

Dopo la configurazione di Meta, il numero in Bird mostra Failed con "Cannot Create Certificate: This number is registered to an existing WhatsApp account."

Meta ha eseguito il tentativo come registrazione standard del numero, che non accetta un numero attivo nell'app WhatsApp Business. Il tentativo ha anche lasciato una voce per il numero in WhatsApp Manager, che blocca il tentativo successivo.

1. Disconnetti il numero non riuscito in Bird.
2. In WhatsApp Manager, apri Phone numbers e trova la voce del numero contrassegnata come disconnessa, in sospeso o non verificata.
3. Apri la scheda Two-step verification della voce e seleziona Turn off two-step verification, così il numero potrà registrarsi di nuovo senza il suo PIN. Poi elimina la voce.
4. Attendi qualche minuto, poi in Bird scegli New number, poi Keep using the Business app, e ricomincia.

Meta segnala un errore di idoneità

Meta controlla ogni numero quando lo inserisci. Non pubblica un elenco dei paesi supportati e Bird non può verificare in anticipo l'idoneità di un numero. Il riferimento di Meta sugli errori di onboarding dell'app Business elenca la maggior parte di questi messaggi:

Meta indica che il numero non è idoneo alla registrazione o alla migrazione

Meta mostra "This phone number is not eligible to register or migrate." (#3441034). La finestra di Meta può anche elencare il tuo account dell'app WhatsApp Business con l'etichetta Ineligible.

La voce Ineligible è prevista e non devi eliminare l'app WhatsApp Business.

1. Non selezionare la voce Ineligible. Inserisci invece il numero di telefono.
2. Nell'app WhatsApp Business, apri le impostazioni di Facebook e Instagram e scollegali entrambi. A seconda della versione dell'app, si trovano in Settings o in Business tools.
3. Sulla tua Pagina Facebook, apri Settings > Linked accounts e verifica che WhatsApp mostri Not connected.
4. Accedi a Meta con un account Facebook che ha il controllo completo del portfolio aziendale a cui appartiene il numero.
5. In Meta Business Suite, apri Settings > Accounts > Messaging accounts. Se è elencato un account WhatsApp per il numero, verifica che nient'altro lo usi, poi seleziona ⋯ > Remove from business portfolio. Se l'account risulta ancora elencato come disattivato, rimuovilo di nuovo. La rimozione non influisce sul numero nell'app WhatsApp Business.
6. In Bird, scegli New number, poi Keep using the Business app, inserisci il numero e scansiona il codice QR.

Meta indica che il numero è già usato da un altro account

Vuoi continuare a usare il numero nell'app WhatsApp Business, ma Meta indica che è già usato da un altro account.

Il numero è ancora collegato a Facebook o Instagram. Scollegalo nell'app WhatsApp Business, nelle impostazioni di Facebook e Instagram, e sulla tua Pagina Facebook in Settings > Linked accounts, in modo che WhatsApp mostri Not connected. Poi ricomincia in Bird con Keep using the Business app.

Meta segnala che la deregistrazione è in corso

Meta rifiuta il numero con #3441055. Il numero è ancora in fase di rimozione dalla connessione precedente, e Meta lo accetta di nuovo quando la rimozione termina. Attendi, poi ricomincia in Bird.

Meta segnala un Business AI agent o eventi automatici

Meta rifiuta il numero con #3441060 o #3441061. Il numero è ancora collegato a un Business AI agent o a eventi automatici nell'app WhatsApp Business.

1. Nell'app, scollega l'agente Business AI.
2. Disattiva gli elenchi automatici indicati nel messaggio di Meta in Business tools > Lists.
3. In Bird, scegli New number, poi Keep using the Business app, e ricomincia.

Meta segnala che manca la valutazione CoEx gate

Meta interrompe la configurazione con un messaggio che indica che manca la valutazione CoEx gate. Si tratta del controllo di sicurezza di Meta sul tuo account Facebook, che non è stato completato. Completa la richiesta descritta in Meta ti chiede di confermare la tua identità, poi ricomincia con il portfolio aziendale a cui appartiene il numero.

Meta segnala che non hai l'autorizzazione per visualizzare questa risorsa

Meta mostra "You don't have the necessary permissions to view this asset. Contact the asset owner to get permission or complete this action with the owner's account." (#3441038), di solito subito dopo che hai inserito il numero.

L'account Facebook con cui hai effettuato l'accesso non può aprire il portfolio aziendale che Meta associa al numero.

1. Accedi a Meta con un account Facebook che ha il controllo completo del portfolio aziendale a cui appartiene il tuo account dell'app WhatsApp Business.
2. Nell'app WhatsApp Business, apri le impostazioni di Facebook e Instagram. A seconda della versione dell'app, si trovano in Settings o in Business tools. Se non è collegata alcuna Pagina Facebook, collega la Pagina della tua azienda, poi ricomincia.
3. Se il numero appartiene a un portfolio a cui nessuno del tuo team può accedere, recupera l'accesso tramite Meta. Bird non può vederlo né svincolarlo.

Il numero risulta collegato nell'app WhatsApp Business ma non compare in Bird

L'ultima schermata di Meta indica che il tuo account è collegato a Bird B.V. e l'app elenca Bird B.V. in Business Platform, ma Numbers in Bird non mostra il numero. Bird può anche mostrare "Meta did not complete the app connection. Start the flow again."

Bird aggiunge il numero quando la finestra di Meta restituisce il risultato alla pagina di Bird che l'ha aperta. Un browser del telefono o interno a un'app, un pop-up bloccato, una pagina di Bird ricaricata o una finestra chiusa prima dell'ultimo pulsante di Meta possono impedire che il risultato arrivi a Bird.

1. Usa un computer con Chrome o Safari e consenti i pop-up per bird.com.
2. In Bird, scegli New number, poi Keep using the Business app, e seleziona Connect WhatsApp.
3. Tieni aperta la pagina di Bird e non ricaricarla mentre la finestra di Meta è aperta.
4. Nell'ultima schermata di Meta, seleziona Continue to feature setup. Se invece chiudi la finestra, Bird può restare senza il risultato.

Ogni tentativo scollega i dispositivi collegati all'app, quindi ricollegali quando il numero mostra Connected.

Il numero non si collega per una valuta non corrispondente

Il numero mostra Failed con credit_currency_mismatch e un messaggio come "This WhatsApp Business Account already bills in BRL, and the credit line we attach bills in USD, EUR, or GBP."

Bird paga Meta per i messaggi inviati tramite Bird con una linea di credito in USD, EUR o nella valuta di fatturazione della tua organizzazione, GBP in questo esempio. Meta consente una valuta per WhatsApp Business Account. La coesistenza collega l’account già usato dalla tua app WhatsApp Business, quindi scegliere un nuovo account durante la configurazione non evita la mancata corrispondenza.

Prova prima a cambiare la valuta dell'account esistente:

1. Scollega il numero non riuscito in Bird e scollega Bird B.V. nell'app WhatsApp Business in Settings > Account > Business Platform.
2. In Meta Business Suite, apri le impostazioni aziendali del WhatsApp Business Account e rimuovi il suo metodo di pagamento.
3. Imposta la valuta dell’account su una delle valute indicate nel messaggio di Bird.
4. In Bird, scegli New number, poi Keep using the Business app, e ricomincia.

Se Meta non ti consente di cambiare la valuta, il numero non può collegarsi a Bird tramite coesistenza finché il suo account viene fatturato in una valuta non indicata nel messaggio di Bird. Contatta l’assistenza per discutere le opzioni disponibili.

Le modifiche al profilo aziendale restituiscono E15088

Se aggiorni il profilo aziendale di un numero in coesistenza dagli strumenti CLI o MCP, ricevi 412 con E15088: "This number's business profile is managed in the WhatsApp Business app and cannot be updated through the API." Nella dashboard, la sezione Business profile del numero mostra i dettagli con la modifica disattivata e la nota "Manage this profile in the WhatsApp Business app". La lettura del profilo funziona.

Meta non supporta le modifiche al profilo aziendale tramite API per i numeri dell'app WhatsApp Business, quindi ogni nuovo tentativo restituisce lo stesso errore. Modifica nome, descrizione, indirizzo, sito web o foto nell'app WhatsApp Business, in Business tools > Business profile.

La cronologia delle chat importata non compare nell'elenco dei messaggi

Hai condiviso la cronologia delle chat durante la configurazione e Conversations mostra le chat precedenti. List WhatsApp messages restituisce i messaggi a partire dal giorno in cui il numero si è connesso, mentre filtrando per date precedenti non ottieni alcun risultato.

L'elenco dei messaggi di WhatsApp inizia dal momento in cui il numero si connette, quindi non include la cronologia importata. Leggi la cronologia importata da una conversazione:

• Nella dashboard, seleziona il conteggio dei messaggi importati nella scheda Coexistence del numero per aprire le chat in Conversations.
• Da CLI o da un agente AI, elenca i messaggi di una conversazione con bird whatsapp conversations list-messages. Il server Bird MCP offre lo stesso strumento.

I messaggi di WhatsApp vengono conservati per 30 giorni, quindi l'importazione porta i messaggi condivisi degli ultimi 30 giorni, mentre quelli più vecchi restano nell'app WhatsApp Business. Seleziona il conteggio dei contatti nella scheda Coexistence per aprire il pubblico che contiene i contatti importati.

Dopo la connessione, alcuni primi messaggi dei clienti possono arrivare come non disponibili con l'errore 131060. Meta prevede questo comportamento per i numeri dell'app WhatsApp Business. Consulta messaggi non supportati.

Il numero risulta Disconnected

Un numero in coesistenza che era Connected ora risulta Disconnected.

Meta avvisa Bird quando qualcuno disconnette Bird dal numero, ad esempio selezionando Disconnect Account in Settings > Account > Business Platform nell'app WhatsApp Business.

1. Seleziona Reconnect sul numero in Bird.
2. Completa i passaggi di Meta con l'app WhatsApp Business aperta sul telefono.
3. Invia un messaggio al numero e verifica che arrivi in Bird.

Per disconnettere tu stesso un numero in coesistenza da Bird, seleziona Disconnect Account nell'app WhatsApp Business in Settings > Account > Business Platform. Il numero continua a funzionare nell'app. In Bird risulta Disconnected e smette di inviare e ricevere messaggi. Se selezioni solo Disconnect number in Bird, Bird B.V. resta connesso nell'app. Per usare poi il numero con un altro provider, segui Trasferire un numero a un altro provider.

I gruppi non sono disponibili tramite Bird

Con un numero in coesistenza non puoi creare gruppi WhatsApp né inviare loro messaggi da Bird, e i gruppi presenti nell'app WhatsApp Business non compaiono in Bird.

Le chat di gruppo restano nell'app, come descritto nei limiti della coesistenza, e Meta non offre i gruppi ai numeri dell'app WhatsApp Business tramite API. I gruppi da Bird richiedono un numero connesso con la configurazione standard che abbia lo stato di Official Business Account.

Il numero è già connesso senza coexistence

Hai connesso il numero con Set up a number e ora vuoi che il tuo team risponda dall'app WhatsApp Business.

Un numero connesso con la configurazione standard non può passare direttamente alla coexistence. Connettilo di nuovo:

1. Disconnetti il numero in Bird. Non potrà inviare messaggi tramite Bird finché la nuova connessione non sarà completata.
2. Registra il numero nell'app WhatsApp Business sul tuo telefono. Per un numero fisso, scegli la verifica tramite chiamata.
3. In Bird, scegli New number, poi Keep using the Business app, e segui la configurazione della coexistence.

Il numero riceve un nuovo ID in Bird. Se Meta lo connette a un altro WhatsApp Business Account, invia di nuovo i tuoi template in quell'account.

Passaggi successivi

• Coexistence di WhatsApp: limiti, modifiche all'app e costi.
• Connetti il tuo numero dell'app WhatsApp Business: ogni schermata della configurazione.
• Risoluzione dei problemi dei numeri WhatsApp: account bloccati, controlli di sicurezza e altri problemi che riguardano qualsiasi numero.