Collega WhatsApp, Facebook, Instagram e LinkedIn

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

Crea un’app Meta Business e aggiungi il prodotto WhatsApp.
Aggiungi e verifica il numero aziendale nel tuo WhatsApp Business Account.
Crea un utente di sistema e assegna app e WhatsApp Business Account con controllo completo.
Genera il suo token con scadenza Mai e gli scope whatsapp_business_messaging, whatsapp_business_management e business_management.
Apri Strumenti, seleziona WhatsApp e scegli Collega il numero.
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.
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.
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. 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

Crea un’app Meta Business e aggiungi il prodotto Instagram.
Scegli API setup with Instagram business login.
Usa un account Instagram Business o Creator e assicurati che chi crea il token abbia un ruolo sull’app.
Genera un token per quell’account e accetta i permessi offerti, inclusi insights, commenti e messaggi.
Apri Aggiungi strumenti in Botchi e seleziona Instagram.
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.

Crea un’app Meta Business nel portfolio aziendale che possiede le tue Pagine e i tuoi account pubblicitari, e aggiungi Marketing API.
In Impostazioni business crea un utente di sistema Admin. Assegnagli la tua app, le tue Pagine con controllo completo e i tuoi account pubblicitari.
In Integrazioni → Accesso ai lead (Leads Access), consenti all’utente di sistema di leggere i lead delle tue Pagine.
Genera il token dell’utente di sistema con scadenza Mai e i permessi elencati nel dialogo di collegamento.
Metti l’app Meta in modalità Live. Meta non restituisce lead in modalità sviluppo e può richiedere l’App Review per leads_retrieval.
Apri Strumenti, seleziona Facebook e scegli Aggiungi connessione. Dai alla connessione il nome del cliente, incolla il token e scegli Collega.
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.

Salva il segreto della tua app Meta da Impostazioni dell’app → Di base (App settings → Basic). Botchi lo verifica con l’app del token.
Nella tua app Meta aggiungi il prodotto Webhooks e seleziona Page.
Incolla l’URL di callback e il verify token mostrati in Botchi, poi scegli Verify and save.
Iscriviti al campo leadgen. Botchi iscrive automaticamente le Pagine selezionate su ogni connessione.
Crea un workflow con il trigger Facebook · Nuovo lead e scegli la connessione del cliente.
Invia un lead di prova con il Lead Ads Testing Tool 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

Crea un’app sviluppatori LinkedIn associata alla pagina LinkedIn aziendale, di cui sei admin.
Aggiungi Sign In with LinkedIn using OpenID Connect e Share on LinkedIn all’app.
Genera un token con gli scope offerti, inclusi openid, profile, email e w_member_social.
Apri Aggiungi strumenti in Botchi e seleziona LinkedIn.
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

Controlla handle, nome del membro o numero di telefono mostrato per l’account collegato.
Associa quell’account agli strumenti dell’agente, 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.