Hub Connettori

L'Hub Connettori di SiTeBoS offre uno "spinotto universale" per collegare i propri account e provider esterni già in uso in azienda. Le credenziali API restano di esclusiva proprietà e responsabilità del titolare secondo i suoi accordi commerciali stipulati con ciascun provider: SiTeBoS funge solo da ponte software per abilitare la comunicazione diretta tra i servizi.

Integrazioni Esterne Self-Service

SiteBoS offre lo spinotto universale per collegare i tuoi account partner esterni. L'ottenimento e il mantenimento delle credenziali API sono a carico della tua azienda secondo i tuoi accordi commerciali con i singoli provider.

Nell'applicazione, la pagina è accessibile in qualsiasi momento aprendo il menu Identity → Hub Connettori (oppure direttamente dall'Architect Desk). Di seguito viene analizzata ciascuna sezione di integrazione presente nella pagina reale.

Piattaforme Delivery

Per le attività di ristorazione e food delivery, SiTeBoS gestisce gli ordini tramite una logica a "Doppio Binario":

Binario 1 — Integrazione API Automatica: Se disponi di credenziali API fornite dalla piattaforma (Glovo Partner API, Deliveroo Order API, Just Eat JET Connect), puoi inserirle qui per ricevere gli ordini automaticamente via webhook in Console Cucina.
Binario 2 — Riconoscimento Istantaneo da Foto (Senza API): Se non possiedi le credenziali API, puoi sempre utilizzare il riconoscimento istantaneo inquadrando lo schermo del tablet con il Bot Telegram: l'intelligenza artificiale estrae piatti, quantità e modifiche senza richiedere alcun collegamento.

Per chi desidera abilitare il collegamento diretto con le 3 piattaforme supportate, ecco i parametri richiesti:

Glovo Partner API

Schema Verificato

Interruttore On/Off

Attiva l'interruttore e compila i campi ricavati dal Glovo Vendor Portal:

Glovo Webhook Token / Secret: Incolla il token generato nel Glovo Vendor Portal.
Store ID / Indirizzo Negozio Glovo: Il codice identificativo del negozio (es. GLOVO-STORE-10928).
Endpoint Webhook Generato: SiteBoS genera automaticamente il tuo URL webhook univoco. Premi il pulsante Copia e incollalo nelle impostazioni webhook del portale Glovo.

Deliveroo Order API

Modalità Difensiva

Interruttore On/Off

Attiva l'interruttore e inserisci le credenziali Deliveroo Partner:

Deliveroo Webhook Secret / API Key: Incolla il webhook secret fornito dal portale Deliveroo.
Deliveroo Location / Brand ID: L'identificativo della sede o brand (es. LOC-88219).
Endpoint Webhook Generato: Copia l'URL di destinazione generato da SiteBoS tramite il tasto Copia e salvalo su Deliveroo.

Just Eat (JET Connect)

JET Connect

Interruttore On/Off

Configurazione per il protocollo di connessione Just Eat:

Just Eat API Key / Secret: Incolla l'API Key fornita dal portale Just Eat.
Restaurant ID Just Eat: Il codice identificativo del ristorante (es. JE-REST-4019).
Endpoint Webhook Generato: Premi il pulsante Copia per ottenere l'URL webhook e inseriscilo nel portale Just Eat.

Provider Pagamenti e POS

Collegando un gateway di pagamento o POS esterno si abilitano gli incassi diretti su conto corrente aziendale tramite link e all'interno della Telegram WebApp. Sono supportati 5 provider:

Stripe Direct Gateway

Carte & Wallet

Cosa serve: Inserisci la Secret Key o Restricted Key (formato sk_live_...) per accettare carte, Apple Pay e Google Pay.

Satispay Business

Micropagamenti

Cosa serve: Inserisci il Codice di Attivazione / Activation Code generato dal pannello Satispay Business.

Nexi XPay

Gateway Nazionale

Cosa serve: Incolla la Chiave API Nexi XPay ed il Codice Esercente (es. 1234567).

SumUp Checkout

POS Virtuale

Cosa serve: Inserisci la Chiave Segreta API (formato sup_sk_live_...) ed il Codice Commerciante (es. MC123456).

PayPal Commerce

Conto PayPal & Carte

Cosa serve: Inserisci l'identificativo Client ID e la chiave Client Secret ricavati dal portale sviluppatori PayPal.

Canale Offerte Telegram

A differenza di altre integrazioni ancora in fase di attivazione, il Canale Offerte Telegram è un connettore GIÀ ATTIVO e pienamente funzionante.

Questo connettore sfrutta un canale Telegram (e non messaggi diretti): chi desidera ricevere promozioni o novità si iscrive volontariamente al canale. Questo azzera totalmente qualsiasi rischio che il bot venga segnalato o bloccato per invio massivo.

Procedura di Collegamento in 4 Passaggi

Apri Telegram e crea un nuovo Canale (menu → Nuovo Canale).
Dai un nome al canale (es. "Offerte [Nome Attività]") e pubblicalo pubblico o privato, come preferisci.
Vai su Amministratori del canale → Aggiungi Amministratore → cerca il tuo bot e rendilo amministratore con permesso di pubblicare messaggi.
Fatto! Il collegamento viene rilevato automaticamente entro pochi secondi — la pagina mostrerà "Canale Collegato" con il nome del canale.

Non c'è nulla da salvare manualmente: il rilevamento avviene in automatico e il badge in alto passa da Non Collegato a Canale Collegato con il nome del canale associato. Se in seguito il bot venisse rimosso dagli amministratori del canale, lo stato si aggiornerà segnalando "Admin Rimosso".

Archiviazione Foto Evidenza su Google Drive

