# IA

> Référence générée depuis le contrat OpenAPI : IA.

URL : https://docs.fanconvert.ai/fr/api/reference/ia

{/* Généré par scripts/generer-reference.mjs depuis openapi/public-v1.json : ne pas modifier à la main. */}

## Qui répond à ce fan : l'IA, une personne, ou personne [#qui-répond-à-ce-fan--lia-une-personne-ou-personne]

`GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai` · `getAiState`

### Paramètres [#paramètres]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `conversation_id` | chemin | string | oui | Identifiant de la conversation. |
| `platform` | requête | "mym" \| "telegram" | non | La plateforme du fan. (défaut : `mym`) |

### Réponse 200 [#réponse-200]

**`AiState`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `conversationId` | string | oui |  |
| `platform` | "mym" \| "telegram" | oui |  |
| `creatorAiEnabled` | boolean | oui |  |
| `control` | "ai" \| "human" \| "paused" \| "blocked" \| "transition" | oui | ai = l'IA répond ; human = une personne a la main ; paused = personne ne répond ; blocked = un envoi précédent est à vérifier ; transition = un changement est en cours. |

### Erreurs possibles [#erreurs-possibles]

`401` · `403` · `404` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/ai" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## Mettre l'IA en pause sur ce fan (« Arrêter le chatting »), MYM [#mettre-lia-en-pause-sur-ce-fan--arrêter-le-chatting--mym]

`POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/pause` · `pauseAi`

En-tête `Idempotency-Key` obligatoire : voir [Écritures et idempotence](/fr/api/rest/ecritures).

### Paramètres [#paramètres-1]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `conversation_id` | chemin | string | oui | Identifiant de la conversation. |
| `Idempotency-Key` | en-tête | string | oui | Obligatoire : la même clé rejoue la même réponse, sans 2e écriture. |

### Réponse 200 [#réponse-200-1]

**`AiPause`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `conversationId` | string | oui |  |
| `platform` | string | oui |  |
| `paused` | boolean | oui | true = l'IA ne répond plus à ce fan. |
| `filterMode` | "none" \| "whitelist" \| "blacklist" | oui | Le mode du filtre de la créatrice, inchangé par l'API. |

### Erreurs possibles [#erreurs-possibles-1]

`401` · `403` · `404` · `409` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple-1]

```bash
curl -X POST "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/pause" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Rendre ce fan à l'IA (« Relancer le chatting »), MYM [#rendre-ce-fan-à-lia--relancer-le-chatting--mym]

`POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/resume` · `resumeAi`

En-tête `Idempotency-Key` obligatoire : voir [Écritures et idempotence](/fr/api/rest/ecritures).

### Paramètres [#paramètres-2]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `conversation_id` | chemin | string | oui | Identifiant de la conversation. |
| `Idempotency-Key` | en-tête | string | oui | Obligatoire : la même clé rejoue la même réponse, sans 2e écriture. |

### Réponse 200 [#réponse-200-2]

**`AiPause`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `conversationId` | string | oui |  |
| `platform` | string | oui |  |
| `paused` | boolean | oui | true = l'IA ne répond plus à ce fan. |
| `filterMode` | "none" \| "whitelist" \| "blacklist" | oui | Le mode du filtre de la créatrice, inchangé par l'API. |

### Erreurs possibles [#erreurs-possibles-2]

`401` · `403` · `404` · `409` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple-2]

```bash
curl -X POST "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/resume" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```