Migrazione WhatsApp API

Questa guida spiega come collegare a Quoting24 un numero già attivo sulle API ufficiali di WhatsApp (WhatsApp Business Platform) presso un altro fornitore, senza cambiare il numero.

La sezione WhatsApp è visibile solo agli amministratori.

Il collegamento parte sempre dallo stesso punto in Quoting24: Impostazioni → WhatsApp → WhatsApp Business → Connetti. Il pulsante Connetti apre la registrazione integrata di Meta (Embedded Signup). Da lì Quoting24 diventa il fornitore che riceve e invia i messaggi di quel numero. La modalità prevista è il collegamento alle API ufficiali, descritto in Panoramica WhatsApp.

Quale procedura seguire

Meta ha due modi di collegare un numero già usato da un altro fornitore. Prima di cliccare Connetti, controlla il portfolio in Meta Business Suite → Impostazioni → Account.

In Meta Business Suite vedi	Cosa fare
Account WhatsApp e Account di messaggistica (Messaging Accounts) separati	Modello attuale: condividi l’account WhatsApp con Quoting24. Il numero resta dov’è.
Solo Account WhatsApp	Modello precedente: migra il numero con un codice SMS o vocale.

Sul modello attuale Meta rifiuta lo spostamento del numero da un account a un altro. Scollegarlo dal fornitore precedente non lo rende libero.

Cosa preparare

Accesso amministratore a Quoting24.
Accesso amministratore al portfolio Meta (Business Manager) che possiede il numero, con l’utente Facebook che userai nella finestra di Connetti.
Il numero già registrato sulle API ufficiali. I numeri di prova gratuiti assegnati da Meta non si possono migrare.
Possibilità di ricevere un SMS o una chiamata vocale su quel numero, se Meta chiede un codice.

Per la migrazione del modello precedente servono anche:

nome visualizzato già approvato, senza una richiesta di cambio nome ancora aperta;
verifica in due passaggi (PIN) disattivata sul numero, senza cancellare il numero né chiudere l’account. Se non hai accesso all’account WhatsApp, la disattivazione va chiesta al fornitore attuale.

Modello attuale: condividi il numero con Quoting24

Usa questa procedura se in Meta Business Suite compaiono sia Account WhatsApp sia Account di messaggistica.

Lascia il numero attivo sul fornitore attuale fino alla fine. Toglierlo prima, con messaggi dei clienti in arrivo, interrompe la ricezione.

In Quoting24 apri Impostazioni → WhatsApp.
Sulla riga WhatsApp Business clicca Connetti e accedi con l’amministratore del portfolio Meta.
Seleziona il numero già registrato presso l’altro fornitore. Meta lo mostra in elenco e non chiede un nuovo codice: il numero è già registrato.
Meta propone il portfolio e l’account WhatsApp di quel numero. Conferma la condivisione con Quoting24.
Inserisci il nome visualizzato del numero e prosegui. Meta può riesaminarlo dopo l’attivazione.
Controlla i permessi richiesti (account WhatsApp, account di messaggistica e risorse collegate) e conferma.
Chiudi la finestra Meta. In Quoting24 la riga WhatsApp Business risulta connessa.

Meta crea un account di messaggistica nuovo per Quoting24, sotto lo stesso account WhatsApp. Il fornitore precedente resta collegato finché non lo rimuovi.

Far arrivare i messaggi su Quoting24

La condivisione da sola non sposta i messaggi in arrivo. Finché il fornitore precedente è ancora partner, Meta può continuare a consegnarli a lui.

Quando in Quoting24 la riga WhatsApp Business è connessa:

In Meta Business Suite apri Impostazioni → Account → Account di messaggistica, seleziona l’account, vai in Partner e rimuovi l’accesso dell’app del fornitore precedente.
Apri Impostazioni → Account → Account WhatsApp, seleziona l’account del numero, vai in Partner e rimuovi anche lì l’accesso dello stesso fornitore.
Nello stesso account WhatsApp apri Routing delle conversazioni (Conversation routing) e assegna a Quoting24 ogni tipo di conversazione.

In elenco partner può comparire il nome dell’app Meta collegata a Quoting24, non la scritta «Quoting24». Se non è chiaro quale accesso togliere, fermati e chiedi al supporto Quoting24 prima di rimuovere un partner.

Quando resta un solo partner, Meta disattiva il routing e consegna i messaggi a quel partner.

Cosa resta su questo modello

Restano sul numero, perché l’account WhatsApp non cambia:

