9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
84 lines
3.4 KiB
Plaintext
84 lines
3.4 KiB
Plaintext
---
|
|
title: Chiavi API e webhook
|
|
info: "Crea e gestisci le chiavi API per l'autenticazione e imposta i webhook per le notifiche in tempo reale."
|
|
image: /images/user-guide/api/api.png
|
|
sectionInfo: Impara a collegare Twenty ai tuoi altri strumenti.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/api/api.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## API Keys
|
|
|
|
Le chiavi API consentono l'accesso automatizzato ai tuoi dati CRM, sincronizzano i dati con altri sistemi e creano integrazioni o soluzioni personalizzate.
|
|
|
|
### Crea una chiave API
|
|
|
|
1. Go to **Settings → APIs & Webhooks**
|
|
2. Fai clic su **+ Crea chiave** in alto a destra
|
|
3. Configura la tua chiave API:
|
|
- **Nome**: Assegna un nome descrittivo alla tua chiave API
|
|
- **Data di scadenza**: Imposta quando deve scadere la chiave
|
|
4. Fai clic su **Salva** per generare la tua chiave API
|
|
5. **Importante**: Copia e conserva immediatamente la tua chiave API, viene mostrata una sola volta
|
|
|
|
Una volta creata, la tua chiave API fornisce l'accesso alla documentazione personalizzata dell'API e al playground dove puoi testare gli endpoint con il tuo modello dei dati reale.
|
|
|
|
<Warning>
|
|
Poiché la tua chiave API dà accesso a informazioni sensibili, non dovresti condividerla con servizi di cui non ti fidi completamente. Se trapelata, qualcuno potrebbe usarla in modo malevolo. Se la sicurezza della tua chiave API è compromessa, disabilitala immediatamente e genera una nuova.
|
|
</Warning>
|
|
<VimeoEmbed videoId="928786722" title="Creating API key" />
|
|
|
|
### Gestisci chiavi API
|
|
|
|
**Rigenera una chiave API:**
|
|
|
|
1. Go to **Settings → APIs & Webhooks**
|
|
2. Fai clic sulla chiave API che desideri rigenerare
|
|
3. Fai clic sul pulsante **Rigenera**
|
|
4. Copia e memorizza immediatamente la nuova chiave API
|
|
|
|
**Elimina una chiave API:**
|
|
|
|
1. Trova la chiave API nel tuo elenco
|
|
2. Clicca sulla chiave per aprire i suoi dettagli
|
|
3. Clicca su **Elimina** per rimuoverla in modo permanente
|
|
|
|
## Webhooks
|
|
|
|
I webhook consentono aggiornamenti immediati al tuo URL specificato riguardo a modifiche o eventi relativi ai dati dei tuoi clienti.
|
|
|
|
Ad esempio, quando un'opportunità passa a "Chiuso Vinto", un webhook può automaticamente attivare la creazione della fattura nel tuo sistema contabile. Nota che questo tipo di automazione può essere ottenuto anche utilizzando la funzione [Workflows di Twenty](/l/it/user-guide/workflows/getting-started-workflows) in-app, che offre trigger basati su aggiornamenti di campo per automazione interna.
|
|
|
|
I webhook sono ideali per l'integrazione con sistemi esterni, mentre i Workflows supportano sia l'automazione interna che le connessioni con strumenti esterni tramite trigger webhook, nodi di codice e nodi HTTP.
|
|
|
|
### Crea un Webhook
|
|
|
|
1. Vai a **Impostazioni → API e Webhook → Webhook**
|
|
2. Clicca su **+ Crea webhook**
|
|
3. Inserisci il tuo URL webhook (dove desideri ricevere le notifiche)
|
|
4. Clicca su **Salva**
|
|
|
|
Il tuo webhook inizierà immediatamente a ricevere notifiche in tempo reale sulle modifiche ai tuoi dati CRM.
|
|
|
|
<VimeoEmbed videoId="928786708" title="Video demonstration" />
|
|
|
|
### Gestisci Webhook
|
|
|
|
**Elimina un Webhook:**
|
|
|
|
1. Vai a **Impostazioni → API e Webhook → Webhook**
|
|
2. Trova il webhook che desideri rimuovere
|
|
3. Clicca sul webhook
|
|
4. Clicca su **Elimina** e conferma nel popup
|
|
|
|
**Modifica un Webhook:**
|
|
|
|
1. Clicca sul webhook che vuoi modificare
|
|
2. Aggiorna l'URL o altre impostazioni
|
|
3. Clicca su **Salva** per applicare le modifiche
|
|
|