Cómo añadir publicaciones de TikTok a tu SaaS
Un SaaS añade publicaciones en TikTok conectando la cuenta de TikTok de cada cliente con un enlace alojado, y luego llamando a POST /channels/{id}/posts de easyCoexistence con un video o de 1 a 35 imágenes y una leyenda, publicado ahora o en el momento indicado en publish_at, con hasta 90 días de anticipación. La publicación sale por la API for Business de TikTok, que permite 15 publicaciones al día por cuenta, y tu backend recibe aviso cuando está en línea.
Publicaciones de video que TikTok publica por cuenta a través de su API for Business, a no más de seis por minuto.
Video más grande que acepta el endpoint de publicación de TikTok, en MP4, MOV o WebM, de 3 a 600 segundos de duración.
Número máximo de imágenes que puede tener una publicación de fotos de TikTok; cada una en JPG, JPEG o WebP, de hasta 20 MB.
Unidades de código UTF-16 que puede tener el título de una publicación de fotos de TikTok.
Con cuánta anticipación puede programar el endpoint de publicaciones de easyCoexistence una publicación de TikTok.
¿Cómo conecta un cliente su TikTok?
Mediante una sesión de conexión con el campo channel configurado como tiktok. La página alojada muestra tu nombre y Continuar con TikTok, que abre la pantalla de consentimiento de TikTok en la misma pestaña; el cliente inicia sesión, permite el acceso y llega a tu redirect_url con un channel_id. Guárdalo junto a tu cliente, ya que cada llamada de publicación indica el canal.
¿Cómo es una petición de publicación en TikTok?
Una sola POST a /channels/{id}/posts con el texto en text y el archivo en media. Omite publish_at para publicar ahora, o define una hora ISO 8601 con su desplazamiento horario para publicar después. Una publicación inmediata responde 201, o 422 con el motivo de TikTok si falló.
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"
}'Publicación de video o de fotos: qué requiere cada una
Una publicación de TikTok es un video o un conjunto de imágenes, nunca ambos, y no incluye enlace. El texto, de hasta 2,200 caracteres aquí, es la leyenda en ambos casos, y las reglas de archivo de TikTok se verifican antes de poner la publicación en cola:
| 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 |
¿Dónde deben estar los medios?
En cualquier lugar HTTPS o en el almacenamiento de easyCoexistence. TikTok descarga solo desde prefijos de URL verificados para la app, así que easyCoexistence sirve cada archivo desde su propio prefijo verificado y tú no verificas nada. Los medios de una publicación programada se copian al programarla: imágenes de hasta 30 MB y videos de hasta 1 GB, de modo que un enlace que muera antes de la hora de publicación no puede romperla. Para subir un archivo en su lugar, POST /media devuelve un media_id.
¿Cómo saber que una publicación está en línea?
Por el estado de la publicación y por los eventos. Una publicación pasa de scheduled a publishing, y luego a processing mientras TikTok descarga y revisa el archivo; easyCoexistence pregunta a TikTok su estado cada 20 segundos hasta que informa que la publicación está completa. Tu URL de eventos recibe entonces post.published con la publicación y su canal, o post.failed con el motivo de la red. GET /posts/{id} muestra lo mismo, con network_post_id y permalink una vez en línea.
¿Cómo funcionan las ediciones, cancelaciones y reintentos?
Sobre la publicación, mientras TikTok aún no la tenga. PATCH /posts/{id} cambia publish_at, text o title en una publicación programada; para cambiar los medios, cancélala con DELETE /posts/{id} y crea una nueva. POST /posts/{id}/retry vuelve a publicar una publicación fallida. Si TikTok no confirma en un plazo de 2 horas, la publicación falla con may_be_published en true, y el reintento necesita confirm en true.
¿Qué pasa con los comentarios después de la publicación?
Pueden llegar a tu producto. PUT /channels/{id}/webhook reenvía a tu endpoint, firmados, los eventos comment.update de TikTok, y tu backend responde al comentario mediante business/comment/reply/create/ de TikTok con el token de la llamada de credenciales. Las respuestas en TikTok son públicas, ya que una conexión de TikTok no tiene mensajes directos.
Errores comunes
- Enviar imágenes PNG para una publicación de fotos. TikTok solo acepta JPEG o WebP, así que la publicación se rechaza antes de entrar en cola.
- Poner un título en una publicación de video. title es para publicaciones de fotos, y un video lleva sus palabras solo en la leyenda.
- Reintentar una publicación con may_be_published en true sin revisar. TikTok puede haberla publicado ya, así que revisa la cuenta antes de reintentar con confirm.
- Planear más de 15 publicaciones al día para una cuenta. TikTok limita las publicaciones por API por cuenta, así que reparte el calendario de un cliente en varios días.
easyCoexistence añade publicaciones en TikTok a tu SaaS: tus clientes conectan sus cuentas de TikTok mediante un enlace alojado, y tu backend publica videos y fotos ahora o después, recibe aviso cuando cada una está en línea y recibe sus comentarios. La misma API cubre WhatsApp, Instagram, Facebook, YouTube, LinkedIn y más canales, con cada conexión monitoreada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Mi SaaS puede publicar videos de TikTok como borradores?
No. El endpoint de publicaciones de easyCoexistence publica el video en la cuenta, al momento o en publish_at. Usa la programación para retener una publicación hasta que el cliente esté listo.
¿TikTok permite programar publicaciones por su API?
Los endpoints de publicación de TikTok actúan en el momento en que se les llama. easyCoexistence mantiene la publicación en su cola y llama a TikTok en publish_at, con hasta 90 días de anticipación.
¿Mi SaaS puede desactivar los comentarios de una publicación en TikTok?
Sí. Configura disable_comment en true en la publicación. Cuando la configuración propia de la cuenta ya desactiva los comentarios, TikTok acepta solo true.
¿Cuánto cuesta easyCoexistence por cuenta de TikTok?
Cada cuenta de TikTok que conecten tus clientes cuesta de US$ 9 a US$ 0.75 al mes, según el tramo de tus conexiones totales, con los primeros 3 días gratis.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el