Passa al contenuto principale

Integrazioni

Le app Bobuild raramente vivono da sole. Questo hub indica gli stili di integrazione supportati oggi dal prodotto e i pattern usuali per collegare il resto del tuo stack.

Example

Funzionalità in prodotto​

EsigenzaUsa
UI interattiva nel tuo sito webEmbedding (incluso WordPress)
Lettura/scrittura programmaticaREST API
Creare o modificare app con un agent AIAgent AI (MCP) sul Builder
UI personalizzata con dati gestiti da BobuildCustom View
Messaggi in uscita verso personeTask e-mail
File verso gli utentiGenerazione documenti
Job temporizzatiTask pianificate
Scegliere file da Microsoft SharePoint nei form (copia in un campo File)SharePoint import
Tenere i documenti in SharePoint (campi Remote file + Task)SharePoint remote files

Pattern senza webhook nativi​

Bobuild non richiede di ospitare receiver webhook per i casi comuni. Scegli un approccio:

1. Sistema esterno interroga Bobuild (poll API)​

Un'app mobile, middleware o iPaaS (Make, Zapier, worker personalizzato) chiama i tuoi endpoint API a intervalli o su richiesta.

Ideale per: sincronizzare elenchi, verificare stato, client mobile.

2. Sistema esterno invia dati a Bobuild (scrittura API)​

I partner fanno POST su endpoint Create/Modify quando succede qualcosa nel loro sistema.

Ideale per: ricevere ordini, aggiornamenti CRM, form tool che possono chiamare HTTP.

3. Persone / operatori come ponte​

CSV tramite Importer o import Builder, più Task batch.

Ideale per: feed partner a bassa frequenza.

4. E-mail come notifica, API come system of record​

Mantieni lo stato in Bobuild; notifica le persone con Task; lascia che altro software legga lo stato via API.

App mobile​

Tratta Bobuild come backend:

  1. Definisci endpoint API consapevoli del ruolo (solo i campi di cui l'app ha bisogno).
  2. Usa l'autenticazione endpoint appropriata al client (Autenticazione API).
  3. Carica i file come documentato in File e immagini.
  4. Mantieni le regole di business in Task/validazione Bobuild così i client mobile restano leggeri.

iPaaS (stile Make / Zapier)​

Flusso approssimativo:

  1. Trigger nell'altro tool (nuovo pagamento Stripe, nuova risposta Typeform, …).
  2. Azione richiesta HTTP → endpoint Create/Modify Bobuild.
  3. Opzionale: scenario successivo che interroga un endpoint List Bobuild per lo stato.

Conserva i token API nello secret store dell'iPaaS, non in scenari pubblici.

SharePoint​

L'integrazione SharePoint ha due modalità complementari:

ModalitàTipo di campoCosa succede
Import (copia)FileBrowse SharePoint su un form; Bobuild scarica una copia locale nel campo
Remote file (link)Remote fileMemorizza un puntatore all'elemento SharePoint; apri in Bobuild via cache, o apri in SharePoint

SharePoint import (copia nel File)​

Quando SharePoint import è abilitato, ogni campo File modificabile su un form live mostra Browse SharePoint. Gli utenti autenticati scelgono un file; Bobuild lo scarica nel campo come un upload normale (i token Microsoft restano nel browser; Bobuild non memorizza refresh token).

Abilitare in Bobuild​

  1. Nel Builder, apri Settings → Integrations.
  2. Abilita SharePoint import.
  3. Incolla l'Application (client) ID di Entra (Azure AD).
  4. Opzionalmente imposta Directory (tenant) ID (lascia vuoto / common per multitenant).

Registrazione app Entra (SPA — import)​

Registra una single-page application (client pubblico, PKCE — nessun client secret richiesto per l'import):

  • Aggiungi redirect URI per ogni origine live (hostname dell'app e ogni custom domain; i wildcard non sono supportati).
  • Abilita access / ID token come richiesto per il sign-in SPA.
  • Permessi delegati (admin consent dove richiesto): Microsoft Graph User.Read, Files.Read.All, Sites.Read.All; SharePoint MyFiles.Read, AllSites.Read.

SharePoint remote files​

I campi Remote file tengono il documento in SharePoint. Bobuild memorizza un puntatore JSON (provider, id, name, web_url, etag, metadata di cache opzionali) e può scaricare in una cache locale quando qualcuno apre il file nell'app.

Flusso tipico: genera un Docx in un campo File → Task Create a remote file (SharePoint) → memorizza il puntatore su un campo Remote file. Puoi anche browse-and-link (con drive predefinito), eliminare l'elemento remoto, o copiare un remote file di nuovo in un File come originale o PDF.

Impostazioni extra per i remote file​

Sulla stessa pagina Integrations, per remotefile / azioni Task configura anche:

  • Client secret (registrazione app confidenziale — richiesta per le chiamate Graph lato server)
  • Preferisci un Tenant ID specifico per l'accesso app-only
  • Opzionale drive ID / site ID predefinito (necessario per browse-and-link)

Concedi il permesso applicazione Graph Sites.Selected e assegna l'app al sito target. I redirect URI SPA restano richiesti solo per l'import sui campi File (MSAL).

Vedi azioni Task Remote file.

Custom View + librerie esterne​

Quando ti serve un Widget specializzato (mappa, kanban, tile dashboard), mantieni auth e filtri in Bobuild e renderizza con JavaScript — Custom View. Preferiscilo rispetto all'export dei dati su un microsito separato quando il pubblico usa già il tuo portale.