Wiki

Ottieni le tue credenziali Meta per Homenichat

Per collegare il tuo numero WhatsApp ufficiale a Homenichat, hai bisogno di quattro credenziali generate in Meta. Questa pagina ti guida passo per passo, dall'account Meta Business fino all'incolla finale nell'assistente Homenichat. Se ti blocchi su un passaggio, puoi contattarci e ti accompagneremo.

Cosa otterrai alla fine Quattro valori da incollare nell'assistente Homenichat: phoneNumberId, businessAccountId, accessToken e verifyToken (generato da Homenichat). Piu una callbackUrl da copiare in Meta. Conta circa 30-45 minuti la prima volta.

Prima di iniziare: requisiti

Un indirizzo email professionale

Per l'account Meta Business. Usa l'indirizzo che vuoi associare alla tua azienda.

Un telefono con WhatsApp Business

L'app WhatsApp Business installata e attiva sul numero che vuoi usare.

Un account Facebook personale

Meta Business e collegato al tuo account Facebook (usato solo per l'amministrazione, non viene pubblicato nulla).

Una carta o un conto bancario

Meta puo richiedere un metodo di pagamento prima di alcuni invii API (spesso zero euro alla fine).

La tua HomeniBOX gia installata

La BOX deve essere online al momento del collegamento finale. Se non hai ancora una box, vedi la pagina materiale.

30-45 minuti davanti a te

Senza interruzioni, ideale per fare tutto il percorso di seguito.

Importante Se il tuo numero WhatsApp e attualmente usato nell'app WhatsApp Business sul telefono, dovrai scegliere tra continuare a usarlo solo sul telefono o collegarlo a Homenichat tramite l'API ufficiale. Meta sta lavorando a una modalita "coexistence" che permettera entrambi, ma Homenichat non l'ha ancora attivata. Se vuoi mantenere l'app del telefono per ora, usa un secondo numero per questa configurazione.

Panoramica del percorso

Creare un account Meta Business (Meta Business Suite).
Creare un Business Portfolio.
Aggiungere il tuo numero WhatsApp al portfolio (creazione del WABA).
Verificare la tua azienda (opzionale, consigliato).
Creare un'app Meta Developer e aggiungere il prodotto WhatsApp.
Generare un access token (System User permanente o temporaneo).
Recuperare phone_number_id e business_account_id.
Lanciare l'assistente Homenichat che ti fornisce callback URL e verify token.
Incollare callback URL e verify token in Meta, poi validare.
Testare un messaggio in entrata per confermare che funziona.

Procedura passo per passo

1

Creare un account Meta Business

⏱ 5 min🔗 business.facebook.com

Vai su business.facebook.com e accedi con il tuo account Facebook personale. Clicca su "Crea account" se non ne hai ancora uno. Inserisci il nome della tua azienda e la tua email professionale.

Screenshot in arrivo: schermata di benvenuto Meta Business Suite con il pulsante "Crea account"

Suggerimento Il tuo account Facebook personale serve solo per autenticarti. I tuoi clienti non lo vedranno mai. Non hai bisogno di pubblicare nulla su Facebook.

2

Creare o verificare il tuo business portfolio

⏱ 2 min

In Meta Business Suite, in Impostazioni > Impostazioni aziendali > Account > Gruppo di asset aziendali (il menu varia a seconda della versione Meta del momento), assicurati che sia stato creato un business portfolio per la tua azienda. Annotalo. E qui che collegheremo il numero WhatsApp.

Screenshot in arrivo: pagina Impostazioni aziendali, sezione Asset aziendali

3

Aggiungere il tuo numero WhatsApp (creazione del WABA)

⏱ 10 min📩 SMS di verifica ricevuto

Sempre in Impostazioni aziendali, vai su Account > Account WhatsApp. Clicca Aggiungi, poi Crea un account WhatsApp Business. Segui l'assistente Meta. Alla fine, Meta invia un codice di verifica al tuo numero (SMS o chiamata) per confermare che e davvero il tuo.

Screenshot in arrivo: creazione del WABA, passaggio numero di telefono

Se Meta dice che il tuo numero e gia in uso Significa che e collegato all'app WhatsApp Business sul tuo telefono. Dovrai disconnetterlo prima dall'app. Per farlo: apri WhatsApp Business sul telefono, vai su Impostazioni > Account > Elimina il mio account (questa azione mette temporaneamente in pausa il numero), o contatta il supporto Meta per migrare.

4

Verificare la tua azienda (consigliato, non obbligatorio per iniziare)

⏱ 5 min per inviare, alcuni giorni per la validazione Meta

In Impostazioni aziendali > Verifica dell'azienda, segui la procedura. Meta ti chiedera documenti (visura camerale, giustificativo di indirizzo, eventualmente videochiamata). Puoi usare l'API senza verifica immediata (con limiti di volume), ma la verifica e necessaria per le conversazioni marketing e i volumi elevati.

Screenshot in arrivo: modulo di verifica aziendale

5

Creare un'app Meta Developer e aggiungere WhatsApp

⏱ 5 min🔗 developers.facebook.com/apps

Vai su developers.facebook.com/apps. Clicca su "Crea app". Scegli il tipo "Business". Dalle un nome (ad es.: "WhatsApp Homenichat - Mio Studio"), collegala al tuo Business Portfolio creato al passo 2.

Una volta creata l'app, nel menu di sinistra clicca "Aggiungi un prodotto" e scegli WhatsApp. Segui l'assistente. Meta ti chiedera di selezionare il tuo WABA (creato al passo 3).

Screenshot in arrivo: Meta Developer Console con "Aggiungi un prodotto > WhatsApp"

6

Recuperare phoneNumberId e businessAccountId

⏱ 2 min

Nella tua app Developer, vai su WhatsApp > API Setup. Vedrai:

Campo Meta	Dove serve in Homenichat
Phone number ID	phoneNumberId
WhatsApp Business Account ID	businessAccountId

Copia questi due valori in una bozza per il momento. Sono numeri (ad esempio 589510807587130).

Screenshot in arrivo: pagina "WhatsApp > API Setup" con i due ID evidenziati

7

Generare un Access Token permanente (System User)

⏱ 8 min🔑 Da fare una sola volta

Il token temporaneo mostrato di default sulla pagina WhatsApp API Setup scade dopo 24 ore. Per un uso duraturo, occorre creare un System User che detiene un token permanente.

In Impostazioni aziendali, vai su Utenti > Utenti di sistema.
Clicca "Aggiungi", dagli un nome (ad es.: "WhatsApp Integrator Homenichat"), scegli il ruolo "Amministratore".
Una volta creato, clicca "Aggiungi asset", aggiungi il tuo WABA con permessi completi.
Clicca "Genera token". Scegli la tua app Meta Developer (passo 5).
Spunta i permessi: whatsapp_business_management e whatsapp_business_messaging.
Seleziona "Il token non scade mai".
Copia immediatamente il token mostrato. Inizia con EAA.... Meta non lo mostrera mai piu.

Screenshot in arrivo: Impostazioni aziendali > Utenti di sistema > generazione del token con permessi spuntati

Salva il token immediatamente. Mettilo in un gestore di password o in un posto sicuro. Se lo perdi, dovrai rigenerarne uno nuovo (che invalidera il vecchio).

8

Recuperare l'App Secret (opzionale ma consigliato)

⏱ 1 min

In Meta Developer Console, nella tua app, vai su Impostazioni > Generali. Clicca su "Mostra" accanto a "Segreto dell'app". Copia il valore.

Questa chiave serve al relay Homenichat per verificare che i webhook ricevuti provengano davvero da Meta (firma HMAC). Senza di essa, i webhook funzionano comunque ma senza verifica della firma.

Screenshot in arrivo: Impostazioni > Generali con l'App Secret mostrato

9

Lanciare l'assistente Homenichat sul tuo telefono

⏱ 2 min

Apri l'app Homenichat, vai su Impostazioni > WhatsApp ufficiale Meta. Tocca "Configurazione Meta assistita" e segui le schermate.

Quando arrivi alla schermata "Configura il webhook in Meta", Homenichat ti mostra due valori da copiare in Meta:

La Callback URL pubblica. Ha la forma https://webhooks.homenichat.com/meta/<tuo-id>.
Un Verify Token generato da Homenichat (stringa di caratteri casuali). Meta lo usa per validare che sia davvero tu a configurare il webhook.

Tocca "Copia" su ogni campo, oppure prendi nota dei valori.

Screenshot in arrivo: schermata "Webhook setup" nell'app Homenichat con i due pulsanti Copia

10

Collegare il webhook in Meta

⏱ 3 min

Torna su Meta Developer Console > la tua app > WhatsApp > Configurazione > Webhook. Clicca "Configura un webhook".

In Callback URL, incolla il valore di Homenichat.
In Verify Token, incolla il token generato da Homenichat.
Clicca "Verifica e salva". Meta invia una richiesta di verifica a Homenichat; richiede qualche secondo.

Se Meta dice "Verificato", perfetto. Altrimenti, controlla di aver incollato i valori giusti (nessuno spazio) e che la tua HomeniBOX sia online.

Poi, in "Campi del webhook", iscriviti almeno a: messages, message_template_status_update, account_update.

Screenshot in arrivo: pagina "Webhook" in Meta Developer con callback URL e verify token incollati

11

Incollare le credenziali nell'assistente Homenichat

⏱ 2 min

Torna nell'assistente Homenichat sul telefono, passa alla schermata "Inserisci le tue credenziali Meta", e incolla:

Campo Homenichat	Valore da incollare
phoneNumberId	Recuperato al passo 6
businessAccountId	Recuperato al passo 6
accessToken	Token EAA... del passo 7
appSecret	Recuperato al passo 8 (opzionale)

Tocca "Verifica".

12

Validazione finale

⏱ 1 min

Homenichat lancia tre verifiche automaticamente:

Connessione Meta Graph API: testa che il tuo token sia valido.
Elenco dei template: verifica che tu possa inviare/ricevere template.
Attivazione del relay: Homenichat registra la tua callback URL per inoltrare i webhook Meta alla tua BOX.

Tre luci verdi? Fatto. I tuoi messaggi WhatsApp arriveranno in Homenichat dal prossimo messaggio del cliente.

Test consigliato Chiedi a qualcuno (tuo partner, un amico) di inviare un WhatsApp al tuo numero professionale dal proprio WhatsApp. Il messaggio deve apparire nella inbox Homenichat in un secondo. Se non arriva nulla in 30 secondi, vedi la sezione risoluzione dei problemi qui sotto.

Riepilogo dei valori raccolti

Le 4 credenziali Meta

phoneNumberId	numero, es: 589510807587130
businessAccountId	numero, es: 578793621992297
accessToken	stringa lunga che inizia con EAA...
appSecret	stringa hex di 32 caratteri (opzionale)

Risoluzione dei problemi

Meta rifiuta la mia callback URL ("Verifica fallita")

Controlla che la tua HomeniBOX sia online (l'indicatore deve essere verde).
Controlla di aver incollato il verify token SENZA spazi prima o dopo.
Rigenera una nuova sessione nell'app Homenichat e riprova il collegamento.
Se persiste: contattaci, possiamo diagnosticare il passaggio del challenge dai nostri server.

L'access token e rifiutato con "Invalid OAuth access token"

Controlla di aver usato il token System User permanente (passo 7), non il token temporaneo che scade in 24 ore.
Controlla che il System User abbia entrambi i permessi whatsapp_business_management e whatsapp_business_messaging.
Controlla che il tuo System User abbia il tuo WABA tra i suoi asset, con permessi completi.

Nessun messaggio in entrata arriva in Homenichat

Controlla di essere iscritto al campo messages nei Webhook Meta (passo 10).
Controlla nell'app che la box sia online.
Chiedi a Meta di rinviare un evento di test: Meta Developer Console > Webhook > "Test".

Meta chiede un metodo di pagamento prima che possa inviare

E normale per le conversazioni marketing e oltre le 1000 conversazioni service al mese. In Impostazioni aziendali > Pagamenti, aggiungi una carta o un conto bancario. Non vieni fatturato se rimani nel piano gratuito. Homenichat non fattura mai i tuoi messaggi: e Meta che incassa, direttamente.

Hai bisogno di aiuto?

Se ti blocchi, scrivici a support@homenichat.com. Indicaci il passo che blocca e uno screenshot del messaggio di errore se possibile. Ti accompagniamo. Per gli utenti Team (9 euro/mese), questa assistenza e prioritaria.

Hai bisogno della HomeniBOX prima?

Senza box, il wizard non potra attivare il relay del webhook alla fine. Vedi le nostre configurazioni materiale.

Configurazioni materiale