antworkDOCS

Antwork para Zapier

Convierte cualquier disparador de Zapier en un borrador de Antwork y después prográmalo o publícalo en tus cuentas sociales conectadas. Cada post empieza como borrador, y nada se hace público salvo que tu Zap tenga un paso que lo envíe.

EstadoBeta, solo con invitaciónAccesoClave de API
Añade Antwork a tu cuenta de Zapier

Qué hace

Antwork redacta, programa y publica posts en las cuentas sociales que conectas. La integración con Zapier lo lleva a cualquier Zap: una fila nueva en una hoja, una respuesta de un formulario, una entrada de RSS o un lanzamiento pueden convertirse en un borrador de Antwork, y un paso posterior del mismo Zap puede programarlo o publicarlo.

Disparador

PasoQué hace
New Published PostLanza un Zap cuando un post se publica en una cuenta social a través de Antwork. Filtros opcionales: espacio de trabajo y cuenta social. Necesita read.

Acciones

PasoQué hace
Create Draft PostGuarda un borrador para una cuenta social, con URLs de medios y una hora propuesta opcionales. Nunca publica. Necesita write, y media para las URLs de medios.
Schedule PostPrograma un post existente. Se hace público en la cuenta social a la hora que indiques. Necesita publish.
Publish Post Now (Goes Public)Publica un post existente en ese momento. Necesita publish.

Búsqueda

PasoQué hace
Find PostBusca un post de Antwork por su ID. Necesita read.

Cómo acceder

La integración está en beta y, por ahora, se accede con invitación. Abre el enlace de invitación con tu sesión de Zapier iniciada, acéptala y Antwork aparecerá entre tus apps al crear un Zap.

Añade Antwork a tu cuenta de Zapier

También necesitas una cuenta de Antwork con al menos una cuenta social conectada. Registrarse es gratis. Crea una cuenta de Antwork

Conecta tu cuenta

Zapier inicia sesión en Antwork con una clave de API. La creas una vez en Antwork y la pegas en Zapier.

  1. En Antwork, abre tu espacio de trabajo y ve a Configuración > Desarrollador > Gestionar claves de API.
  2. Crea una clave y ponle un nombre, por ejemplo Zapier. Cópiala en ese momento: empieza por ak_ y solo se muestra una vez, porque Antwork guarda únicamente su hash.
  3. En Zapier, añade un paso de Antwork, elige conectar una cuenta nueva y pega la clave en API Key. Zapier nombra la conexión con tu espacio de trabajo.

Permisos que necesita cada paso

Una clave lleva permisos (scopes), y todos incluyen read. Las claves creadas en Configuración llevan los cuatro, así que una sola clave sirve para todos los pasos de Antwork en Zapier.

PermisoLo usa
readTodos los pasos: la prueba de conexión, los desplegables de espacio y cuenta, New Published Post y Find Post.
writeCreate Draft Post.
publishSchedule Post y Publish Post Now.
mediaLas URLs de medios de Create Draft Post.
Una clave es tuya y llega a todos los espacios de trabajo que tienes. Para cortar el acceso de Zapier, revoca la clave en el mismo sitio donde la creaste.

Claves de API y permisos

Cómo se comporta cada paso

Create Draft Post

  • Siempre guarda un borrador. Nunca publica, envíe lo que envíe el disparador.
  • Una cuenta social por paso. Para publicar la misma idea en varias cuentas, añade un paso Create Draft Post por cuenta, cada uno con un texto escrito para esa plataforma. Nunca se envía un mismo texto a varias cuentas.
  • Las URLs de medios son enlaces públicos a imágenes, vídeos o PDF. Antwork descarga cada uno en tu biblioteca de medios y después lo adjunta al borrador. Necesita el permiso media.
  • Proposed Time solo guarda una hora en el borrador. No programa nada; para eso añade Schedule Post.
  • La salida incluye el Post ID para el siguiente paso, un enlace para editar el borrador en Antwork, y si el texto supera el límite de caracteres o la plataforma aún necesita medios, para que un filtro de Zapier pueda parar antes de enviar.

Schedule Post

Recibe un Post ID y una hora de publicación (Publish At), en el futuro y como mucho a 30 días vista. El post se hace público en la cuenta social a esa hora. Puedes desprogramarlo desde Antwork.

Publish Post Now (Goes Public)

Recibe un Post ID y lo publica en la cuenta social al momento. El post es público en cuanto se ejecuta el paso, y no se puede deshacer desde Zapier.

