Ajouter la publication TikTok à votre SaaS
Un SaaS ajoute la publication TikTok en connectant le compte TikTok de chaque client via un lien hébergé, puis en appelant POST /channels/{id}/posts d’easyCoexistence avec une vidéo ou de 1 à 35 images et une légende, maintenant ou à une heure publish_at jusqu’à 90 jours à l’avance. La publication part par l’API for Business de TikTok, qui autorise 15 publications par jour et par compte, et votre backend est prévenu dès qu’elle est en ligne.
Publications vidéo que TikTok met en ligne par compte via son API for Business, à six par minute au maximum.
Vidéo la plus grande acceptée par l’endpoint de publication de TikTok, en MP4, MOV ou WebM, de 3 à 600 secondes.
Nombre maximal d’images dans une publication photo TikTok ; chacune en JPG, JPEG ou WebP, jusqu’à 20 Mo.
Unités de code UTF-16 que peut contenir le titre d’une publication photo TikTok.
Délai maximal de programmation d’une publication TikTok par l’endpoint posts d’easyCoexistence.
Comment un client connecte-t-il TikTok ?
Par une session de connexion avec channel réglé sur tiktok. La page hébergée affiche votre nom et le bouton « Continue with TikTok », qui ouvre l’écran de consentement de TikTok dans le même onglet ; le client se connecte, autorise l’accès et arrive sur votre redirect_url avec un channel_id. Conservez-le avec votre client, car chaque appel de publication désigne le canal.
À quoi ressemble une requête de publication TikTok ?
Un seul POST vers /channels/{id}/posts, avec la légende dans text et le fichier dans media. Omettez publish_at pour publier maintenant, ou indiquez une heure ISO 8601 avec son décalage pour publier plus tard. Une publication immédiate répond 201, ou 422 avec le motif de TikTok en cas d’échec.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: tt_video_5530" \
-d '{
"text": "Behind the scenes of our new store #opening",
"media": [{ "url": "https://cdn.example.com/store-tour.mp4", "type": "video" }],
"disable_comment": false,
"publish_at": "2026-11-10T18:00:00-05:00"
}'Publication vidéo ou photo : que demande chacune ?
Une publication TikTok est soit une vidéo, soit un ensemble d’images, jamais les deux, et ne contient aucun lien. Le texte, jusqu’à 2 200 caractères ici, sert de légende dans les deux cas, et les règles de fichier de TikTok sont vérifiées avant la mise en file d’attente :
| Video post | Photo post | |
|---|---|---|
| Media | One video, MP4, MOV or WebM | 1 to 35 images, JPEG or WebP |
| Size | Up to 1 GB, 3 to 600 seconds, at least 360 px | Up to 20 MB per image |
| Title | None; the caption only | title, up to 90 characters |
| Comments | disable_comment turns them off | disable_comment turns them off |
Où doivent se trouver les médias ?
N’importe où en HTTPS, ou dans le stockage d’easyCoexistence. TikTok ne télécharge qu’à partir de préfixes d’URL vérifiés pour l’application ; easyCoexistence sert donc chaque fichier depuis son propre préfixe vérifié, et vous n’avez rien à vérifier. Les médias d’une publication programmée sont copiés au moment de la programmation, jusqu’à 30 Mo pour les images et 1 Go pour les vidéos, si bien qu’un lien qui expire avant l’heure de publication ne peut pas la faire échouer. Pour envoyer un fichier directement, POST /media renvoie un media_id.
Comment savoir qu’une publication est en ligne ?
Grâce au statut de la publication et aux événements. Elle passe de scheduled à publishing, puis à processing pendant que TikTok télécharge et vérifie le fichier ; easyCoexistence interroge TikTok toutes les 20 secondes jusqu’à ce qu’il indique la publication comme terminée. Votre URL d’événements reçoit alors post.published avec la publication et son canal, ou post.failed avec le motif du réseau. GET /posts/{id} donne les mêmes informations, avec network_post_id et permalink une fois en ligne.
Comment fonctionnent les modifications, annulations et nouvelles tentatives ?
Sur la publication, tant que TikTok ne l’a pas encore reçue. PATCH /posts/{id} modifie publish_at, text ou title d’une publication programmée ; pour changer le média, annulez-la avec DELETE /posts/{id} et créez-en une nouvelle. POST /posts/{id}/retry republie une publication en échec. Si TikTok ne confirme pas dans les 2 heures, la publication échoue avec may_be_published à true, et la nouvelle tentative exige confirm à true.
Que se passe-t-il avec les commentaires après la publication ?
Ils peuvent atteindre votre produit. PUT /channels/{id}/webhook transmet les événements comment.update de TikTok à votre endpoint, signés, et votre backend répond au commentaire via business/comment/reply/create/ de TikTok, avec le token obtenu lors de l’appel d’identifiants. Les réponses sur TikTok sont publiques, car une connexion TikTok n’a pas de messages privés.
Erreurs courantes
- Envoyer des images PNG pour une publication photo. TikTok n’accepte que le JPEG ou le WebP, si bien que la publication est refusée avant d’être mise en file d’attente.
- Mettre un titre sur une publication vidéo. title est réservé aux publications photo ; une vidéo porte son texte uniquement dans la légende.
- Relancer une publication avec may_be_published à true sans vérifier. TikTok a peut-être déjà publié, donc contrôlez le compte avant de relancer avec confirm.
- Prévoir plus de 15 publications par jour pour un même compte. TikTok plafonne les publications API par compte ; répartissez donc le calendrier d’un client sur plusieurs jours.
easyCoexistence ajoute la publication TikTok à votre SaaS : vos clients connectent leurs comptes TikTok via un lien hébergé, et votre backend publie vidéos et photos maintenant ou plus tard, est prévenu dès que chacune est en ligne et reçoit ses commentaires. La même API couvre WhatsApp, Instagram, Facebook, YouTube, LinkedIn et d’autres canaux, chaque connexion étant surveillée 24/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Mon SaaS peut-il publier des vidéos TikTok en brouillon ?
Non. L’endpoint de publication d’easyCoexistence publie la vidéo sur le compte, immédiatement ou à publish_at. Utilisez la programmation pour retenir une publication jusqu’à ce que le client soit prêt.
TikTok permet-il de programmer des publications via son API ?
Les endpoints de publication de TikTok agissent au moment de l’appel. easyCoexistence conserve la publication dans sa file d’attente et appelle TikTok à publish_at, jusqu’à 90 jours à l’avance.
Mon SaaS peut-il désactiver les commentaires d’une publication TikTok ?
Oui. Réglez disable_comment à true sur la publication. Lorsque les paramètres du compte désactivent déjà les commentaires, TikTok n’accepte que true.
Combien coûte easyCoexistence par compte TikTok ?
Chaque compte TikTok que vos clients connectent coûte de US$ 9 à US$ 0,75 par mois, selon la tranche de votre total de connexions, avec un essai gratuit de 3 jours.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le