Skip to Content
FanConvert Docs
Reference

AI

Reference generated from the OpenAPI contract: AI.

3 min readOpen in ChatGPTOpen in Claude

Qui répond à ce fan : l'IA, une personne, ou personne

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

Parameters

NameInTypeRequiredDescription
creator_idpathstringyesIdentifiant de la créatrice.
conversation_idpathstringyesIdentifiant de la conversation.
platformquery"mym" | "telegram"noLa plateforme du fan. (default : mym)

Response 200

AiState

FieldTypeRequiredDescription
conversationIdstringyes
platform"mym" | "telegram"yes
creatorAiEnabledbooleanyes
control"ai" | "human" | "paused" | "blocked" | "transition"yesai = 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.

Possible errors

401 · 403 · 404 · 422 · 429 · 503 — Error format: Errors.

Example

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

Idempotency-Key header required: see Writes and idempotency.

Parameters

NameInTypeRequiredDescription
creator_idpathstringyesIdentifiant de la créatrice.
conversation_idpathstringyesIdentifiant de la conversation.
Idempotency-KeyheaderstringyesObligatoire : la même clé rejoue la même réponse, sans 2e écriture.

Response 200

AiPause

FieldTypeRequiredDescription
conversationIdstringyes
platformstringyes
pausedbooleanyestrue = l'IA ne répond plus à ce fan.
filterMode"none" | "whitelist" | "blacklist"yesLe mode du filtre de la créatrice, inchangé par l'API.

Possible errors

401 · 403 · 404 · 409 · 422 · 429 · 503 — Error format: Errors.

Example

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

Idempotency-Key header required: see Writes and idempotency.

Parameters

NameInTypeRequiredDescription
creator_idpathstringyesIdentifiant de la créatrice.
conversation_idpathstringyesIdentifiant de la conversation.
Idempotency-KeyheaderstringyesObligatoire : la même clé rejoue la même réponse, sans 2e écriture.

Response 200

AiPause

FieldTypeRequiredDescription
conversationIdstringyes
platformstringyes
pausedbooleanyestrue = l'IA ne répond plus à ce fan.
filterMode"none" | "whitelist" | "blacklist"yesLe mode du filtre de la créatrice, inchangé par l'API.

Possible errors

401 · 403 · 404 · 409 · 422 · 429 · 503 — Error format: Errors.

Example

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)"

Last updated on

On this page