Find Post

Busca un post por su ID. Si ningún post coincide, la búsqueda no devuelve resultado en lugar de un error, así que el Zap puede ramificar según eso.

New Published Post

Un disparador por sondeo: Zapier consulta en Antwork los posts recién publicados con la frecuencia de tu plan de Zapier, así que un Zap arranca unos minutos después de que el post se publique, no en el mismo segundo. Deja vacíos el espacio y la cuenta para vigilarlos todos.

Posts de TikTok

TikTok pide al titular de la cuenta que elija la audiencia, las interacciones y la divulgación de cada post, así que esas decisiones son tuyas, post a post, y Zapier nunca las toma. Create Draft Post funciona con TikTok, pero Schedule Post y Publish Post Now sobre un post de TikTok fallan con un enlace al post en Antwork, donde eliges los ajustes y lo envías.

Pasos repetidos

Cada paso que crea o envía algo lleva una clave formada por el Zap, el paso y sus datos. Si Zapier repite un paso, Antwork devuelve la primera respuesta en lugar de crear un segundo borrador o publicar dos veces. En la práctica:

  • El mismo Zap enviando datos idénticos dos veces en 24 horas crea un solo post, no dos.
  • Volver a ejecutar Publish Post Now sobre el mismo post en 24 horas devuelve el primer resultado en lugar de reintentarlo. Para reintentar un post fallido, hazlo desde Antwork.

Errores y soluciones

Cuando Antwork rechaza un paso, Zapier muestra el mensaje de Antwork con una pista. Los más comunes:

ErrorQué hacer
insufficient_scopeA la clave le falta el permiso que necesita este paso. Crea una clave en Configuración > Desarrollador > Gestionar claves de API y vuelve a conectar Antwork en Zapier.
401La clave se revocó o ya no es válida. Zapier te pide reconectar: crea una clave nueva y pégala en la conexión.
429Demasiadas peticiones en poco tiempo. Zapier espera el tiempo que indica Antwork y reintenta solo.
text_too_longEl texto supera el límite de caracteres de la plataforma. Acórtalo antes de publicar.
media_requiredLa plataforma necesita medios: Instagram (imagen o vídeo), YouTube (vídeo), TikTok (vídeo) y Pinterest (imagen o vídeo). Añade una URL de medios al borrador.
tiktok_choices_neededElige los ajustes de TikTok en el post dentro de Antwork y publícalo o prográmalo desde allí.
pinterest_board_requiredLos pines de Pinterest necesitan un tablero. Elige uno en el post dentro de Antwork.
token_invalidHay que reconectar la cuenta social en Antwork, en Conexiones.
subscription_inactiveTu suscripción de Antwork está inactiva. Reactívala en Facturación.
idempotency_in_flightLa misma petición sigue en curso. Zapier la reintenta en breve.

Los límites de caracteres y los formatos de medios de cada red están en la referencia de plataformas, y los límites de peticiones en la introducción a la API REST.

Preguntas

4
¿Es gratis?
La integración no cuesta nada extra. El plan gratis de Antwork cubre 2 cuentas sociales conectadas y 10 publicaciones al mes; Pro cuesta 19 $ al mes por 5 cuentas con publicaciones ilimitadas. Tus Zaps cuentan además para los límites de tu plan de Zapier, como cualquier otra app.
¿Zapier publica sin mi aprobación?
No. Create Draft Post solo guarda un borrador. Un post sale únicamente si tu Zap incluye un paso Schedule Post o Publish Post Now para él, así que sin esos pasos cada post te espera en Antwork.
¿Con qué redes sociales funciona?
Con todas las redes en las que publica Antwork: X (Twitter), LinkedIn, Facebook, Threads, Instagram, YouTube, TikTok, Pinterest, Bluesky, Discord, Mastodon y Telegram. Los posts de TikTok se pueden redactar desde Zapier; eliges sus ajustes de TikTok y los envías desde Antwork.
¿Un paso puede publicar en varias cuentas?
No. Un paso Create Draft Post es una cuenta, así que añade un paso por cuenta y escribe el texto para esa plataforma.

Ayuda y enlaces

Los pasos de Zapier funcionan sobre la API REST pública de Antwork, así que la referencia de la API describe cada campo y error con más detalle.

¿Dudas, o un Zap que no se comporta como esperas? Escribe a iker.gonzalez@antwork.io.

¿Algo no cuadra? Dinos cuál.