referencia api/programación
programación
consulta el horario de publicación de tu workspace y programa posts para publicación futura. combina con datos de analíticas para encontrar ventanas óptimas de publicación.
get_optimal_posting_times
obtén el horario de publicación configurado y las plataformas conectadas del workspace. devuelve el horario por defecto, plataformas conectadas y cuentas seleccionadas.
> ¿cuándo debería publicar? using antwork.get_optimal_posting_times [done] horario obtenido [info] Lun-Vie: 9am, 12pm, 5pm UTC
parámetros
workspace_idstringopcional
id o nombre del workspace. opcional si el usuario solo tiene unoschedule_post
programa un post para publicación en un horario específico. el post debe existir primero como borrador.
> programa mi último borrador para mañana a las 9am using antwork.schedule_post [done] post programado [info] programado para 2026-04-01T09:00:00Z
parámetros
post_idstringrequerido
el id del post a programarscheduled_foriso 8601requerido
cuándo publicar (ej. "2026-04-01T10:00:00Z")get_calendar
obtiene los posts programados y publicados como vista de calendario, agrupados por fecha. útil para ver qué viene y encontrar huecos en la programación.
> muéstrame qué hay programado para la próxima semana using antwork.get_calendar [done] 12 posts en 5 días [info] 2026-03-24: 3 posts, 2026-03-25: 2 posts, ...
parámetros
date_fromiso 8601opcional
fecha de inicio (ej., "2026-03-24"). por defecto: hoydate_toiso 8601opcional
fecha de fin (ej., "2026-03-31"). por defecto: 7 días desde el inicio