Référence
IA
Référence générée depuis le contrat OpenAPI : IA.
Qui répond à ce fan : l'IA, une personne, ou personne
GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai · getAiState
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
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
401 · 403 · 404 · 422 · 429 · 503 — Format des erreurs : Erreurs.
Exemple
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
POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/pause · pauseAi
En-tête Idempotency-Key obligatoire : voir Écritures et idempotence.
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. |
Idempotency-Key | en-tête | string | oui | Obligatoire : la même clé rejoue la même réponse, sans 2e écriture. |
Réponse 200
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
401 · 403 · 404 · 409 · 422 · 429 · 503 — Format des erreurs : Erreurs.
Exemple
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
POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/resume · resumeAi
En-tête Idempotency-Key obligatoire : voir Écritures et idempotence.
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. |
Idempotency-Key | en-tête | string | oui | Obligatoire : la même clé rejoue la même réponse, sans 2e écriture. |
Réponse 200
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
401 · 403 · 404 · 409 · 422 · 429 · 503 — Format des erreurs : Erreurs.
Exemple
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)"Mis à jour le