# Collega WhatsApp, Facebook, Instagram e LinkedIn

> Usa le tue app per sviluppatori e collega le identità con cui agisce la tua azienda.

## Prima di iniziare

Ti serve l’accesso come owner o editor della dashboard a un workspace business. Crea la tua app per sviluppatori: Meta per WhatsApp, Facebook o Instagram, LinkedIn per LinkedIn. Botchi non fornisce un’app condivisa per questi servizi.

Messaggi, post e limiti del provider appartengono alla tua app. Il dialogo di collegamento ti guida nella configurazione del provider.

## Collega WhatsApp

1. Crea un’app Meta Business e aggiungi il prodotto WhatsApp.
2. Aggiungi e verifica il numero aziendale nel tuo WhatsApp Business Account.
3. Crea un utente di sistema e assegna app e WhatsApp Business Account con controllo completo.
4. Genera il suo token con scadenza Mai e gli scope whatsapp_business_messaging, whatsapp_business_management e business_management.
5. Apri **Strumenti**, seleziona WhatsApp e scegli **Collega il numero**.
6. Inserisci l’ID del numero di telefono e il token. Aggiungi il WhatsApp Business Account ID se ti servono strumenti per template, flow o statistiche. Scegli **Collega il numero**.
7. Nel passaggio **Messaggi**, salva il segreto della tua app Meta: in Meta for Developers apri la tua app → **Impostazioni dell’app → Di base (App settings → Basic)** e scegli **Mostra (Show)** accanto a **Segreto dell’app (App secret)**. Non è il token di accesso né il verify token; consulta la [documentazione Meta sulle impostazioni di base](https://developers.facebook.com/docs/development/create-an-app/app-dashboard/basic-settings/).
8. Incolla l’URL di callback e il verify token mostrati in Botchi nella configurazione webhook WhatsApp della tua app Meta, scegli **Verifica e salva (Verify and save)** e sottoscrivi il campo messages. Il passaggio mostra quando Meta ha verificato il webhook.

Un partner autorizzato può collegare WhatsApp da una sessione partner attiva. La connessione appartiene al workspace cliente e i workflow in arrivo vengono eseguiti con il suo proprietario.

Più numeri sulla stessa app Meta condividono un unico segreto dell’app e un unico webhook del workspace: per i numeri successivi il passaggio **Messaggi** è già fatto. La pagina del connettore mostra la stessa configurazione in **Ricevi i messaggi**.

> **Attenzione** — Senza il segreto dell’app, gli strumenti del numero restano non disponibili. Senza l’iscrizione al campo messages, i messaggi in arrivo non possono raggiungere i workflow.

Poi [configura un workflow per i messaggi ricevuti](/it/docs/workflows/triggers). Per rispondere, usa l’indirizzo di risposta dell’evento come destinatario, solo cifre e senza il segno più iniziale. Seleziona la connessione del passaggio di invio; se hai più numeri, scegli nel trigger la connessione del numero.

I messaggi liberi richiedono che il destinatario abbia scritto alla tua azienda nella finestra di assistenza clienti di Meta di 24 ore. Al di fuori, invia un template approvato; Meta addebita i messaggi template.

## Collega Instagram

1. Crea un’app Meta Business e aggiungi il prodotto Instagram.
2. Scegli API setup with Instagram business login.
3. Usa un account Instagram Business o Creator e assicurati che chi crea il token abbia un ruolo sull’app.
4. Genera un token per quell’account e accetta i permessi offerti, inclusi insights, commenti e messaggi.
5. Apri **Aggiungi strumenti** in Botchi e seleziona Instagram.
6. Incolla il token e scegli **Collega Instagram**.

Questa configurazione non richiede una pagina Facebook. I token Instagram durano 60 giorni; Botchi li rinnova automaticamente prima della scadenza. Se il rinnovo fallisce, sostituisci il token per la stessa identità.

## Collega Facebook

Gli strumenti Facebook leggono i lead di Lead Ads, gestiscono post e commenti della Pagina e riportano le performance degli annunci. Gli annunci sono in sola lettura: gli agenti non possono modificare budget o campagne.

1. Crea un’app Meta Business nel portfolio aziendale che possiede le tue Pagine e i tuoi account pubblicitari, e aggiungi Marketing API.
2. In Impostazioni business crea un utente di sistema Admin. Assegnagli la tua app, le tue Pagine con controllo completo e i tuoi account pubblicitari.
3. In **Integrazioni → Accesso ai lead (Leads Access)**, consenti all’utente di sistema di leggere i lead delle tue Pagine.
4. Genera il token dell’utente di sistema con scadenza Mai e i permessi elencati nel dialogo di collegamento.
5. Metti l’app Meta in modalità Live. Meta non restituisce lead in modalità sviluppo e può richiedere l’App Review per leads_retrieval.
6. Apri **Strumenti**, seleziona Facebook e scegli **Aggiungi connessione**. Dai alla connessione il nome del cliente, incolla il token e scegli **Collega**.
7. Nel passaggio **Pagine**, scegli le Pagine e gli account pubblicitari che la connessione copre. Puoi cambiarli più tardi dalla pagina del connettore.

Una connessione raggiunge solo le Pagine e gli account pubblicitari selezionati per lei. Un’agenzia può collegare lo stesso token una volta per cliente. Una Pagina o un account pubblicitario appartiene a una sola connessione alla volta: deselezionalo lì prima di spostarlo.

I token degli utenti di sistema non scadono. Se uno viene revocato, scegli **Ricollega** su quella connessione; nome e selezioni restano. Meta conserva i lead per circa 90 giorni.

### Avvia workflow sui nuovi lead

È il passaggio facoltativo **Nuovi lead** del dialogo di collegamento, presente anche nella pagina del connettore in **Ricevi i nuovi lead**.

1. Salva il segreto della tua app Meta da **Impostazioni dell’app → Di base (App settings → Basic)**. Botchi lo verifica con l’app del token.
2. Nella tua app Meta aggiungi il prodotto Webhooks e seleziona **Page**.
3. Incolla l’URL di callback e il verify token mostrati in Botchi, poi scegli **Verify and save**.
4. Iscriviti al campo leadgen. Botchi iscrive automaticamente le Pagine selezionate su ogni connessione.
5. Crea un workflow con il trigger **Facebook · Nuovo lead** e scegli la connessione del cliente.
6. Invia un lead di prova con il [Lead Ads Testing Tool](https://developers.facebook.com/tools/lead-ads-testing) di Meta.

Un lead avvia solo i workflow il cui trigger indica la connessione della sua Pagina. La pagina del connettore elenca cosa manca a ogni connessione per i nuovi lead; correggilo, poi scegli **Riprova**. Un token che Meta non ha potuto verificare del tutto serve solo agli strumenti; ricollegalo per i nuovi lead.

## Collega LinkedIn

1. Crea un’app sviluppatori LinkedIn associata alla pagina LinkedIn aziendale, di cui sei admin.
2. Aggiungi Sign In with LinkedIn using OpenID Connect e Share on LinkedIn all’app.
3. Genera un token con gli scope offerti, inclusi openid, profile, email e w_member_social.
4. Apri **Aggiungi strumenti** in Botchi e seleziona LinkedIn.
5. Incolla il token e scegli **Collega LinkedIn**.

I token LinkedIn durano 60 giorni dalla generazione e vanno sostituiti manualmente. Botchi ti avvisa prima della scadenza. Incolla un token nuovo per lo stesso membro quando ricolleghi l’account.

Pubblicare come pagina aziendale, commentare, reagire e consultare statistiche richiede anche l’approvazione di LinkedIn del prodotto Community Management API sulla tua app. Pubblicare come membro funziona senza.

LinkedIn può pubblicare immagini, video, documenti e miniature di articoli da file leggibili nel Workspace, senza hosting pubblico. Funzionano anche URL HTTPS esterni per i media.

## Seleziona l’identità che pubblica

1. Controlla handle, nome del membro o numero di telefono mostrato per l’account collegato.
2. [Associa quell’account agli strumenti dell’agente](/it/docs/agents/tools), oppure selezionalo nel passaggio del workflow.

Ogni provider supporta più identità collegate. Un agente o workflow agisce con quella che selezioni, quindi brand diversi possono usare account diversi.

## Controlla messaggi e lead in arrivo

Le pagine dei connettori WhatsApp e Facebook elencano ciò che Meta ha consegnato di recente al tuo webhook e cosa è successo a ogni evento: consegnato ai tuoi workflow, ignorato o fallito, con il motivo.

Un evento viene ignorato quando nessun workflow attivo lo ascolta, oppure quando il suo numero o la sua Pagina non è selezionato su nessuna connessione di questo workspace. Botchi ritenta gli errori temporanei; un errore persistente, come Meta che nega l’accesso a un lead o un segreto dell’app non corrispondente, va risolto nella tua app Meta o nella connessione. Dopo averlo risolto, un owner o un editor della dashboard può scegliere **Riprova** sull’evento fallito.

## Correlati

- [Assegna strumenti agli agenti](/it/docs/agents/tools)
- [Configura i messaggi in arrivo](/it/docs/workflows/triggers)
- [Gestisci le credenziali](/it/docs/tools/credentials)