- Zapier → Social media studio: una acción de Webhooks by Zapier llama a la API REST para crear o programar una publicación.
- Social media studio → Zapier: un disparador de Webhooks by Zapier recibe los eventos que envía Social media studio (publicación publicada, publicación fallida, comentario nuevo y más).
Webhooks by Zapier puede requerir un plan de pago de Zapier. Comprueba tu plan de Zapier antes de construir nada. Del lado de Social media studio, la API REST requiere un plan Standard, Advanced o Lifetime (Lite no la incluye). El número de endpoints de webhook que puedes crear depende de tu plan; consulta el resumen de Webhooks.
Antes de empezar
1
Crea una clave de API
En Social media studio, abre Ajustes → API (app.so-me.studio/settings?tab=api) y crea una clave. Empieza por
sk_live_ y se muestra una sola vez. Consulta Autenticación.2
Encuentra los ID de tus cuentas (opcional)
Si conectaste más de una cuenta en la misma plataforma, cada publicación debe indicar cuál usar. Lista tus cuentas una vez y anota el Si solo tienes una cuenta en una plataforma, puedes omitir
id de cada una:accountId.Crear o programar una publicación desde un Zap
Añade un paso de acción: Webhooks by Zapier → POST.
Zapier construye y escapa el JSON por ti, así que el texto con comillas o saltos de línea es seguro.
Para publicar en varias plataformas, añade un paso POST por plataforma.
La solicitud equivalente, para probar fuera de Zapier:
201 con la publicación, incluidos su id y postStatus: "SCHEDULED". Asigna el id a pasos posteriores si quieres actualizar o eliminar la publicación.
Campos anidados: opciones de TikTok e hilos
Campos anidados: opciones de TikTok e hilos
Las publicaciones de TikTok necesitan Custom Request envía el cuerpo tal como lo escribes y no escapa los valores asignados. Un campo asignado que contenga comillas dobles o un salto de línea produce JSON no válido, que la API rechaza con
tiktok.privacyLevel, y los hilos usan un array threadParts. La acción POST envía datos planos clave-valor, así que usa Webhooks by Zapier → Custom Request para estos casos, con Method POST, la misma URL y los mismos encabezados más Content-Type: application/json, y el cuerpo JSON escrito en Data:400.Errores
Errores
Iniciar un Zap a partir de un evento de Social media studio
1
Crea el disparador en Zapier
Elige Webhooks by Zapier → Catch Hook como disparador y copia la URL del webhook que te da Zapier.
2
Suscribe esa URL en Social media studio
Abre Ajustes → Webhooks (app.so-me.studio/settings?tab=webhooks), añade un endpoint con la URL de Zapier y elige los eventos. O créalo con la API:La respuesta incluye el
secret de firma de la suscripción.3
Envía un evento de prueba
Haz clic en Test en la suscripción dentro de Ajustes → Webhooks y luego en Test trigger en Zapier para que aprenda los campos.
POST JSON con este sobre:
Event, Data Post Id, Data Platform, etc. El bloque data lleva IDs en lugar del contenido completo; para una publicación, llama a GET https://api.so-me.studio/v1/posts/{postId} con un paso Webhooks by Zapier → GET para leer su texto, su enlace público (shareUrl) o su failureReason.
Entre los eventos útiles para Zaps están post.published, post.failed, post.scheduled, inbox.message_received, inbox.comment_received, social.account_disconnected y quota.limit_reached. Consulta el resumen de Webhooks para ver la lista completa y el formato de payload para ver ejemplos.
Social media studio espera 10 segundos una respuesta y reintenta una entrega fallida hasta 4 veces. Una suscripción que falla 10 veces seguidas se desactiva; vuelve a activarla en Ajustes → Webhooks.