Vai al contenuto

Guida alla Configurazione di Meta (Instagram & Messenger)

Il collegamento del tuo bot a Facebook Messenger e Instagram Direct Messages richiede la configurazione di un'app nel Portale per Sviluppatori di Meta.

Questo processo prevede diversi passaggi poiché Meta richiede permessi espliciti e webhook per instradare i messaggi dalle sue piattaforme alla tua istanza FRENZY.BOT.

Prerequisiti

Prima di iniziare, assicurati di avere: 1. Una Pagina Facebook per la tua attività. 2. Un Account Instagram Professionale (Business o Creator) collegato a quella Pagina Facebook. 3. Accesso alla tua dashboard FRENZY.BOT per ottenere l'URL del Webhook.

Passaggio 1: Crea un'App Meta

  1. Vai sul Portale per Sviluppatori di Meta ed effettua l'accesso.
  2. Clicca su Le mie app in alto a destra, quindi clicca su Crea app.
  3. Seleziona Altro come tipo di app e clicca su Avanti.
  4. Seleziona Business e clicca su Avanti.
  5. Inserisci un Nome visualizzato dell'app (es. "Il Mio Business Bot") e la tua email di contatto.
  6. Seleziona il tuo Account Business (opzionale ma raccomandato) e clicca su Crea app.

Passaggio 2: Aggiungi Prodotti alla tua App

Dalla Dashboard della tua App: 1. Scorri verso il basso fino a Aggiungi prodotti alla tua app. 2. Trova Messenger e clicca su Configura. 3. Nella barra laterale sinistra, clicca su Messenger → Impostazioni di Instagram (se desideri Instagram) o rimani su Messenger → Impostazioni (per Facebook Messenger).

Passaggio 3: Genera i Token di Accesso

Ti serve un Token di Accesso alla Pagina per consentire a FRENZY.BOT di inviare messaggi per tuo conto.

  1. Sotto Messenger → Impostazioni, trova la sezione Token di accesso.
  2. Clicca su Aggiungi o rimuovi Pagine e autenticati con il tuo account Facebook.
  3. Seleziona le Pagine Facebook che desideri collegare e concedi i permessi richiesti.
  4. Una volta collegata la Pagina, clicca su Genera token accanto ad essa.
  5. Copia immediatamente questo token e salvalo. Dovrai incollarlo nella dashboard di FRENZY.BOT.

Passaggio 4: Configura il Webhook

Questo indica a Meta dove inviare i messaggi in arrivo.

  1. Nella tua Dashboard FRENZY.BOT, vai su Channels → Messenger (o Instagram).
  2. Cerca il tuo Webhook URL univoco e il Verify Token su quella pagina.
  3. Torna nel Portale per Sviluppatori di Meta, scorri verso il basso fino alla sezione Webhook (sotto Impostazioni Messenger).
  4. Clicca su Aggiungi URL di callback.
  5. Incolla l'Webhook URL e il Verify Token dalla tua dashboard FRENZY.BOT.
  6. Clicca su Verifica e salva.

Passaggio 5: Iscriviti agli Eventi

Devi dire a Meta quali eventi inviare al tuo webhook.

  1. Nella sezione Webhook, clicca su Gestisci accanto al nome della tua Pagina.
  2. Iscriviti ai seguenti campi:
  3. messages (Obbligatorio per i messaggi di testo)
  4. messaging_postbacks (Obbligatorio per clic sui pulsanti/risposte rapide)
  5. messaging_optins (Opzionale, per i pulsanti "Inizia")
  6. Clicca su Salva.

Passaggio 6: Trova i tuoi ID

Se stai configurando Instagram, avrai bisogno di ID specifici:

  1. ID Account Instagram:
  2. Vai nelle Impostazioni della Pagina Facebook → Account collegati → Instagram.
  3. Oppure usa il Graph API Explorer: GET /v18.0/me?fields=instagram_business_account
  4. Recipient IGID:
  5. Questo è l'ID specifico di Instagram della persona che desideri riceva gli avvisi (se utilizzi Instagram come Integrazione). Per la configurazione del Canale, questo solitamente non è richiesto a meno che non sia specificato nella dashboard.

Passaggio 7: Finalizza in FRENZY.BOT

  1. Torna alla tua Dashboard FRENZY.BOT (Channels → Messenger o Instagram).
  2. Incolla il Page Access Token che hai generato al Passaggio 3.
  3. Incolla eventuali ID richiesti (come l'ID Account Instagram).
  4. Attiva lo switch Enable per abilitare il canale.
  5. Clicca su Save Settings.

⚠️ Cruciale: Revisione dell'App (Messa in funzione)

Quando crei inizialmente un'App Meta, essa si trova in Modalità Sviluppo.

In Modalità Sviluppo, il tuo bot risponderà solo a te e agli altri sviluppatori/tester aggiunti all'app nel portale Meta (sotto Ruoli dell'app).

Per fare in modo che il tuo bot risponda al pubblico generico, devi: 1. Completare la Verifica aziendale nel Portale per Sviluppatori di Meta. 2. Richiedere l'Accesso Avanzato per permessi specifici (solitamente pages_messaging e instagram_manage_messages). 3. Inviare una registrazione dello schermo (screencast) che mostri come funziona il tuo bot. 4. Una volta approvata, sposta lo switch dell'app nella parte superiore dello schermo da In fase di sviluppo a Pubblica.

Nota: Il processo di revisione di Meta può richiedere diversi giorni.