# General Translation Integrations: Quickstart
URL: https://generaltranslation.com/it/docs/integrations/storyblok/quickstart.mdx
---

title: Quickstart
description: Quickstart per collegare uno space Storyblok a General Translation e tradurre la tua prima story dal Dashboard.
related:
  links:
    - /docs/integrations/storyblok/guides/translating-content
    - /docs/integrations/storyblok/guides/managing-translations
    - /docs/integrations/storyblok/guides/using-translated-content
    - /docs/integrations/storyblok/guides/configuring-storyblok

---

Usa l'integrazione Storyblok per tradurre le story di Storyblok dal Dashboard di General Translation.

Storyblok è un'integrazione di sorgente di contenuti gestita dal Dashboard: colleghi uno space Storyblok con le credenziali, quindi traduci le story dal Dashboard — non c'è alcun pacchetto npm da installare. Le traduzioni vengono scritte di nuovo in ogni story come valori localizzati a livello di campo (la traduzione a livello di campo di Storyblok), quindi le recuperi tramite la Content Delivery API di Storyblok.

## Prima di iniziare [#before-start]

Ti servono:

* Un [Project](/docs/platform/dashboard/get-started) di General Translation con un piano che includa la funzionalità `project_integrations`.
* Il permesso `project:write` per quel Project.
* Uno space Storyblok con le lingue di destinazione configurate in **Impostazioni > Lingue**.
* Un token di accesso personale Storyblok (un token della Management API).

*Nota: se la funzionalità `project_integrations` non è inclusa nel tuo piano, la Dashboard mostra una richiesta di upgrade al posto del catalogo delle integrazioni, quindi non puoi collegare uno space.*

## Quickstart [#quickstart]

### 1. Configura le lingue in Storyblok [#configure-languages]

In Storyblok, apri il tuo space e vai su **Impostazioni > Lingue**. Aggiungi ogni lingua in cui vuoi tradurre.

General Translation rende disponibile una lingua di Storyblok come impostazione regionale di destinazione solo se è configurata nello space e corrisponde a un'impostazione regionale supportata da General Translation. Vedi [Locales](/docs/integrations/storyblok/reference/locales).

### 2. Crea un token di accesso personale [#create-token]

In Storyblok, vai su **My account > Personal access tokens** e crea un token. L'integrazione lo usa per chiamare la Storyblok Management API per tuo conto.

Prendi nota dello **Space ID** del tuo space (un numero, visualizzato in **impostazione > General**) e della relativa **Region** (EU, US, CA, AP o CN).

### 3. Collega lo space nella dashboard [#connect-space]

Nella dashboard di General Translation, vai su **Project > Integrations**, apri il catalogo e cerca **Storyblok**. Fai clic su **Connect** e inserisci:

* **Space ID** — l'ID numerico del tuo space.
* **Region** — la region in cui è ospitato il tuo space.
* **Personal access token** — il token del passaggio precedente.

Le credenziali vengono salvate nel Project. Se l'operazione va a buon fine, verrai reindirizzato alla pagina di gestione dell'integrazione.

### 4. Seleziona le story e le impostazioni regionali, quindi sincronizza [#sync-apply]

Nella pagina di gestione:

1. Scegli una o più voci **Story** (il selettore consente la ricerca e supporta la selezione di tutto o niente).
2. Imposta l'**impostazione regionale sorgente** (per impostazione predefinita viene usata l'impostazione regionale predefinita del tuo Project).
3. Conferma le **impostazioni regionali di destinazione** (predefinite in base alle lingue configurate dello space, esclusa quella sorgente).
4. Facoltativamente, seleziona **Auto-enable supported fields** per contrassegnare i campi supportati come traducibili in Storyblok prima della sincronizzazione.
5. Fai clic su **Sync and apply**.

General Translation legge la bozza di ogni story, estrae i campi traducibili, li traduce e riscrive i risultati nella story come bozza. Nulla viene pubblicato automaticamente.

Consulta [Traduzione dei contenuti](/docs/integrations/storyblok/guides/translating-content) per il workflow completo e il riepilogo dei risultati.

### 5. Rivedi la bozza in Storyblok [#review-draft]

Apri la story in Storyblok e seleziona una lingua di destinazione per rivedere la bozza tradotta. Quando sei soddisfatto, pubblicala in Storyblok.

Per recuperare i contenuti tradotti nella tua app, interroga la Content Delivery API di Storyblok con il parametro `language`. Vedi [Uso dei contenuti tradotti](/docs/integrations/storyblok/guides/using-translated-content).
## Next steps

- /docs/integrations/storyblok/guides/translating-content
- /docs/integrations/storyblok/guides/managing-translations
- /docs/integrations/storyblok/guides/using-translated-content
- /docs/integrations/storyblok/guides/configuring-storyblok