numero di telefono
nome visualizzato
valutazione della qualità
limiti di messaggistica
stato di Official Business Account, se era già attivo

I template stanno sull’account di messaggistica, non sul numero. L’account creato per Quoting24 nasce vuoto: i template del fornitore precedente vanno ricreati in Quoting24 e approvati di nuovo da Meta.

Finché non sono approvati:

da Quoting24 puoi rispondere liberamente solo entro 24 ore dall’ultimo messaggio del cliente;
in Broadcast API non ci sono modelli da selezionare.

Le chat salvate nel software precedente non entrano nei ticket di Quoting24. I messaggi che arrivano dopo la connessione diventano ticket. Le chat già presenti sul telefono del cliente restano sull’app WhatsApp del cliente.

Modello precedente: migra il numero

Usa questa procedura solo se in Meta Business Suite compare soltanto Account WhatsApp.

Disattiva la verifica in due passaggi

Chiedi al fornitore attuale di disattivare il PIN del numero, oppure fallo tu dal portfolio Meta se ne hai l’accesso.

Il numero e l’account devono restare attivi. Va tolta solo la verifica in due passaggi.

Collega il numero da Quoting24

In Quoting24 apri Impostazioni → WhatsApp.
Sulla riga WhatsApp Business clicca Connetti e accedi come amministratore del portfolio Meta.
Scegli di creare un nuovo account WhatsApp. È il passaggio con cui Meta sposta il numero già esistente: non è un secondo numero.
Inserisci lo stesso nome visualizzato già approvato su quel numero.
Inserisci lo stesso numero. Meta avvisa che è già registrato su un account WhatsApp Business o presso un altro fornitore.
Chiedi il codice via SMS o chiamata vocale e inseriscilo.
Completa i passaggi rimasti nella finestra Meta.

Lo spostamento di solito si conclude in pochi minuti. In Quoting24 la riga WhatsApp Business passa a connessa. Durante il passaggio la ricezione può interrompersi per qualche minuto.

Cosa resta e cosa va rifatto

Restano sul numero:

nome visualizzato
valutazione della qualità
stato di Official Business Account
limiti di messaggistica

Vanno rifatti in Quoting24:

i template, da reinviare e far riapprovare da Meta, prima di scrivere fuori dalla finestra di 24 ore e prima di usare Broadcast API;
le campagne del fornitore precedente;
lo storico chat di quel software, che non viene importato. I messaggi nuovi arrivano come ticket.

Numero già in coesistenza con un altro fornitore

Se lo stesso numero è usato insieme dall’app WhatsApp Business e dalle API presso un altro fornitore, il collegamento API non riallaccia da solo l’app sul telefono.

Fai un backup delle chat nell’app WhatsApp Business.
Registra lo stesso numero sull’app WhatsApp personale: il numero esce dall’app Business.
Registralo di nuovo sull’app WhatsApp Business.
In Quoting24 clicca Connetti su WhatsApp Business e completa la coesistenza descritta in WhatsApp Coexistence: sull’app, Impostazioni → Dispositivi collegati → Collega un dispositivo, poi scansiona il QR mostrato da Quoting24.

Per portare il numero sulle sole API, senza app sul telefono, usa la procedura del modello Meta verificato sopra.

Dopo il collegamento

I messaggi nuovi del numero diventano ticket in Quoting24.
Fuori dalle 24 ore dall’ultimo messaggio del cliente si scrive con un template approvato. Le regole del canale ufficiale sono in Panoramica WhatsApp.
Le campagne si creano in Broadcast API quando i template sono disponibili in Quoting24.
Per usare anche l’app WhatsApp Business sullo stesso numero serve WhatsApp Coexistence.
Gruppi e liste broadcast dell’app non passano sulle API.

Se la procedura si ferma

Meta rifiuta lo spostamento del numero. Il portfolio è sul modello attuale: torna alla condivisione e lascia il numero registrato sul fornitore precedente finché Quoting24 non risulta connesso.
Il codice SMS o vocale non arriva. Sul modello precedente la verifica in due passaggi è ancora attiva. Falla disattivare e ripeti Connetti.
Il nome visualizzato blocca la migrazione precedente. Meta accetta il passaggio solo con nome approvato e senza un cambio nome in sospeso.
Quoting24 è connesso ma i messaggi non arrivano. Sul modello attuale il routing punta ancora al fornitore precedente. Controlla Partner e Routing delle conversazioni prima di scollegare il numero.
Se il partner da rimuovere non è riconoscibile, contatta il supporto Quoting24 con il numero e l’ID del portfolio Meta.