Guide > Collegare i canali > Avanzato: la tua app Meta

Avanzato: configurare a mano i canali Meta (con la tua app Meta)

Alla maggior parte delle persone non serve. WhatsApp lo colleghi con un clic: Collegare WhatsApp. I modelli li costruisci nell'editor: Modelli WhatsApp e stato. Profilo, messaggio di benvenuto, codici QR, nome visualizzato e altro si gestiscono nel Meta hub. Questa pagina riguarda la strada “Advanced (manual)”, per chi gestisce da sé le proprie credenziali, per esempio in self-hosting con una propria app Meta. Cosa ti risparmi senza una tua app Meta e quanto chiedono i fornitori: API WhatsApp senza app Meta.

Con le tue credenziali colleghi a mano WhatsApp Business, Facebook Messenger e i messaggi diretti di Instagram (più i commenti FB/IG). Poi tutti i messaggi Meta arrivano nella stessa inbox delle e-mail e degli altri canali.

⏱ WhatsApp circa 10–15 min · Facebook/Instagram circa 5 min · Permesso “Manage settings” (admin) · Free, Cloud Pro e Paid · Aggiornato al 20 nov 2026 (versione 1.1.68)

La pagina Settings → Channels di The-Y CRM
Settings → Channels: qui colleghi WhatsApp, Messenger e Instagram.

Prima di iniziare: cosa ti serve

Con la tua app Meta valgono le regole di Meta per la tua app: quali permessi e livelli di accesso ti servono, per esempio per i messaggi Instagram, i commenti o la pubblicazione, lo trovi nella documentazione per sviluppatori di Meta. Se invece colleghi su crm.the-y.at con “Connect WhatsApp” o “Connect Facebook & Instagram”, non devi richiedere nulla a Meta.

Parte A · Configurare WhatsApp a mano

