L'Embedded Signup è un flusso Meta mostrato all'interno dell'esperienza di onboarding di un provider. Permette alla tua azienda di autorizzare la configurazione dell'account e del numero senza fornire al provider le tue credenziali Meta personali.
Chi deve avviare l'Embedded Signup?
Usa il login Meta del proprietario del portfolio aziendale o di un amministratore con i permessi per gestire i suoi asset WhatsApp. La persona che completa il flusso approva ciò che il provider può collegare.
Mantieni l'amministratore al controllo dell'account Meta. Chiedere a un provider di impersonare quell'amministratore rischia di far perdere il controllo degli asset e dei permessi. Il proprietario dell'azienda dovrebbe verificare asset, permessi e condizioni nella finestra di dialogo Meta prima di confermare.
Quali asset collega il flusso?
Il flusso può collegare un portfolio aziendale Meta, un Account Business WhatsApp e un numero di telefono all'integrazione del provider. Le scelte esatte dipendono dalla creazione di un nuovo account o dalla selezione di uno esistente.
| Asset | Verifica prima di continuare |
|---|---|
| Portfolio aziendale | L'azienda legale e l'amministratore sono corretti |
| Account Business WhatsApp | L'account è quello che il tuo team intende utilizzare |
| Numero di telefono | Il numero è disponibile per la configurazione WhatsApp selezionata |
| Connessione al provider | Il provider e lo spazio di lavoro che ricevono la connessione sono corretti |
Il provider può operare sugli asset collegati. La tua azienda resta responsabile delle policy dell'account, del consenso dei clienti e del contenuto dei messaggi. Consulta la policy Business WhatsApp di Meta prima di autorizzare l'accesso.
Cosa succede durante il flusso?
Il provider apre la finestra di dialogo Embedded Signup di Meta nella propria dashboard. Tu accedi, scegli o crei gli asset aziendali, fornisci i dettagli aziendali richiesti e autorizzi la connessione con il provider.
La verifica del telefono può essere un passaggio separato. Segui i controlli sul numero nella guida ai numeri WhatsApp di Bird prima di iniziare, se non sei sicuro che il numero candidato possa essere collegato.
Cosa è ancora incompleto quando la finestra di dialogo si chiude?
Quando la finestra di dialogo si chiude, la verifica, il collegamento e l'invio potrebbero essere ancora incompleti. Il flusso nel browser è terminato, ma Meta potrebbe star ancora elaborando gli asset.
L'operazione di completamento di Bird è disponibile solo nella dashboard. Una richiesta backend non può riprodurre il consenso dell'amministratore e la selezione degli asset, quindi non costruire un'integrazione API pubblica basata su di essa.
In Bird, leggi i campi status, next e finish_setup_url del numero collegato. status è un enum aperto. Include awaiting_signup, banned, connected, deleted, disconnected, failed, flagged, migrated, pending, preparing, rate_limited e restricted; accetta un valore non riconosciuto. Il campo separato error spiega perché l'ultimo collegamento è fallito. next indica l'azione successiva mentre il collegamento è incompleto. Mentre la registrazione attende un passaggio nel browser, finish_setup_url appare solo per awaiting_signup; aprirlo completa il flusso nella dashboard perché il passaggio non può essere eseguito tramite API. Interroga la risorsa dopo aver completato il flusso invece di trattare il redirect come un test di invio riuscito.
Gli stati flagged, restricted e banned possono influire sull'accesso all'invio di un numero collegato.
Come verifico la disponibilità alla registrazione?
Prima del flusso, verifica:
- L'amministratore può accedere al portfolio aziendale Meta corretto.
- I dettagli aziendali e la proprietà dell'account sono pronti per la revisione.
- Il numero di telefono è disponibile per questo percorso di connessione.
- Lo spazio di lavoro del provider è quello che deve ricevere l'account.
Dopo il flusso, verifica l'account, lo stato del numero, il risultato della verifica e un invio di test reale. Conserva i contatti del proprietario dell'account Meta e del supporto del provider per eventuali operazioni di recupero.
In breve
Coinvolgi l'amministratore giusto.
Il proprietario o un amministratore del portfolio aziendale Meta deve completare i passaggi di consenso e selezione degli asset.
Prepara il numero e l'azienda.
Tieni pronti il portfolio aziendale, i dettagli dell'Account Business WhatsApp e un numero per il flusso di connessione del provider.
Aspettati lavoro dopo la registrazione.
La chiusura della finestra di dialogo non garantisce la verifica, il collegamento del numero o la disponibilità all'invio. Segui lo stato riportato.
Mantieni chiara la proprietà.
Verifica quale portfolio aziendale, account e numero il provider collega prima di autorizzare il flusso.