Crear una publicación en redes sociales

Crea una publicación para una marca en una o varias de sus cuentas de redes sociales conectadas. La misma llamada abarca los tres ciclos de vida: guardar un DRAFT, poner un SCHEDULE en cola o PUBLISH de inmediato.

Caso de uso: programar una campaña desde tu propio calendario. Tu aplicación ya sabe qué quiere decir un cliente y cuándo. Para cada franja horaria, llama a este endpoint con action: "SCHEDULE" y con scheduledAt o con scheduleDate + scheduleTime, y pasa tu propio identificador de franja horaria como clientReference para poder relacionar los registros sin almacenar el UUID devuelto. Muestra la entrada como pendiente hasta que GET /social/posts/{postId} indique que se ha publicado en todos los canales, y ofrece un botón de cancelación conectado a POST /social/posts/cancel.

La publicación es asíncrona

action: "PUBLISH" no publica antes de responder. La llamada acepta la publicación, devuelve un socialPostId y la entrega al proceso de publicación. Para saber qué ha ocurrido realmente, consulta periódicamente GET /social/posts/{postId} y lee el array channels[] de resultados por canal: el status de cada entrada es el resultado de esa plataforma concreta. Una publicación puede completarse correctamente en Instagram y fallar en LinkedIn dentro de la misma solicitud, por lo que channels[] es la fuente de verdad y el status de la publicación es un resumen.

Elegir una programación

action: "SCHEDULE" requiere exactamente una de estas dos formas, nunca ambas:

Enviar ambas formas, enviar scheduleDate sin scheduleTime o enviar un scheduledAt sin desfase horario provoca el rechazo con SY95046. DRAFT y PUBLISH no deben incluir ninguna programación.

Notas.

• El cuerpo de la solicitud debe estar contenido en un objeto input.
• Comprueba success, no el estado HTTP. Los errores de validación se devuelven como HTTP 200 con success: false y una entrada en el array error por cada problema. No se crea nada cuando success es false.
• La marca se identifica en el cuerpo como socialProfileId. brandId solo se utiliza como un elemento de la ruta de la URL, nunca como un campo del cuerpo.
• Cada plataforma de platforms debe tener ya una conexión en la marca. Una plataforma sin un canal activo falla con SY95045; consulta primero las conexiones de la marca y dirige al usuario a un enlace de conexión para cualquier conexión que falte.
• Los valores de plataforma son los nombres de enumeración en mayúsculas FACEBOOK, INSTAGRAM, TWITTER, LINKEDIN, PINTEREST. TWITTER es X; el valor conservó su nombre anterior y se rechaza cualquier valor en minúsculas.
• Instagram y Pinterest no aceptan publicaciones que solo contengan texto: proporciona al menos una entrada en mediaUrls cuando cualquiera de las dos esté en platforms.
• Los IDs de publicación son UUIDs simples, no los IDs relay en Base64 que usan las publicaciones de ubicación.
• Para crear más de unas pocas publicaciones de una sola vez, usa POST /social/bulk-posts, que acepta la misma estructura de fila y valida todo el lote de antemano.

Operación de escritura: no se ha ejecutado en la cuenta real. La solicitud y la respuesta mostradas se han generado a partir del esquema de la API; al ejecutarse, esta operación publica en cuentas reales de redes sociales.