# General Translation Integrations: Configurer Storyblok
URL: https://generaltranslation.com/fr/docs/integrations/storyblok/guides/configuring-storyblok.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Comment connecter un espace Storyblok à General Translation à l’aide d’identifiants et de champs traduisibles.

Connectez un espace Storyblok à General Translation et préparez-le pour pouvoir traduire les stories. Storyblok est une intégration gérée dans le Dashboard : vous le connectez à l’aide d’identifiants, et non d’un package npm.

## Avant de commencer [#before-start]

La connexion à Storyblok nécessite :

* la permission `project:write` sur le projet. Sans elle, l’action **Connect** n’est pas disponible.
* un forfait Starter ou Enterprise. Sans cela, le Dashboard affiche une invite de mise à niveau à la place du catalogue des intégrations, ce qui vous empêche de connecter un espace.

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

Dans Storyblok, ouvrez votre espace et accédez à **Paramètres &gt; Langues**. Ajoutez chaque langue que vous souhaitez utiliser comme cible de traduction.

Les paramètres régionaux cibles que vous pouvez sélectionner dans le Dashboard proviennent de cette liste ; configurez-les donc ici en premier. Une langue n’est proposée que si elle correspond également à un paramètre régional pris en charge par General Translation. (Consultez [Locales](/docs/integrations/storyblok/reference/locales)).

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

L’intégration s’authentifie auprès de l’API de gestion de Storyblok à l’aide d’un jeton d’accès personnel.

Dans Storyblok, accédez à **My account &gt; Personal access tokens** et créez un jeton. Notez également votre **Space ID** (**Paramètres &gt; General**) ainsi que la **Region** dans laquelle votre space est hébergé.

## Connecter l’espace [#connect-space]

Dans le Dashboard, accédez à **Project &gt; Integrations &gt; Catalog**, recherchez **Storyblok**, puis cliquez sur **Connect**. Renseignez :

* **Space ID** — l’ID numérique de l’espace. Un `#` initial est supprimé automatiquement.
* **Region** — l’une des valeurs **EU**, **US**, **CA**, **AP** ou **CN**.
* **jeton d’accès personnel** — votre jeton pour l’API de gestion.

Les identifiants sont enregistrés dans une connexion Organization pour l’espace Storyblok. L’intégration au projet est liée à cette connexion. Si l’opération réussit, vous êtes redirigé vers la page de gestion de l’intégration.

Pour la liste complète des paramètres de connexion et de leur mode de stockage, consultez [Paramètres de connexion](/docs/integrations/storyblok/reference/connection).

## Activer les champs traduisibles [#enable-fields]

Storyblok n’accepte une traduction au niveau d’un champ que si ce champ est marqué `translatable: true` dans son schéma de composant. General Translation ignore les champs pris en charge qui ne sont pas traduisibles, donc activez-les avant de traduire.

Vous avez deux options.

a) **Activation automatique depuis le Dashboard.** Sur la page de gestion, cochez **Activer automatiquement les champs pris en charge** avant de lancer **Sync and apply**. General Translation met à jour les schémas de vos composants Storyblok afin que les champs `text`, `textarea`, `markdown`, `richtext` et `table` pris en charge passent à `translatable: true`. Les champs déjà marqués comme traduisibles restent inchangés, et le récapitulatif des résultats indique combien de champs et de composants ont été mis à jour.

b) **Modifier le schéma dans Storyblok.** Dans la Block Library de Storyblok, ouvrez un composant, sélectionnez un champ, puis activez son option de traduction. Répétez l’opération pour chaque champ que vous souhaitez traduire.

*Remarque : l’activation automatique modifie tous les composants du space, pas uniquement ceux des stories que vous avez sélectionnées.*

## Rouvrir l’intégration [#reopen]

Rouvrez l’intégration depuis **Project &gt; Integrations &gt; Connected** pour lancer d’autres traductions. L’enregistrement de connexion sous-jacent de l’Organization apparaît dans **Organization &gt; Connections**.

## Next steps

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

## Sitemap

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