Connettori API (Webhooks)

Eventi, Endpoint, Sincronizzazione, Automazione, Parametri, Gestione stato

Modulo:
Sviluppatori > Webhooks

Descrizione: Questo strumento permette al sistema di inviare notifiche automatiche in tempo reale ad applicazioni e servizi esterni ogni volta che si verifica un evento specifico all'interno di Framework360.

A cosa serve? (Esempi pratici)

I Connettori API sono essenziali per automatizzare il flusso di dati tra Framework360 e altri software aziendali, riducendo il lavoro manuale e garantendo che tutti i sistemi siano sincronizzati.

  • Sincronizzazione CRM: Usalo per notificare il tuo Customer Relationship Management (CRM) ogni volta che un nuovo utente si registra o un potenziale cliente compila un modulo.
  • Gestione Ordini e Magazzino: Invia automaticamente i dettagli di un ordine completato al tuo gestionale di magazzino o al software di fatturazione.
  • Automazione Marketing: Attiva flussi di lavoro complessi su piattaforme esterne (es. invio di SMS, creazione di task) non appena un cliente raggiunge un determinato obiettivo.

Funzionalità principali

La gestione dei Connettori API si articola nelle seguenti funzioni:

  • Elenco e Stato: Visualizzazione rapida di tutti i connettori configurati, inclusi il tipo di evento monitorato, l'indirizzo di destinazione e lo stato (Attivo/Non attivo).
  • Definizione dell'Evento: Possibilità di selezionare da un elenco predefinito quale evento interno (es. 'Nuovo Utente', 'Ordine Pagato', ecc.) deve scatenare la notifica.
  • Indirizzo di Destinazione (Endpoint): Impostazione dell'URL esatto del servizio esterno che deve ricevere i dati.
  • Personalizzazione dei Dati: Capacità di definire esattamente quali informazioni aggiuntive devono essere inviate (dati POST) e come devono essere inviate (parametri HEADER).
  • Attivazione/Disattivazione: Controllo immediato sull'operatività del connettore senza doverlo eliminare.

Come si configura

Per creare o modificare un Connettore API, è necessario compilare i seguenti campi:

CampoDescrizioneNote
TipologiaSeleziona l'evento specifico all'interno di Framework360 che deve attivare la notifica.Esempio: "Quando un utente si registra".
URL di DestinazioneL'indirizzo web (Endpoint) del sistema esterno che riceverà i dati.Questo campo è obbligatorio e deve essere un URL valido.
AttivoSpunta questa casella per rendere operativo il connettore.Se non spuntato, il connettore non invierà notifiche.

Parametri personalizzati

Questa sezione permette di definire dati e istruzioni aggiuntive per l'applicazione esterna. Questi campi richiedono l'inserimento di dati in un formato strutturato (JSON) per garantire che il sistema ricevente possa interpretarli correttamente.

SezioneScopo
Parametri POSTDati inviati nel corpo della richiesta. Utilizzato per trasmettere payload di informazioni specifiche (ad esempio, chiavi di autenticazione o dati aggiuntivi non inclusi automaticamente).
Parametri HEADERInformazioni aggiuntive inviate nell'intestazione della richiesta. Spesso utilizzato per l'autenticazione API (token) o per specificare il formato dei dati.

Importante: I dati inseriti in queste sezioni devono rispettare rigorosamente il formato richiesto. In caso contrario, il sistema non salverà la configurazione e mostrerà un messaggio di errore.

Integrazioni automatiche

Questo modulo è il cuore delle automazioni in tempo reale.

Quando l'evento selezionato nella Tipologia si verifica (es. un cliente completa un acquisto), il sistema esegue automaticamente le seguenti operazioni:

1. Raccoglie le informazioni relative all'evento.

2. Costruisce una richiesta dati includendo eventuali Parametri personalizzati definiti.

3. Invia questa richiesta all'URL di Destinazione specificato, garantendo che l'applicazione esterna venga informata immediatamente.

Questo processo avviene in background e non richiede alcuna interazione manuale da parte dell'utente dopo la configurazione iniziale.