La strada standard è “Connect WhatsApp” (un clic, anche con l'app WhatsApp Business). Se preferisci gestire da solo il tuo WABA nella console per sviluppatori di Meta, inserisci direttamente i valori:

  1. In Settings → Channels apri il riquadro “WhatsApp” → in fondo apri “Connect manually (for experts)” → inserisci il numero → “Create” (solo in self-hosted; dalla 1.1.70 nel cloud al suo posto c'è un avviso, perché i messaggi arrivano solo tramite “Connect WhatsApp”). Si apre la finestra del numero; lì apri “Advanced (manual)”. Per un numero già esistente: “Configure” o “Edit” sul numero nell'elenco “Connected”.
  2. Inserisci questi valori dalla tua app Meta / configurazione WhatsApp:
    • Phone number ID (l'ID del numero, non il numero stesso)
    • WABA ID (ID del WhatsApp Business Account)
    • Token: meglio un token permanente di un utente di sistema (non scade mai). Viene salvato cifrato.
  3. “Send test”. The-Y invia il modello standard hello_world a un numero a tua scelta (per esempio il tuo telefono). Se arriva, l'invio è configurato correttamente.
Importante per la versione in cloud (crm.the-y.at): i messaggi in arrivo raggiungono il CRM solo tramite l'app Meta di The-Y. Quindi collega il tuo numero con “Connect WhatsApp”: funziona anche per un numero già registrato sulla Cloud API (scegli “Connect new number”, poi nella finestra di Meta la tua azienda, l'account WhatsApp e il numero esistenti). Con un token della tua propria app Meta funziona solo l'invio; i messaggi in arrivo continuano ad andare alla tua app. In self-hosting inserisci l'URL del webhook + il verify token nella tua app Meta (vedi la guida al self-hosting).
Dalla versione 1.1.44 con una tua app Meta: dopo l'aggiornamento clicca una volta “Subscribe webhooks” nell'hub alla voce Meta: così arrivano le nuove notifiche per osservazione, passaggi di consegne e “stop promotions”. Per i modelli di marketing tramite la Marketing Messages API di Meta, anche la tua app Meta deve esservi iscritta (App Dashboard → WhatsApp → Quickstart → “Marketing Messages API” → accetta le condizioni); poi iscrivi i tuoi account WhatsApp con la scheda nella finestra del numero (Settings → Channels → “Edit” sul numero) (guida). Se usi l'agente IA di Meta: instradamento delle conversazioni.

Parte B · Collegare Facebook Messenger e Instagram

  1. In Settings → Channels apri il riquadro “Facebook & Instagram” → scegli Messenger o Instagram (etichetta facoltativa) → “Next”. Nella stessa finestra clicca “Connect Facebook & Instagram” (standard). Con credenziali tue apri invece “Set up manually (Page ID + token)”.
  2. Seleziona la Pagina (o le Pagine). Dopo il login a Facebook, la finestra mostra le tue Pagine (e gli account Instagram collegati). Scegli la Pagina i cui messaggi devono arrivare in The-Y.
  3. Conferma. The-Y iscrive la Pagina e salva cifrato il token della Pagina. I messaggi diretti di Messenger e Instagram e i commenti FB/IG ora compaiono nell'inbox; le risposte arrivano al cliente tramite la Pagina collegata.
Non compare la finestra di login di Facebook? Allora nella tua app Meta non è attivo “Login with the JavaScript SDK” oppure il dominio non è tra quelli consentiti. Nella versione in cloud è già fatto; in self-hosting controlla le impostazioni dell'app Meta.

Modelli WhatsApp: per i messaggi fuori dalla finestra di 24 ore

WhatsApp consente il testo libero solo entro 24 ore dall'ultimo messaggio del cliente. Dentro la finestra di 24 ore le prime 1.000 risposte per numero al mese sono gratuite; poi Meta addebita per ogni messaggio il prezzo di servizio del Paese del destinatario (tariffario di Meta). Per scrivere dopo (o per primo) ti serve un modello approvato da Meta. Lo costruisci in Snippets & email templates → WhatsApp templates nell'editor con anteprima dal vivo oppure ne prendi uno dalla galleria: prima dell'invio a Meta il CRM controlla i motivi di rifiuto più comuni. Tutti i dettagli: Modelli WhatsApp e stato.

Finestra di 24 ore e consenso

Risoluzione dei problemi

190 Invalid OAuth access token / “token invalid”

Il token WhatsApp salvato è scaduto o è sbagliato. Usa un token permanente di un utente di sistema (scadenza “Never”) dalla tua app Meta e inseriscilo di nuovo. Con la strada in un clic, basta rifare “Connect WhatsApp”.

Non ricevo messaggi WhatsApp

Controlla: il phone number ID è giusto (non il numero stesso)? Il canale è attivo? Nella versione in cloud i messaggi in arrivo arrivano solo se il numero è collegato con “Connect WhatsApp” (non con un token della tua app Meta). Se il tuo numero è ancora iscritto a un'altra app Meta, non arriva nulla lo stesso: in quel caso togli l'iscrizione del numero nella vecchia app e ricollegalo.

Il mio account Instagram non compare nella finestra di collegamento

L'account IG deve essere un account professionale (business/creator) ed essere collegato alla Pagina Facebook scelta. Controllalo nelle impostazioni di Instagram, poi collega di nuovo.

App Meta propria: messaggi diretti Instagram, commenti o pubblicazione non funzionano

La tua app Meta ha bisogno dei permessi Instagram giusti (per esempio instagram_manage_messages, instagram_manage_comments, instagram_content_publish) con il livello di accesso che Meta richiede per il tuo caso; altrimenti funzionano solo in modalità sviluppatore. I requisiti li stabilisce Meta. Su crm.the-y.at con “Connect Facebook & Instagram” questo non ti riguarda.

Una risposta mostra “saved only, not sent”

Il canale non ha un accesso valido a Meta. Controlla il token o il token della Pagina, oppure ricollega il canale; poi invia di nuovo la risposta.

Prossimi passi