# General Translation Integrations: Démarrage rapide
URL: https://generaltranslation.com/fr/docs/integrations/storyblok/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Connectez un espace Storyblok à General Translation et traduisez votre première story depuis le Dashboard.

Storyblok est une intégration gérée depuis le Dashboard : connectez un espace à l’aide d’identifiants et traduisez des stories sans rien installer. Les traductions sont réécrites dans chaque story sous forme de valeurs localisées au niveau des champs, puis récupérées via la Content Delivery API de Storyblok.

## Avant de commencer [#before-start]

Vous avez besoin de :

* D’un [projet](/docs/platform/dashboard/get-started) avec un plan Starter ou Enterprise.
* De l’autorisation `project:write` sur ce projet.
* De l’autorisation `translations:content:write` pour lancer des traductions.
* D’un espace Storyblok avec vos langues cibles configurées dans **Paramètres > Langues**.
* D’un jeton d’accès personnel Storyblok (un jeton de l’API de gestion).

## Démarrage rapide [#quickstart]

### 1. Configurer les langues dans Storyblok [#configure-languages]

Dans Storyblok, ouvrez votre espace et accédez à **Paramètres > Langues**. Ajoutez chaque langue vers laquelle vous souhaitez traduire.

General Translation ne propose une langue Storyblok comme paramètre régional cible que si elle est à la fois configurée dans l’espace et qu’elle correspond à un paramètre régional pris en charge par General Translation. (Voir [Locales](/docs/integrations/storyblok/reference/locales)).

### 2. Créez un jeton d’accès personnel [#create-token]

Dans Storyblok, accédez à **Mon compte > Jetons d’accès personnels** et créez un jeton. L’intégration l’utilise pour appeler l’API de gestion de Storyblok en votre nom.

Notez le **Space ID** de votre espace (un nombre, affiché dans **Paramètres > Général**) ainsi que sa **Région** (EU, US, CA, AP ou CN).

### 3. Connectez le espace dans le Dashboard [#connect-space]

Dans le Dashboard de General Translation, accédez à **projet > Integrations > Catalog** et recherchez **Storyblok**. Cliquez sur **Connect** et renseignez :

* **Space ID** — l’identifiant numérique de votre espace.
* **région** — la région où votre espace est hébergé.
* **jeton d’accès personnel** — le token de l’étape précédente.

Les identifiants sont enregistrés dans une connexion Organization pour l’espace Storyblok. L’intégration au projet est liée à cette connexion. Une fois l’opération réussie, vous arrivez sur la page de gestion de l’intégration.

### 4. Sélectionnez des stories et des paramètres régionaux, puis synchronisez [#sync-apply]

Sur la page de gestion :

1. Choisissez une ou plusieurs entrées **Story** (le sélecteur permet la recherche et de tout sélectionner ou tout désélectionner).
2. Définissez le **Paramètre régional source** (par défaut, celui de votre projet).
3. Confirmez les **Paramètres régionaux cibles** (préremplis à partir des langues configurées dans le espace, hors source).
4. Cochez éventuellement **Activer automatiquement les champs pris en charge** pour marquer les champs pris en charge comme traduisibles dans Storyblok avant la synchronisation.
5. Cliquez sur **Synchroniser et appliquer**.

General Translation lit le brouillon de chaque story, extrait les champs traduisibles, les traduit, puis réécrit les résultats dans la story sous forme de brouillon. Rien n'est publié automatiquement.

(Consultez [Traduire le contenu](/docs/integrations/storyblok/guides/translating-content) pour voir le workflow complet et le récapitulatif des résultats).

### 5. Vérifiez le brouillon dans Storyblok [#review-draft]

Ouvrez la story dans Storyblok et passez à une langue cible pour vérifier le brouillon traduit. Lorsque vous en êtes satisfait, publiez-le dans Storyblok.

Pour récupérer du contenu traduit dans votre application, interrogez la Content Delivery API de Storyblok avec le paramètre `language`. (Consultez [Utiliser du contenu traduit](/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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.