Cómo crear un programador de redes sociales con una API: la cola, los medios y los estados de publicación
Para crear un programador de redes sociales con la Partner API de easyCoexistence, tu backend envía cada publicación a POST /channels/:id/posts con su texto, sus medios y un publish_at de entre 1 minuto y 90 días en el futuro. easyCoexistence copia los medios de inmediato y publica la publicación a su hora en Instagram, Facebook, TikTok o LinkedIn, informando cada paso como un estado y mediante los eventos post.published y post.failed.
Hasta qué fecha puede programar publicaciones la API en Instagram, Facebook, TikTok y LinkedIn; el primer horario posible es dentro de 1 minuto.
Imagen y video más grandes que easyCoexistence copia al programar una publicación; un archivo mayor se rechaza en ese momento.
Cuando una red aplica límite de tasa a una publicación, esta se reintenta antes de marcarse como fallida.
Publicaciones por API que una cuenta de Instagram puede hacer en 24 horas móviles; un carrusel cuenta como una.
Límite de TikTok de publicaciones de video por cuenta a través de su endpoint de publicación, con un máximo de seis por minuto.
¿Qué necesita un programador de la API?
Cinco cosas: un lugar para subir archivos, una llamada que pone en cola una publicación para una cuenta, una cola que publica a tiempo, una forma de cambiar de opinión y aviso de lo que pasó. La API de publicaciones ofrece cada una de ellas con la misma clave ec_live_ que conecta a tus clientes, así que el calendario, el flujo de aprobación y el redactor se quedan en tu producto.
¿Cómo se programa una publicación?
Con un POST por cuenta a https://easycoexistence.com/api/v1/channels/:id/posts, donde :id es el channel_id de la sesión de conexión del cliente. publish_at es ISO 8601 con una Z o un desfase; omítelo para publicar ahora. La respuesta es 201 con la publicación, o 422 cuando una publicación para ahora falló. Se respeta el encabezado Idempotency-Key, así que una petición repetida tras un tiempo de espera no pone la publicación en cola dos veces. El cuerpo acepta:
- text: el texto, mensaje o comentario; media: una lista de {url, type} o {
media_id}. - link: una publicación de enlace en Facebook o un artículo de LinkedIn, con un título en LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS o STORIES, inferido de los medios si se omite.- title y
disable_commentpara publicaciones de foto en TikTok;image_altpara una imagen de LinkedIn.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'¿Cómo maneja el programador los medios?
Por enlace o por subida. Un enlace HTTPS público va directo a media; un archivo que suben tus usuarios se envía a POST /media, como cuerpo de la petición con su Content-Type y Content-Length, o como {"url"}, y el media_id que devuelve se incluye en la publicación. Al programar una publicación, easyCoexistence copia sus archivos, así que tu enlace solo tiene que funcionar en ese momento. Una página web en lugar de un archivo, un 404, un tipo incorrecto o un archivo de más de 30 MB para imágenes o 1 GB para videos se rechaza en ese momento, no la mañana de la publicación.
¿Qué puede llevar la publicación de cada red?
La cola revisa cada publicación según las reglas de la red antes de aceptarla, y una publicación que incumpla una regla se rechaza con un mensaje que nombra la regla, para que tu redactor muestre el problema mientras el usuario todavía edita. Cada red admite:
¿Por qué estados pasa una publicación?
Seis, que GET /posts/:id y GET /posts informan junto con publish_at, el enlace de la publicación una vez publicada y el error de la red cuando falló:
- scheduled: en la cola, esperando su hora.
- publishing: entregada a la red.
- processing: la red todavía la está procesando, como con un video de TikTok o un contenedor de Instagram.
- published: en línea, con su enlace.
- failed: rechazada o no confirmada;
may_be_publishedmarca una que la red podría haber recibido. - canceled: eliminada antes de salir, por ti o porque su canal fue eliminado o suspendido.
¿Cómo se edita, cancela o reintenta una publicación?
PATCH /posts/:id cambia la hora o el texto de una publicación programada, y el título de una publicación de foto en TikTok; para cambiar sus medios, cancélala y programa una nueva. DELETE /posts/:id la cancela. POST /posts/:id/retry vuelve a publicar una publicación fallida, ahora mismo. Una publicación a la que una red aplicó límite de tasa se reintenta sola tras 5 minutos, 30 minutos y 2 horas, y una publicación marcada como may_be_published necesita que se revise la cuenta antes de cualquier reintento.
¿Cómo se entera el programador de lo que pasó?
Por eventos y por la lista. La URL de eventos de estado configurada en Perfil, Developers recibe post.published y post.failed, firmados con X-EC-Signature como cualquier otro evento, con la publicación y su canal, para que tu calendario marque cada una como en línea o la señale. GET /posts acepta status, from, to y limit para vistas de calendario, y GET /channels/:id/posts lista una cuenta. Una publicación que falla en segundo plano también envía un correo al propietario de tu cuenta, como máximo una vez por canal cada 3 horas.
¿Cómo encajan las publicaciones de LinkedIn en un programador?
Con una persona que aprueba cada una. Las Condiciones de la API de LinkedIn restringen el uso de sus API para automatizar publicaciones, así que un programador mantiene cada publicación de LinkedIn como borrador en tu producto hasta que una persona concreta la aprueba, y luego la envía con su publish_at. Las reglas recurrentes, los feeds y las importaciones masivas deben apuntar a las otras redes, y dejar a LinkedIn las publicaciones que alguien haya revisado.
Errores comunes
- Enviar publish_at sin desfase. Una hora local sin Z ni desfase se rechaza, así que envía 2026-11-20T09:00:00-05:00 y no la hora sola que eligió tu usuario.
- Reintentar una publicación marcada como may_be_published de inmediato. La red puede mostrarla ya, así que revisa la cuenta primero, o la publicación sale dos veces.
- Repetir un POST con tiempo de espera agotado sin Idempotency-Key. Da a cada publicación su propia clave, para que una petición repetida devuelva la publicación ya en cola en lugar de programar una segunda copia.
- Enviar archivos PNG para Instagram. La API de publicación de Instagram acepta solo JPEG, y la publicación se rechaza al programarla, así que convierte las imágenes en tu paso de subida.
easyCoexistence da a tu programador una sola cola para las cuentas de Instagram, Facebook, TikTok y LinkedIn de tus clientes, y más canales, a través de la API oficial de cada red: medios copiados al programar una publicación, seis estados, reintentos por límites de tasa y eventos de publicación firmados, 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
¿Puede una sola petición programar una publicación en varias redes?
Cada petición apunta a un canal, así que envía una por cuenta, cada una con su propio Idempotency-Key, y adapta el texto a los límites de cada red.
¿La API de publicaciones programa videos de YouTube?
YouTube programa de forma nativa. Sube el video por la API de YouTube como privado con publishAt, usando el token de GET /channels/:id?credentials=1, y YouTube lo hace público a esa hora.
¿Pueden mis usuarios ver sus publicaciones programadas en el panel de easyCoexistence?
La pantalla Publicaciones pertenece a tu cuenta, así que tu equipo ve allí Requieren atención, Próximas y Publicadas, con Cancelar, Reintentar y Descartar. Tus usuarios ven el calendario que tu producto construye a partir de GET /posts.
¿Cuánto cuesta easyCoexistence para un programador de redes sociales?
De US$ 9 a US$ 0.75 por cuenta conectada al mes, bajando a medida que tus usuarios conectan más, con programación incluida y 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