Documents-Divers/GUIDE-config-TikTok.md

GUIDE PAS-À-PAS — Configuration TikTok (Content Posting API)

TikTok a son propre écosystème développeur, indépendant de Meta et de Google. Il faut donc une app dédiée, un OAuth dédié, et — point important — un audit de l'app avant de pouvoir publier des vidéos publiques.

⚠️ Comme pour Meta, les libellés des écrans TikTok for Developers évoluent. Les principes ci-dessous sont stables.

Ce palier (C) vient après Facebook/Instagram. Tu peux préparer les comptes dès maintenant, mais le développement du driver TikTok se fera une fois le palier B validé. Le format vidéo 9:16 sera déjà prêt (mutualisé avec Instagram).

---

Vue d'ensemble

1. Compte TikTok                                 ─┐  côté réseau social
2. (recommandé) compte Business                  ─┘
3. Compte TikTok for Developers                  ─┐
4. Créer une app                                  │
5. Produit : Content Posting API                  │  côté développeur
6. Login Kit + scopes + redirect URI              │
7. Client Key + Client Secret → dans le plugin    │
8. Vérification du domaine (pour PULL_FROM_URL)    │
9. (pour publier public) Audit de l'app          ─┘

Les étapes 1→8 permettent de développer et tester en Sandbox / en mode privé (SELF_ONLY). L'étape 9 est requise pour publier des vidéos visibles publiquement.

---

PARTIE 1 — Côté réseau social

Étape 1 — Compte TikTok

Crée (ou utilise) le compte TikTok qui recevra les vidéos. Active la sécurité du compte (2FA).

Étape 2 — Compte Business (recommandé)

Dans l'app TikTok → Paramètres → Compte → Passer à un compte Business. Ce n'est pas toujours strictement exigé par l'API, mais ça débloque les statistiques et évite des limitations. Recommandé pour un usage de publication automatisée.

---

PARTIE 2 — Côté développeur

Étape 3 — Compte développeur

1. https://developers.tiktok.com → Log in avec le compte TikTok (étape 1).
2. Complète le profil développeur (email vérifié). Selon les cas, TikTok demande de rattacher l'app à une organisation — renseigne le nom de l'entreprise et le site karaokeclip.video.

Étape 4 — Créer l'app

Manage apps → Connect an app / Create an app. Nomme-la (KaraokeClip Publisher), décris son usage (« Publier automatiquement des vidéos promotionnelles de karaoké »), ajoute l'icône et le site web.

Étape 5 — Ajouter le produit « Content Posting API »

Dans l'app → Add products → Content Posting API.

• Choisis le mode Direct Post (publie directement la vidéo avec sa légende), c'est ce que le plugin utilisera. (L'autre mode, « Upload », dépose seulement un brouillon que l'utilisateur doit finaliser dans l'app — moins pratique ici.)

Étape 6 — Login Kit, scopes et redirect URI

1. Ajoute le produit Login Kit (fournit l'OAuth).
2. Scopes à demander :

   Scope	Usage
   user.info.basic	identité du compte connecté
   video.publish	publier une vidéo (Direct Post)
   video.upload	téléverser le fichier vidéo

3. Redirect URI : ajoute exactement l'URL de la page de réglages du plugin (il te la donnera). Format :

   https://staging2.karaokeclip.video/wp-admin/admin.php?page=kcp-settings
   

   Ajoute aussi l'URL de production le moment venu. Toute redirection non listée = connexion refusée.

Étape 7 — Récupérer Client Key + Client Secret

Dans les Credentials / Basic information de l'app :

• Client Key → réglage tiktok_client_key du plugin.
• Client Secret → réglage tiktok_client_secret (champ mot de passe, jamais réaffiché).

Étape 8 — Vérification du domaine (importante pour PULL_FROM_URL)

Le plugin peut livrer la vidéo à TikTok de deux façons :

• PULL_FROM_URL : TikTok télécharge la vidéo depuis une URL publique (le fichier archivé du plugin). Nécessite de prouver que tu possèdes le domaine qui héberge la vidéo → dans le portail développeur, URL properties / Domain verification, ajoute karaokeclip.video (et staging2.karaokeclip.video pour les tests) et suis la procédure (fichier à déposer ou balise DNS/meta).
• FILE_UPLOAD : le plugin téléverse directement le fichier (pas de vérif de domaine, mais transfert plus lourd).

Recommandation : vérifie le domaine (peu coûteux) pour pouvoir utiliser PULL_FROM_URL, plus léger côté serveur. Le plugin gérera un repli FILE_UPLOAD si besoin.

---

PARTIE 3 — Développement, Sandbox et audit

Mode Sandbox (test sans audit)

TikTok fournit un environnement Sandbox avec des utilisateurs de test : tu peux valider tout le flux (connexion → init → upload → publication) sans audit. Les vidéos publiées via une app non auditée sont restreintes — typiquement visibles par toi seul (privacy_level = SELF_ONLY). C'est suffisant pour valider le palier C.

Étape 9 — Audit de l'app (pour publier public)

Pour que les vidéos soient visibles publiquement, l'app doit passer l'audit TikTok :

• description claire de l'usage, respect des règles de contenu (mentions, musique, etc.),
• souvent une vidéo de démonstration du parcours,
• politique de confidentialité et conditions publiques (mêmes documents que pour Meta).

Comme pour Meta, l'audit ne bloque pas le développement : on code et on teste en Sandbox / SELF_ONLY, et on bascule privacy_level en public une fois l'app auditée.

---

Contraintes vidéo TikTok (déjà prises en compte par le profil 9:16)

• Format : vertical 9:16 recommandé (le profil portrait du plugin, mutualisé avec Instagram).
• Conteneur : MP4 (H.264/AAC) — c'est déjà ce que produit FFmpeg.
• Durée : le profil portrait est plafonné (≤ 90 s côté IG) ; TikTok accepte plus long, mais on reste sur le rendu commun.
• Légende : caption unique (titre + description + hashtags fusionnés), comme Instagram.

---

Récapitulatif « ce que tu me fourniras » (au palier C)

• Client Key + Client Secret (collés dans le plugin).
• Confirmation que le domaine est vérifié dans le portail (si on part sur PULL_FROM_URL).
• Le compte TikTok cible connecté via le bouton « Se connecter à TikTok » du plugin.

Fin du guide TikTok.