Presentamos Customer Webhooks para PhotoRobot Cloud
PhotoRobot presenta Customer Webhooks para PhotoRobot Cloud, que conectan su DAM, PIM, ERP o automatización personalizada mediante webhooks salientes firmados.
Customer Webhooks para PhotoRobot Cloud
Sus desarrolladores y equipos de TI ya pueden conectar PhotoRobot Cloud con su DAM, PIM, ERP o automatización personalizada mediante webhooks salientes firmados. Los Customer Webhooks de PhotoRobot Cloud ofrecen una entrega de datos fiable y basada en eventos, que garantiza la plena conectividad entre su estudio y sus sistemas.
Cierre el círculo entre su estudio y sus sistemas
Asegúrese de que sus sistemas posteriores sepan cuándo cambia el estado de un elemento o se produce un evento de disponibilidad de alojamiento. Los Customer Webhooks de PhotoRobot Cloud entregan cada evento a sus endpoints, de modo que las integraciones se mantienen basadas en eventos y no en sondeo (polling).
Los eventos disponibles actualmente son:
- item.status.changed: cambio confirmado del estado de captura en un artículo.
- item.status.bulk_changed: un evento tras un cambio de estado masivo en Cloud.
- hosting.item.availability.changed: el contenido multimedia alojado pasó a estar disponible para su descarga o dejó de estarlo.
- webhook.subscription.test: solo al usar «Send test».
Entrega de datos fiable y basada en eventos
Los Customer Webhooks de PhotoRobot Cloud incluyen funciones para:
- Suscripciones a webhooks salientes gestionadas junto con sus integraciones de desarrollo.
- Entrega HTTP firmada para que los receptores puedan verificar su autenticidad.
- «Send test» y filtros para confirmar la suscripción al webhook y la verificación de la firma.
- Registro de entregas para inspeccionar el payload, el estado HTTP y los reintentos.
- Interfaz de desarrollador en Webhooks: los webhooks y las entregas se encuentran junto a las claves de API.
Hablamos su idioma en integraciones de producción
Los Customer Webhooks son el eslabón que faltaba entre la captura robotizada y los sistemas de registro de la empresa. El webhook es una señal firmada que, intencionadamente, transporta solo payloads pequeños. Tras recibir una respuesta 2xx, la integración obtiene el elemento actual desde REST v2 (pull.itemUrl / pull.deltaUrl). Los webhooks pueden notificar a un publicador o, tras la obtención de datos, ayudar a su equipo a iniciar una purga de CDN o a actualizar un anuncio en un marketplace. PhotoRobot Cloud ya habla su idioma para las integraciones de producción.
Una señal y, después, una consulta
Los payloads son pequeños a propósito. Cada payload indica el evento, la organización y (cuando procede) el artículo, además de pull.itemUrl y pull.deltaUrl. Los payloads no incluyen binarios de imagen, árboles de carpetas completos ni un registro de producto completo.
El patrón que los desarrolladores deben implementar es el siguiente:
- Reciba el POST y verifique X-PhotoRobot-Signature con el cuerpo sin procesar.
- Devuelva 2xx rápidamente: realice la importación al DAM o la actualización del marketplace en su propio worker.
- Deduplique por ID de evento. La entrega es at-least-once (al menos una vez).
- Obtenga el estado actual desde el alojamiento de REST v2 mediante las URL de consulta (pull).
Esta separación es lo que hace fiable la integración. PhotoRobot no espera a que finalice su trabajo de catálogo, y su sistema nunca trata una notificación como si fuera el catálogo.
Ejemplos habituales de uso de Customer Webhooks
Los casos de uso más habituales de Customer Webhooks en el ecosistema de PhotoRobot incluyen:
- Actualización de PIM o DAM. Suscríbase a hosting.item.availability.changed. Cuando los archivos multimedia alojados pasan a ser descargables, obtenga itemUrl y actualice el producto: spins, imágenes estáticas y metadatos en una sola pasada.
- Publicación en marketplaces. Filtre los eventos de hosting por «Became downloadable». Publique o actualice la ficha únicamente cuando PhotoRobot pueda servir realmente las imágenes.
- Visibilidad del tablero de producción. Suscríbase a item.status.changed cuando su ERP o su tablero de control de calidad necesite saber que un elemento ha pasado a EDITED, APPROVED o PUBLISHED, incluso antes de que el alojamiento esté listo.
- Actualizaciones masivas de campañas. Tras un cambio de estado de gran volumen en Cloud, llega un único evento item.status.bulk_changed con una deltaUrl. Sincronice el conjunto afectado en lugar de esperar miles de webhooks por elemento.
- Invalidación de caché o CDN. Cuando el alojamiento pasa a disponible o no disponible, purgue o precargue las rutas que su tienda online ya conoce. El webhook es el desencadenante; Hosting API es la fuente de las nuevas URL.
Cómo configurar sus Customer Webhooks
Para configurar Customer Webhooks para PhotoRobot Cloud, abra su PhotoRobot Account en modo Developers y utilice Webhooks para crear una suscripción de webhook. A continuación, dirija la suscripción a su endpoint de staging para verificar la primera entrega.
- Inicie sesión en PhotoRobot Account y abra Developers → Webhooks.
- Cree un webhook. Pegue su endpoint HTTPS, asígnele un nombre interno y seleccione los eventos que necesite.
- Copie el secreto de firma cuando aparezca: se muestra una sola vez hasta que lo rote.
- Haga clic en Send test. Confirme que llega webhook.subscription.test y que la firma se verifica.
- Abra Delivery log para inspeccionar el payload, el estado HTTP y los reintentos.
- Dirija la primera suscripción a un endpoint de pruebas (staging).
Para obtener más información técnica, incluidos el contrato para desarrolladores y ejemplos de firma, consulte PhotoRobot Developer Portal – Webhooks.
