Integrazioni

La scheda Integrazioni permette al tuo agente di ottenere dati in tempo reale da servizi esterni durante una conversazione. Una volta collegato, l'agente chiama automaticamente il servizio giusto quando un visitatore pone una domanda pertinente — senza attivazione manuale.

Vai su il tuo agente → Integrazioni per configurare uno dei servizi seguenti.

Disponibilità per piano: calendari (Cal.com, Calendly) e corrieri sono disponibili da Base in su. E-commerce, CRM e pagamenti richiedono Business e superiori. Vedi Piani e fatturazione.

Pianificazione

Cal.com

Permette all'agente di mostrare gli slot liberi dal tuo calendario Cal.com.

1. In Cal.com, apri l'evento da condividere e copia il suo URL pubblico (es. cal.com/yourname/30min).
2. Incolla l'URL nel campo Cal.com Event URL e clicca su Salva.

Calendly

Permette all'agente di mostrare gli slot liberi dal tuo calendario Calendly.

1. Copia l'URL dell'evento da Calendly (es. calendly.com/yourname/30min).
2. Vai su Calendly → Integrations → API & Webhooks → Personal Access Tokens e genera un token.
3. Incolla sia l'URL dell'evento che il token, poi clicca su Salva.

Il token è necessario perché l'API di disponibilità di Calendly è autenticata. Viene memorizzato cifrato e mai esposto ai visitatori.

E-commerce

Quando un'integrazione e-commerce trova prodotti corrispondenti, i risultati appaiono come un carosello di prodotti scorrevole nella chat — immagine, nome, prezzo e link — non come semplice testo.

Shopify

Consente all'agente di cercare nel tuo catalogo prodotti e di verificare lo stato dell'ordine di un cliente — pagamento, evasione e numero di tracciamento. Prima di rivelare i dettagli dell'ordine, l'agente chiede di confermare il telefono o l'email usati nell'ordine, così nessuno può consultare l'ordine di un'altra persona.

1. Inserisci il dominio del tuo negozio (es. mystore.myshopify.com) e clicca su Collega Shopify.
2. Autorizza l'accesso in Shopify e approva i permessi richiesti.
3. Dopo l'approvazione verrai reindirizzato e l'integrazione mostrerà Collegato.

WooCommerce

Permette all'agente di consultare stato e dettagli di un ordine tramite numero.

1. In WordPress vai su WooCommerce → Settings → Advanced → REST API e clicca su Add key.
2. Imposta i permessi su Read, genera la chiave e copia la Consumer Key e il Consumer Secret.
3. Inserisci l'URL del tuo negozio ed entrambe le chiavi in BotChata, poi clicca su Collega WooCommerce.

PrestaShop

Permette all'agente di cercare nel tuo catalogo prodotti.

1. Nell'admin PrestaShop, vai su Advanced Parameters → Webservice e attiva il webservice.
2. Aggiungi una nuova chiave con accesso in lettura ai prodotti e copia la API key generata.
3. Inserisci l'URL del tuo negozio e la chiave API in BotChata e clicca su Salva.

Shoper

Permette all'agente di cercare nel catalogo del tuo negozio Shoper.

1. Nell'admin Shoper, crea un accesso API (un utente applicativo) nelle impostazioni API.
2. Inserisci l'URL del tuo negozio e le credenziali API in BotChata e clicca su Salva.

Magento

Permette all'agente di cercare nel tuo catalogo Magento.

1. Nell'admin Magento, vai su System → Integrations e crea un'integrazione con accesso in lettura al catalogo.
2. Copia l'Access Token.
3. Inserisci l'URL del tuo negozio e il token in BotChata e clicca su Salva.

Spedizione e tracciamento

Tutte le integrazioni di spedizione funzionano allo stesso modo: l'agente chiede al visitatore il numero di tracciamento e restituisce lo stato attuale della spedizione direttamente in chat.

InPost

1. Accedi a InPost Manager e vai su API.
2. Genera o copia la tua chiave API.
3. Incollala in BotChata e clicca su Salva.

DHL

1. Registrati su developer.dhl.com (disponibile un piano gratuito).
2. Crea un'app e copia la API key.
3. Incollala in BotChata e clicca su Salva.

DPD

1. Contatta il tuo account manager DPD o registrati su developer.dpd.de per ottenere una chiave API.
2. Incolla la chiave in BotChata e clicca su Salva.

GLS

1. Accedi al tuo account myGLS Business.
2. Usa username e password delle tue credenziali myGLS Business.
3. Inserisci entrambi i campi in BotChata e clicca su Salva.

Nova Poshta

1. Apri il cabinet personale di Nova Poshta e vai su Impostazioni → API.
2. Copia la tua chiave API.
3. Incollala in BotChata e clicca su Salva.

UPS

UPS usa OAuth2 client credentials.

1. Registrati su developer.ups.com e vai su My Apps → Create App.
2. Copia il Client ID e il Client Secret.
3. Inserisci entrambi in BotChata e clicca su Salva.

BotChata scambia automaticamente le credenziali con un token bearer e lo rinnova prima della scadenza — non devi gestire i token manualmente.

FedEx

Anche FedEx usa OAuth2 client credentials.

1. Registrati su developer.fedex.com e vai su My Projects → Create Project.
2. Copia il Client ID e il Client Secret.
3. Inserisci entrambi in BotChata e clicca su Salva.

CRM

HubSpot

Permette all'agente di cercare un contatto nel tuo CRM tramite indirizzo email.

1. In HubSpot vai su Settings → Integrations → Private Apps e crea una nuova app.
2. Concedi almeno lo scope crm.objects.contacts.read.
3. Copia il Private App Token (inizia con pat-).
4. Incollalo in BotChata e clicca su Salva.

L'agente restituisce nome, telefono e azienda del contatto — i campi interni sensibili vengono filtrati automaticamente.

Pipedrive

Permette all'agente di cercare una persona o una trattativa nel tuo CRM Pipedrive.

1. In Pipedrive vai su Settings → Personal preferences → API e copia il tuo API token.
2. Inserisci il dominio della tua azienda e il token in BotChata e clicca su Salva.

Pagamenti

Stripe

Permette all'agente di verificare lo stato di pagamento recente di un cliente tramite il suo indirizzo email.

1. Apri Stripe Dashboard → Developers → API keys.
2. Copia la Secret Key (sk_live_ in produzione o sk_test_ in modalità test).
3. Incollala in BotChata e clicca su Salva.

Per maggiore sicurezza usa una Restricted key con il solo permesso charges: read.

Consigli

• Più integrazioni possono essere attive contemporaneamente. L'agente sceglie quella giusta in base a ciò che chiede il visitatore.
• Scollega in qualsiasi momento cliccando sul link rosso Scollega sotto un'integrazione collegata — le credenziali memorizzate vengono eliminate immediatamente.
• Le credenziali vengono cifrate con Fernet (AES-128) prima della memorizzazione e non vengono mai restituite al browser.
• Ogni scheda di integrazione ha un pulsante Prova connessione — usalo per confermare che le tue credenziali funzionano prima della messa in produzione.
• Se una chiamata di integrazione fallisce durante una conversazione (es. l'API è offline), l'agente ricorre alla sua conoscenza addestrata e informa il visitatore che non è riuscito a recuperare dati in tempo reale.