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 uno

schedule_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 programar
scheduled_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: hoy
date_toiso 8601opcional
fecha de fin (ej., "2026-03-31"). por defecto: 7 días desde el inicio