> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/integrations/overview/integrations/craft-cms.md).

# Craft CMS

Intégrez votre workflow avec Craft CMS

L'étape d'intégration Craft CMS vous permet de connecter vos workflows AirOps à votre instance Craft CMS. Cette intégration native offre des capacités complètes de gestion des entrées et des assets directement depuis vos workflows.

## Aperçu

Craft CMS est un système de gestion de contenu flexible et convivial conçu pour créer des expériences numériques personnalisées. En connectant Craft CMS à AirOps, vous pouvez automatiser la création de contenu, la publication et la gestion des assets dans vos projets Craft.

## Authentification

Avant d'utiliser l'intégration Craft CMS dans vos workflows, vous devez d'abord connecter votre compte Craft CMS dans les paramètres AirOps :

1. Accédez à **Paramètres > Intégrations**
2. Trouvez la section Craft CMS et cliquez sur "Configurer"
3. Saisissez votre **Jeton GraphQL** — un jeton avec des permissions d'écriture généré dans le panneau de contrôle de votre Craft CMS sous **GraphQL > Jetons**
4. Saisissez votre **URL du site** — l'URL de base de votre instance Craft CMS (par ex. `https://example.com`)
5. Saisissez éventuellement un **ID d'auteur par défaut** — l'ID numérique de l'utilisateur Craft CMS à attribuer par défaut comme auteur des entrées. Les actions individuelles peuvent remplacer cette valeur

{% hint style="info" %}
Votre jeton GraphQL doit disposer des permissions de lecture et d'écriture pour les entrées et les assets dans les sections que vous prévoyez d'utiliser.
{% endhint %}

## Actions disponibles

### Gestion des entrées

* **Créer une entrée** -- ajouter une nouvelle entrée à une section Craft CMS
* **Mettre à jour une entrée** -- modifier les champs, le statut ou les métadonnées d'une entrée existante
* **Obtenir une entrée** -- récupérer une seule entrée par ID ou slug
* **Lister les entrées** -- récupérer plusieurs entrées d'une section avec des filtres facultatifs
* **Supprimer une entrée** -- supprimer définitivement une entrée

### Gestion des assets

* **Obtenir un asset** -- récupérer un seul asset par ID
* **Lister les assets** -- récupérer des assets d'un volume avec des filtres facultatifs
* **Attacher un asset à une entrée** -- associer des assets existants à un champ d'assets d'une entrée
* **Supprimer un asset** -- supprimer définitivement un asset d'un volume

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-bb42b640dca84f5966c32335d30eba5ea932bd8d%2Fcraft-cms-01-actions.png?alt=media" alt="Craft CMS Integration step with the Action dropdown listing Create Entry, Update Entry, Get Entry, List Entries, Delete Entry, Get Asset, List Assets, Attach Asset to Entry, Delete Asset"><figcaption><p>Choisissez une action Craft CMS.</p></figcaption></figure>

## Paramètres de l'action

### Créer une entrée

1. **Section** (obligatoire) -- le handle de section auquel appartient l'entrée (par ex. `blog`, `news`)
2. **Type d'entrée** -- le handle du type d'entrée (par ex. `défaut`, `article`). Valeur par défaut `défaut`
3. **Titre** -- le titre de l'entrée
4. **Slug** -- le slug URL de l'entrée
5. **Statut** -- statut de l'entrée : `en ligne` ou `désactivé`
6. **Date de publication** -- la date à laquelle l'entrée doit être publiée (format ISO 8601)
7. **Date d'expiration** -- la date à laquelle l'entrée doit expirer (format ISO 8601)
8. **Champs personnalisés** -- un objet JSON des valeurs des champs personnalisés, indexé par handle de champ
9. **ID de l'auteur** -- l'ID numérique de l'auteur de l'entrée. Remplace l'ID d'auteur par défaut défini dans les identifiants

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-e53edbdf840569145aef2d402172a288ffcd58c9%2Fcraft-cms-02-create-entry.png?alt=media" alt="Craft CMS Create Entry action with section, entry type, title, slug, status, and custom fields"><figcaption><p>Créez une entrée Craft CMS à partir des sorties du workflow.</p></figcaption></figure>

