Publicar mediante la API de un servicio de publicación

Publicar con programación, en varias cuentas de varias plataformas, es un trabajo que los servicios de publicación ya hacen bien, y la mayoría ofrece una API para ello. Esta guía envía cada entrega desde su webhook directamente a esa API, de modo que cada publicación llega al servicio sin nadie en medio: su propio script, o una plataforma de automatización como Make, n8n o Zapier, está en el medio.

Para poner las publicaciones en un servicio a mano desde el correo, consulte en cambio Publicar mediante un servicio de publicación.

Recibir, comprobar la firma, responder e informar de vuelta son iguales para todos los receptores y están en Entrega por webhook. Esta página trata de lo que viene después de la respuesta.

Qué servicio

Qué es un servicio de publicación, y los servicios con sus puntos fuertes y lo que hay que tener en cuenta, incluido prescindir de uno, se comparan en Publicar mediante un servicio de publicación. Reelwire no está afiliado a ninguno de ellos, y funciona con cualquiera cuya API pueda publicar un video a partir de un enlace o un archivo. Para esta guía, compruebe en el sitio del servicio que su API publica video en cada plataforma que necesita, en los formatos que usan sus canales (un Reel 9x16 no es una publicación 1x1 del feed), y cuánto cuesta su plan para su volumen.

Paso a paso

1. Apunte Reelwire a su receptor. En una herramienta de automatización, cree un disparador de webhook y copie su dirección; con un script, use la dirección en la que escucha. En la pantalla Webhook de Reelwire (en Conexiones), péguela en Dirección del webhook y pulse Guardar; la tarjeta Obtener su código de allí tiene un receptor que funciona para empezar un script. Pulse Probar la entrega: el receptor debería mostrar una solicitud con "event": "ping".

2. Active Entrega por webhook en los canales cuyas publicaciones deban ir por esta vía, en los Ajustes de cada canal, en Canales. Desde entonces, cada publicación que les toca llega como una solicitud: consulte Webhooks para ver exactamente lo que lleva.

3. Compruebe que viene de Reelwire. Cada solicitud está firmada con el secreto de firma del espacio de trabajo, como describe Entrega por webhook; la mayoría de las herramientas de automatización también pueden calcular un HMAC. Como mínimo, acepte solo solicitudes cuyo x-reelwire-event sea uno que espere, y no actúe nunca dos veces sobre el mismo ID x-reelwire-delivery.

4. Dé cada canal al servicio. Una entrega lleva una lista de channels, uno por cada canal de la publicación que va por webhook. De cada uno, tome la dirección del video (el elemento de channels[].media cuyo kind es video, un enlace que funciona siete días), su texto (channels[].text: el pie, la descripción de la marca como disclaimer, hashtags, título y enlace tal como los admite esa plataforma; en un canal en Sin plataforma específica, la longitud de captions que convenga a donde el servicio lo publica), sus ajustes de publicación (channels[].posting, donde el servicio pueda fijarlos) y el ID del canal, y llame a la API del servicio para crear una publicación para la cuenta a la que asocie ese canal. La mayoría de los servicios toman un video por enlace; si el suyo quiere el archivo en sí, descárguelo primero y compruebe su sha256.

5. Diga que está en línea. Cuando el servicio confirma la publicación, informe de ella para ese canal, con una clave de API, creada en la pantalla Claves de API, que tenga escritura en Publicaciones:

   POST https://app.reelwire.io/v1/posts/{postId}/report
   Authorization: Bearer rw_...
   Content-Type: application/json
   
   { "status": "published", "url": "https://www.instagram.com/reel/..." }

   postId es channels[].postId de la entrega. Si el servicio no pudo publicarla, informe de "failed" con un "reason": Publicaciones muestra entonces el motivo, y alguien puede publicarla a mano. Un servicio que programa la publicación para más tarde puede decírselo solo cuando ya ha salido, mediante su propio webhook: informe entonces.

Responda rápido a la solicitud de Reelwire, con cualquier 2xx, y llame al servicio después: una respuesta que tarda más de 30 segundos cuenta como fallo, y Reelwire la envía de nuevo. La respuesta solo dice que la solicitud llegó; publicar es lo que dice el informe.

Cambios y retiradas

Los cambios siguen el mismo camino. Cuando alguien actualiza una publicación en Reelwire con Enviar solicitud de actualización en Publicaciones, el receptor recibe un post.update con el texto nuevo (y un video nuevo, donde se sustituyó); cuando alguien envía una solicitud de eliminación, un post.delete. Páselos al servicio donde su API pueda editar o eliminar, o conviértalos en una tarea para una persona donde no, e informe de "deleted" cuando una publicación ya no esté.

Si algo no llega

Lo que salió en la pantalla Actividad enumera cada solicitud que Reelwire envió, lo que respondió el receptor, y Detalles con todo lo que llevaba. Una solicitud que se rechazó se reintenta tras 10 segundos, un minuto, cinco minutos, un cuarto de hora, una hora y dos horas, y luego se abandona; Entregar de nuevo la envía una vez más.