Iscrizione integrata

L'iscrizione integrata è un'interfaccia di autenticazione e autorizzazione compatibile con computer e mobile che consente ai clienti della tua azienda di generare facilmente le risorse necessarie per registrarle con successo sulla piattaforma WhatsApp Business.

Si è verificato un errore

Stiamo riscontrando problemi con la riproduzione di questo video.

Scopri di più

Il flusso di iscrizione integrata raccoglie informazioni relative all'azienda dai tuoi clienti, genera automaticamente tutte le risorse WhatsApp necessarie alla piattaforma e garantisce alla tua app l'accesso a queste risorse, in modo che tu possa fornire rapidamente ai clienti aziendali servizi di messaggistica WhatsApp.

I clienti registrati tramite iscrizione integrata possiedono tutte le loro risorse WhatsApp, che possono utilizzare con altre soluzioni di Meta come Inserzioni che rimandano a WhatsApp.

Come funziona

L'iscrizione integrata sfrutta il prodotto Facebook Login for Business e il nostro SDK JavaScript. Una volta configurata, puoi aggiungere un link o un pulsante al tuo sito web o portale per l'avvio del flusso.

I clienti aziendali che cliccano sul link o sul pulsante visualizzeranno una nuova finestra dove potranno:

• autenticare la propria identità usando le credenziali business di Facebook o Meta;
• concedere alla tua app l'accesso alle loro risorse WhatsApp;
• selezionare un portfolio business esistente o crearne uno nuovo;
• selezionare un account WhatsApp Business (WABA) esistente o crearne uno nuovo;
• immettere e verificare il numero di telefono (il proprio o quello che hai fornito loro);
• immettere un nome visualizzato che appare al posto del numero nel client WhatsApp.

Dopo aver completato la procedura, l'iscrizione integrata restituisce l'ID WABA del cliente, il numero di telefono aziendale e un codice token scambiabile alla finestra che ha generato il flusso. Devi inviare questi dati al tuo server e usarli in una chiamata server-to-server per:

• scambiare il codice per un token aziendale specifico del cliente;
• registrare il numero di telefono aziendale del cliente per l'uso dell'API Cloud;
• iscrivere la tua app ai webhook sul WABA del cliente;
• condividere la tua linea di credito con il cliente (solo partner di soluzioni).

Una volta completati questi passaggi, se sei o collabori con un partner di soluzioni, il cliente può iniziare a usare l'app per messaggi tua o del tuo partner immediatamente. Se non sei e non collabori con un partner di soluzioni, il cliente deve associare un metodo di pagamento al proprio WABA prima di poter iniziare a inviare messaggi.

Limitazioni

Limiti di registrazione

Per impostazione predefinita, puoi registrare fino a 10 nuovi clienti aziendali in una finestra continua di 7 giorni. Solo i nuovi clienti registrati vengono conteggiati per questo limite. Puoi consultare il numero di clienti attualmente registrati nella scheda WhatsApp Manager > Panoramica del partner. Riceverai una notifica tramite e-mail se ti avvicini a questo limite.

Se completi la verifica dell'azienda, l'analisi dell'app e la verifica dell'accesso, aumenteremo automaticamente il tuo limite a 200 nuovi clienti aziendali in una finestra di 7 giorni. Se hai bisogno di registrare più di 200 clienti a settimana, fai domanda per diventare un Business Partner di Meta.

Limiti di messaggi dei clienti aziendali

I clienti aziendali registrati tramite iscrizione integrata iniziano con i limiti di messaggi standard, che possono essere estesi attraverso l'uso dell'API.

Limiti dei numeri di telefono dei clienti aziendali

• I numeri di telefono aziendali possono essere registrati solo per l'uso con l'API Cloud.
• I numeri di telefono delle aziende già registrati per l'uso con l'API On-Premises o in uso con WhatsApp o l'app WhatsApp Business non sono supportati.
• I clienti aziendali registrati tramite iscrizione integrata iniziano con i limiti dei numeri di telefono aziendali predefiniti.

Flusso predefinito

Consulta Flusso predefinito per la descrizione di ciascuna schermata che i clienti della tua azienda visualizzeranno come parte dell'implementazione predefinita dell'iscrizione integrata.

Tieni presente che se hai delle informazioni sull'azienda del tuo cliente, puoi iniettare questi dati, in questo modo ridurrai significativamente il numero di schermate con cui i tuoi clienti devono interagire.

Token d'accesso

L'iscrizione integrata genera token d'accesso dell'utente del sistema con integrazione business ("token aziendali"). Quando un cliente aziendale completa il flusso di iscrizione integrata, viene restituito un codice token scambiabile come evento di messaggio e acquisito dall'SDK JavaScript. Devi scambiare questo codice con un token aziendale eseguendo una chiamata server-to-server.

Se sei un fornitore di soluzioni tecnologiche, userai esclusivamente i token aziendali.

Se sei un partner di soluzioni, utilizzerai i tuoi token d'accesso dell'utente di sistema ("token di sistema") per condividere la tua linea di credito con i clienti aziendali registrati e i token aziendali per tutto il resto. Tieni presente che l'utente di sistema che il token rappresenta deve aver concesso alla tua app l'autorizzazione business_management e deve aver ricevuto un ruolo Amministratore o Editor finanziario nel tuo portfolio business, per poter condividere la tua linea di credito.

Autorizzazioni