### Mettre à jour une entrée

1. **ID de l'entrée** (obligatoire) -- l'ID numérique de l'entrée à mettre à jour
2. **Section** -- le handle de section auquel appartient l'entrée
3. **Type d'entrée** -- le handle du type d'entrée
4. **Titre** -- le titre de l'entrée
5. **Slug** -- le slug URL de l'entrée
6. **Statut** -- statut de l'entrée : `en ligne` ou `désactivé`
7. **Date de publication** -- la date à laquelle l'entrée doit être publiée
8. **Date d'expiration** -- la date à laquelle l'entrée doit expirer
9. **Champs personnalisés** -- un objet JSON des valeurs des champs personnalisés, indexé par handle de champ
10. **ID de l'auteur** -- l'ID numérique de l'auteur de l'entrée. Remplace l'ID d'auteur par défaut défini dans les identifiants

### Obtenir une entrée

1. **Rechercher par** (obligatoire) -- comment identifier l'entrée : `id` ou `slug`
2. **Valeur de recherche** (obligatoire) -- la valeur d'ID ou de slug à rechercher
3. **Type d'entrée** -- le handle du type d'entrée, utilisé pour construire des fragments de champs personnalisés
4. **Champs** -- liste séparée par des virgules des handles de champs personnalisés à inclure dans la réponse (par ex. `heroImage,body`)

### Lister les entrées

1. **Section** -- le handle de section à filtrer
2. **Type d'entrée** -- le handle du type d'entrée, utilisé pour construire des fragments de champs personnalisés
3. **Champs** -- liste séparée par des virgules des handles de champs personnalisés à inclure dans la réponse
4. **Recherche** -- une chaîne de requête de recherche pour filtrer les entrées
5. **Limite** -- le nombre maximal d'entrées à retourner
6. **Décalage** -- le nombre d'entrées à ignorer (pour la pagination)

### Supprimer une entrée

1. **ID de l'entrée** (obligatoire) -- l'ID numérique de l'entrée à supprimer

### Obtenir un asset

1. **ID de l'asset** (obligatoire) -- l'ID numérique de l'asset à récupérer

### Lister les assets

1. **Volume** -- le handle du volume par lequel filtrer les assets (par ex. `images`, `documents`)
2. **Recherche** -- une chaîne de requête de recherche pour filtrer les assets
3. **Limite** -- le nombre maximal d'assets à retourner

### Attacher un asset à une entrée

1. **ID de l'entrée** (obligatoire) -- l'ID numérique de l'entrée à laquelle attacher des assets
2. **Section** (obligatoire) -- le handle de section auquel appartient l'entrée
3. **Type d'entrée** -- le handle du type d'entrée
4. **Handle du champ** (obligatoire) -- le handle du champ Assets sur l'entrée (par ex. `heroImage`, `images`)
5. **ID des assets** (obligatoire) -- liste séparée par des virgules des ID d'assets à attacher (par ex. `123,456`). Remplace tous les assets existants dans le champ
6. **ID de l'auteur** -- l'ID numérique de l'auteur de l'entrée. Remplace l'ID d'auteur par défaut défini dans les identifiants

### Supprimer un asset

1. **ID de l'asset** (obligatoire) -- l'ID numérique de l'asset à supprimer

## Cas d'utilisation courants

* Créer et publier automatiquement des entrées de blog à partir de contenu généré par l'IA
* Mettre à jour en masse les statuts des entrées selon les conditions du workflow
* Attacher des images générées ou importées aux entrées comme assets principaux
* Récupérer des entrées par slug pour enrichir ou réécrire du contenu existant
* Construire des pipelines de contenu qui créent des entrées en brouillon et les publient après révision
* Nettoyer automatiquement les entrées et assets expirés ou obsolètes

{% hint style="info" %}
Remarque : l'intégration Craft CMS nécessite un jeton GraphQL avec les permissions appropriées. Assurez-vous que votre jeton accorde l'accès aux sections et volumes que vous prévoyez d'utiliser.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/fr/integrations/overview/integrations/craft-cms.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