Collegando il proprio account Google Drive personale, le fotografie di evidenza scattate dagli operatori durante le lavorazioni o i controlli qualità vengono archiviate lì, restano sullo spazio esterno di proprietà del titolare, e SiteBoS conserva solo il collegamento sicuro.

Collegamento Diretto

Un solo pulsante "Collega il tuo Google Drive" permette di autorizzare l'accesso in sicurezza. Il sistema creerà e sincronizzerà in automatico la cartella dedicata SiteBoS — Evidenze.

WhatsApp Business — Promemoria Automatici

Questo connettore è progettato per inviare promemoria automatici ai clienti con pulsanti interattivi di conferma o disdetta dell'appuntamento tramite il proprio numero WhatsApp Business aziendale.

Prossimamente Connettore in Preparazione

A differenza delle altre sezioni, questo connettore è ancora in preparazione e non è attivabile oggi. Il pulsante è attualmente disattivato in attesa del completamento di una fase di verifica in corso lato SiteBoS.

La procedura guidata già predisposta nella pagina (che sarà resa operativa al termine della fase di verifica) prevede i seguenti passaggi:

Premere il pulsante Collega WhatsApp Business.
Accedere al proprio account Facebook aziendale tramite il modulo guidato.
Selezionare il proprio Portfolio Aziendale e il proprio Account WhatsApp Business.
Verificare il numero di telefono dedicato tramite il codice ricevuto via messaggio.
Confermare i permessi per completare il collegamento automatico del canale.

Integrazioni Omnichannel: Social e Risponditore WhatsApp

Questa sezione permette di orchestrare la presenza e la comunicazione multicanale dell'azienda attraverso due sotto-moduli:

OmniSocials

Pubblicazione e Messaggi In Arrivo

Automatizza la pubblicazione di contenuti e la gestione centralizzata dei messaggi in arrivo sulle principali reti social aziendali (Instagram, Facebook, LinkedIn, X).

Come si attiva: Richiede l'inserimento di una Chiave API OmniSocials (es. sk_omni_live_...) e la selezione delle piattaforme abilitate tramite le apposite caselle di spunta.

Collegamento Risponditore WhatsApp

Nessun Server Richiesto — Utile Subito

A differenza del promemoria automatico ancora in preparazione della sezione 5, questo strumento è utile ed operativo SUBITO senza richiedere server esterni o verifiche aggiuntive.

SiteBoS genera un link automatico nel formato https://t.me/TuoBot_bot?start=wa (visibile solo se il Bot Telegram è già stato associato nel Profilo Titolare, Capitolo 02).

Come usarlo: Copia il link tramite il pulsante Copia e incollalo nel Messaggio di Benvenuto del tuo WhatsApp Business esistente. In questo modo, tutti i clienti che ti scrivono su WhatsApp possono essere indirizzati con un solo tocco dentro il Bot Telegram di SiteBoS per consultare il catalogo, richiedere preventivi o fissare appuntamenti.

Portali Immobiliari e Multiposting (Doppio Binario Real Estate)

Per le agenzie immobiliari e le attività di property management, SiTeBoS implementa una logica a "Doppio Binario" per la distribuzione sincronizzata degli annunci:

Binario 1 — Feed Pull Automatico (Immobiliare.it, Casa.it, Subito.it e Meta Catalog): I portali interrogano periodicamente i due feed XML generati automaticamente dal backend di SiteBoS. L'agenzia deve solo copiare l'URL e registrarlo una tantum nel pannello di gestione di ciascun portale. La pubblicazione su Subito.it avviene di riflesso tramite il network di distribuzione di Immobiliare.it.
Binario 2 — Attivazione Partner Commerciale (Idealista): L'integrazione richiede un accordo di agenzia attivo con Idealista e la richiesta esplicita di abilitazione del feed al servizio clienti del portale, che rilascerà le credenziali API (Chiave API e Client Secret) da inserire nella pagina connettori.

Feed MLS Portali Nazionali

Standard MLS XML

Sola Lettura • Copia Rapida

Genera in tempo reale il feed di tutti gli immobili marcati come disponibili nel catalogo:

URL Generato: /telegram/api/wh.php?w=wh_53/{partita_iva}.xml
Utilizzo: Incolla questo link nella sezione feed XML di Immobiliare.it o Casa.it. I motori dei portali effettueranno il download periodico automatico senza alcun intervento manuale.

Feed Meta Real Estate Catalog

Catalogo Facebook / Instagram

Sola Lettura • Copia Rapida

Feed ottimizzato per il catalogo dinamico annunci immobiliari di Meta Business Suite:

URL Generato: /telegram/api/wh.php?w=wh_53-meta/{partita_iva}.xml
Utilizzo: Registra il feed in Meta Commerce Manager per abilitare campagne dinamiche di re-targeting e vetrina annunci sulle pagine Facebook e profili Instagram dell'agenzia.

Idealista Partner

Attivazione Partner Obbligatoria

Non Self-Service

A differenza dei feed pull standard, il portale Idealista non supporta l'auto-attivazione:

Procedura: Contattare il proprio referente commerciale o il servizio clienti di Idealista per richiedere la registrazione del feed SiteBoS e l'emissione delle credenziali.
Credenziali Richieste: Inserire la Chiave API e il Client Secret ricevuti da Idealista nella scheda connettori per abilitare la trasmissione automatica.

Responsabilità Credenziali e Salvataggio

Le credenziali inserite in questa pagina sono piena responsabilità del titolare: SiteBoS non genera né vende questi account, ma funge unicamente da collegamento. Per attivare, modificare o disattivare un connettore è sufficiente premere il pulsante "Salva Configurazioni Connettori" nella barra fissa presente in fondo alla pagina reale.