# Conversations

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

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

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

## Les conversations d'une créatrice [#les-conversations-dune-créatrice]

`GET /public/v1/creators/{creator_id}/conversations` · `listConversations`

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

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `creator_id` | chemin | string | oui | Identifiant de la créatrice. |
| `platform` | requête | "mym" \| "telegram" \| "onlyfans" | non | La plateforme de la conversation. (défaut : `mym`) |
| `limit` | requête | integer | non | Taille de la page. (défaut : `50`) |
| `cursor` | requête | string \| null | non | Le `nextCursor` de la page précédente. |

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

**`Page_Conversation_`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `items` | Conversation[] | oui |  |
| `nextCursor` | string \| null | non | À repasser en `cursor` pour lire la page suivante ; null = dernière page. |

**`Conversation`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui | Identifiant de la conversation sur sa plateforme (MYM : le chat id). |
| `platform` | "mym" \| "telegram" \| "onlyfans" | oui |  |
| `fan` | Fan | oui |  |
| `lastFanMessageAt` | string (date-time) \| null | oui |  |
| `lastMessageAt` | string (date-time) \| null | oui |  |
| `unreadCount` | integer \| null | non | Messages du fan non lus, quand la plateforme les compte. |
| `hasPurchased` | boolean \| null | non |  |

**`Fan`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `name` | string \| null | oui |  |
| `username` | string \| null | non |  |

### 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" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## Les messages d'une conversation [#les-messages-dune-conversation]

`GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/messages` · `listMessages`

### 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. |
| `platform` | requête | "mym" \| "telegram" \| "onlyfans" | non | La plateforme de la conversation. (défaut : `mym`) |
| `limit` | requête | integer | non | Taille de la page. (défaut : `50`) |
| `cursor` | requête | string \| null | non | Le `nextCursor` de la page précédente. |

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

**`Page_Message_`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `items` | Message[] | oui |  |
| `nextCursor` | string \| null | non | À repasser en `cursor` pour lire la page suivante ; null = dernière page. |

**`Message`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui |  |
| `direction` | "fan" \| "creator" | oui |  |
| `text` | string | oui |  |
| `sentAt` | string (date-time) \| null | oui |  |
| `media` | MessageMedia[] | oui |  |

**`MessageMedia`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `status` | "paid" \| "pending" \| "refused" \| "free" \| "unknown" | oui |  |
| `priceMinor` | integer \| null | non |  |
| `currency` | string \| null | non |  |

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

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

### Exemple [#exemple-1]

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