Webhook

Esta es la salida de los canales con Entrega por webhook activada: adónde se entregan sus publicaciones y cómo demuestra lo que las recibe que vienen de Reelwire. Lo encuentra en Conexiones y luego en Webhook; antes se llamaba Publicación. Lo que envió cada entrega, por correo electrónico, por webhook y por conector de plataforma, está en Actividad, bajo Lo que salió. Requiere el permiso de Administración, que también hace falta para guardar la dirección, Probar la entrega y Entregar de nuevo, y está separado a propósito de las Claves de API. Una clave va en el script que envía datos. Lo que hay en esta pantalla va en lo que recibe las publicaciones que salen. Las dos cosas las configuran personas distintas en momentos distintos.

Cuando una publicación llega a su hora se entrega, por correo electrónico, por webhook o por ambos, como indica cada canal en Canales, y quien la recibe la publica: su propio script, una automatización o un servicio de publicación detrás del webhook, o una persona que lee el correo electrónico. Un canal que se entrega solo por correo electrónico no necesita nada en esta pantalla, y sus correos electrónicos siguen apareciendo en Lo que salió en Actividad. También las publicaciones que hizo el conector de plataforma de un canal, cuyas credenciales se definen en el propio canal.

El capítulo Guías tiene una guía para cada tipo de receptor: Entrega por webhook.

La dirección de su webhook

La tarjeta Establecer la dirección de su webhook define la única dirección a la que van todas las llamadas de webhook del espacio de trabajo, y muestra cómo demuestra un receptor que vienen de Reelwire. Escríbala en Dirección del webhook (una dirección https, de hasta 2048 caracteres) y pulse Guardar. Todo tipo de llamada va allí: una publicación para entregar, un cambio en una, una solicitud de retirar una y una prueba. Una publicación que va a varios canales con Entrega por webhook activada llega como una llamada firmada que lleva todos los canales del lote. Webhooks explica qué lleva una llamada, cómo responderla y cómo comunicar de vuelta cuando una publicación ya está publicada.

El secreto de firma es todo lo que necesita un receptor: cada espacio de trabajo tiene el suyo, así que una entrega que se verifica con él es de este espacio de trabajo. Cómo comprobarlo, encabezado por encabezado, está en Webhooks.

Probar la entrega, junto a Guardar, envía ahora una llamada de prueba firmada a la dirección guardada y dice qué volvió, en un cuadro verde («Entregada: el receptor respondió 200 en 184 ms») o uno rojo («No entregado.» y por qué; cuando el receptor rechazó la firma, un recordatorio de que necesita el secreto actual de este espacio de trabajo). Llega exactamente como una entrega real, sin ninguna publicación, de modo que la comprobación de la firma de un receptor se puede probar antes de que le llegue una publicación real. Se ofrece cuando la dirección está guardada, no mientras el campo contenga un cambio sin guardar, y cada prueba es una línea en Lo que salió en Actividad. Su respuesta desaparece en cuanto se cambia la dirección o se rota el secreto, ya que se refería a los antiguos.

El secreto de firma está en un panel propio, que muestra solo su principio y su final. Debajo hay dos botones. Copiar el secreto pide la contraseña con la que inicia sesión y, en Mostrar secreto, muestra el secreto completo con Copiar, como el Copiar de una clave de API: las contraseñas incorrectas cuentan para el mismo límite que iniciar sesión, y cada vez que se muestra queda registrado en el registro de auditoría del espacio de trabajo. Rotar el secreto abre un diálogo que dice qué rompe rotar antes de que ocurra nada, y Rotar ahora hace que Reelwire cree el secreto nuevo. Después se abre en un diálogo propio, Su nuevo secreto de firma, con Copiar; Lo he guardado lo cierra, y Copiar el secreto lo vuelve a mostrar más tarde. Surte efecto en la siguiente llamada: todo lo que siga verificando con el secreto antiguo empieza a rechazar hasta que lo actualice, así que rote cuando pueda desplegar el secreto nuevo, no antes. Solo una persona con sesión iniciada puede mostrar o rotar el secreto: ninguna clave de API puede, porque ambas lo entregan.

Obtener su código

La tarjeta Obtener su código, bajo la tarjeta del webhook, es un receptor que funciona para copiar en su propio sistema, en Node.js, Python, PHP o C#: elija el lenguaje encima del código. Comprueba la firma de cada llamada con su secreto de firma, rechaza una llamada de más de cinco minutos, omite el reintento de una entrega que ya ha tratado y, por cada canal de una entrega, comunica de vuelta la publicación una vez que usted la ha publicado, lo que la pasa de Entregada a Publicada en Publicaciones. Dos valores sustituyen a sus secretos: YOUR_SIGNING_SECRET, el secreto de arriba (Copiar el secreto lo muestra), y YOUR_API_KEY, una clave con el permiso Publicaciones: escritura de las Claves de API. La comunicación va a la propia dirección de este Reelwire, así que el código funciona tal como está.