L'iscrizione incorporata può essere configurata per richiedere la maggior parte delle autorizzazioni ai tuoi clienti aziendali, ma probabilmente avrai bisogno solo di:

• whatsapp_business_management: necessaria se la tua app richiede l'accesso alle impostazioni e ai modelli di messaggio degli account WhatsApp Business dei clienti registrati.
• whatsapp_business_messaging: necessaria se la tua app richiede l'accesso alle impostazioni dei numeri di telefono aziendali dei clienti registrati, oppure se la tua app sarà utilizzata dai clienti per l'invio e la ricezione di messaggi.

Puoi specificare di quali autorizzazioni ha bisogno la tua app durante la procedura di implementazione.

Tieni presente che mentre la tua app è in modalità sviluppo, queste autorizzazioni saranno mostrate nella schermata di autorizzazione dell'iscrizione integrata a chiunque abbia un ruolo di amministratore, sviluppatore o tester sulla tua app. Tuttavia, una volta passata la tua app alla modalità live, solo le autorizzazioni approvate per l'accesso avanzato tramite la procedura Analisi dell'app saranno visualizzate nel flusso.

Fatturazione

Partner di soluzioni

Se sei un partner di soluzioni, devi già avere una linea di credito e aver accettato i termini dell'API Credit Allocation nella scheda Impostazioni business > Pagamenti in Meta Business Suite. Inoltre, devi condividere la tua linea di credito con tutti i clienti nell'ambito della procedura di registrazione.

Fornitori di soluzioni tecnologiche e partner tecnologici

Se sei un fornitore di soluzioni tecnologiche o un partner tecnologico, i tuoi clienti aziendali registrati devono aggiungere un metodo di pagamento al loro account WhatsApp Business. Possono farlo seguendo i passaggi descritti nell'articolo del nostro Centro assistenza Aggiunta di una carta di credito all'account della piattaforma WhatsApp Business del Centro assistenza.

Numeri di telefono aziendali 555

I clienti aziendali con aziende verificate o aziende i cui limiti di messaggi dell'API Cloud sono stati estesi sono idonei per un massimo di due numeri di telefono aziendali 555.

Questi numeri si comportano allo stesso modo dei numeri di telefono aziendali standard (i nomi visualizzati devono essere controllati e approvati, sono soggetti alle regole sui prezzi basate sulle conversazioni, influenzati dalle valutazioni della qualità, ecc.), con le seguenti differenze chiave:

• Hanno il prefisso di chiamata internazionale degli Stati Uniti (+1)
• Hanno il prefisso 555
• Sono sottoposti a verifica automatica
• Non possono essere migrati a un altro account WhatsApp Business o utilizzati al di fuori della piattaforma WhatsApp Business

Se i clienti della tua azienda sono idonei per i numeri 555 e vogliono registrarne uno come numero aggiuntivo, richiedi loro di ripetere la procedura di implementazione dell'iscrizione integrata. Alla richiesta di selezionare un numero di telefono aziendale, visualizzeranno automaticamente l'opzione di scelta di un numero 555:

Analisi dell'app

Non potrai registrare i clienti aziendali finché la tua app non sarà stata approvata per l'accesso avanzato per ciascuna delle autorizzazioni richieste.

Consulta il documento Analisi dell'app per maggiori informazioni sull'analisi dell'app e su cosa devi fornire per poter completare la procedura con successo.

Strumento di assistenza per l'integrazione

Lo strumento di assistenza per l'integrazione dell'iscrizione integrata è uno strumento di configurazione e test all'interno della Dashboard gestione app. Questo strumento ti consente di:

• lanciare l'iscrizione integrata in diverse configurazioni di flusso;
• visualizzare i dati restituiti quando un cliente dell'azienda completa il flusso;
• generare codice di implementazione e domande di registrazione, che puoi copiare e incollare nel sito web, nel portale clienti aziendali e nel server;
• inviare richieste API agli endpoint che dovrai usare in fase di registrazione dei clienti che completano il flusso.

Puoi accedere allo strumento di assistenza per l'integrazione andando a Dashboard gestione app > WhatsApp > Integrazione ES.

Webhook

Nell'ambito della procedura di registrazione, devi iscrivere la tua app ai webhook sul WABA di ogni cliente aziendale che completa il flusso di iscrizione integrata.

I webhook saranno attivati e inviati all'URL di callback configurato sulla tua app, a seconda dei campi webhook a cui hai effettuato l'iscrizione. Ciò significa che tutti i webhook per tutti i tuoi clienti aziendali registrati verranno inviati all'URL di callback della tua app. Tuttavia, puoi sovrascrivere l'URL di chiamata su un account WhatsApp Business individuale o un numero di telefono aziendale. Consulta Override dei webhook per sapere come fare.

Localizzazione

Il flusso di iscrizione integrata è disponibile in 30 lingue. Il flusso localizzato viene attivato automaticamente in base alla lingua in cui il cliente aziendale utilizza Facebook.

Arabo, ceco, danese, greco, inglese (Regno Unito), spagnolo (Spagna), spagnolo, finlandese, francese (Francia), ebraico, hindi, ungherese, indonesiano, italiano, giapponese, coreano, norvegese (bokmal), olandese, polacco, portoghese (Brasile), portoghese (Portogallo), rumeno, russo, svedese, thailandese, turco, vietnamita, cinese semplificato (Cina), cinese tradizionale (Hong Kong), cinese tradizionale (Taiwan).

Passaggi successivi

Scopri come implementare l'iscrizione integrata nel tuo sito web o portale.