Novidade: Customer Webhooks para o PhotoRobot Cloud
A PhotoRobot apresenta os Customer Webhooks para o PhotoRobot Cloud, que conectam o seu DAM, PIM, ERP ou uma automação personalizada por meio de webhooks de saída assinados.
Customer Webhooks para o PhotoRobot Cloud
Seus desenvolvedores e equipes de TI agora podem conectar o PhotoRobot Cloud ao seu DAM, PIM, ERP ou a uma automação personalizada por meio de webhooks de saída assinados. Os Customer Webhooks do PhotoRobot Cloud oferecem entrega de dados confiável e orientada a eventos, garantindo conectividade total entre seu estúdio e seus sistemas.
Feche o ciclo entre seu estúdio e seus sistemas
Garanta que seus sistemas downstream saibam quando o status de um item muda ou quando ocorre um evento de disponibilidade de hospedagem. Os Customer Webhooks do PhotoRobot Cloud entregam cada evento aos seus endpoints, para que as integrações continuem orientadas a eventos, e não baseadas em polling.
Os eventos disponíveis são:
- item.status.changed – alteração confirmada do status de captura em um item.
- item.status.bulk_changed — um evento após uma alteração de status em massa no Cloud.
- hosting.item.availability.changed — a mídia hospedada passou a estar disponível para download ou ficou indisponível.
- webhook.subscription.test — somente ao usar “Send test”.
Entrega de dados confiável e orientada a eventos
Os Customer Webhooks do PhotoRobot Cloud incluem recursos para:
- Assinaturas de webhooks de saída gerenciadas junto com suas integrações de desenvolvedor.
- Entrega HTTP assinada, para que os receptores possam verificar a autenticidade.
- “Send test” e filtros para confirmar a assinatura do webhook e a verificação da assinatura.
- Log de entregas para inspecionar o payload, o status HTTP e as novas tentativas.
- Interface de desenvolvedor em Webhooks — webhooks e entregas ficam ao lado das chaves de API.
Falando a sua língua em integrações de produção
Os Customer Webhooks são o elo que faltava entre a captura robotizada e os sistemas de registro da empresa. O webhook é um sinal assinado que, de propósito, transporta apenas payloads pequenos. Após a resposta 2xx, a integração busca o item atual na REST v2 (pull.itemUrl / pull.deltaUrl). Os webhooks podem notificar um publisher ou, depois dessa busca, ajudar sua equipe a iniciar uma limpeza de cache da CDN ou a atualizar um anúncio em marketplace. O PhotoRobot Cloud agora fala a sua língua em integrações de produção.
Um sinal e, depois, uma busca
Os payloads permanecem pequenos de propósito. Cada payload informa o evento, a organização e (quando relevante) o item, além de pull.itemUrl e pull.deltaUrl. Os payloads não contêm binários de imagem, árvores completas de pastas nem um registro completo de produto.
O padrão que os desenvolvedores devem implementar é:
- Receber o POST e verificar X-PhotoRobot-Signature em relação ao corpo bruto da requisição.
- Retornar 2xx rapidamente — fazer a importação no DAM ou a atualização no marketplace em seu próprio worker.
- Eliminar duplicidades pelo ID do evento. A entrega é feita no modelo at-least-once.
- Obter o estado atual na hospedagem REST v2 usando as URLs de pull.
Essa separação é o que torna a integração confiável. O PhotoRobot não espera a conclusão do seu job de catálogo, e o seu sistema nunca trata uma notificação como se ela fosse o catálogo.
Exemplos comuns de uso dos Customer Webhooks
Os casos de uso mais comuns dos Customer Webhooks no ecossistema PhotoRobot incluem:
- Atualização de PIM ou DAM. Assine o evento hosting.item.availability.changed. Quando a mídia hospedada estiver disponível para download, consulte o itemUrl e atualize o produto — spins, imagens estáticas e metadados em uma única passagem.
- Publicação em marketplaces. Filtre os eventos de hospedagem por “Became downloadable”. Publique ou atualize o anúncio somente depois que o PhotoRobot realmente puder entregar as imagens.
- Visibilidade do painel de produção. Assine o item.status.changed quando o seu ERP ou painel de QC precisar saber que um item passou para EDITED, APPROVED ou PUBLISHED — mesmo antes de a hospedagem estar pronta.
- Atualizações de campanha em massa. Após uma grande alteração de status no Cloud, chega um único evento item.status.bulk_changed com um deltaUrl. Sincronize o conjunto afetado em vez de esperar milhares de webhooks por item.
- Invalidação de cache ou CDN. Quando a hospedagem passa para disponível ou indisponível, limpe ou pré-aqueça os caminhos que a sua loja virtual já conhece. O webhook é o gatilho; a Hosting API é a fonte das novas URLs.
Como configurar os seus Customer Webhooks
Para configurar os Customer Webhooks do PhotoRobot Cloud, abra sua PhotoRobot Account no modo Developers e use Webhooks para criar uma assinatura de webhook. Em seguida, aponte a assinatura para o seu endpoint de staging para verificar a primeira entrega.
- Faça login na PhotoRobot Account e abra Developers → Webhooks.
- Crie um webhook. Cole o seu endpoint HTTPS, atribua um nome interno e selecione os eventos de que você precisa.
- Copie o segredo de assinatura quando ele aparecer — ele é exibido uma única vez, até você o rotacionar.
- Clique em Send test. Confirme que o evento webhook.subscription.test chegou e que a assinatura é verificada.
- Abra o Delivery log para inspecionar o payload, o status HTTP e as novas tentativas.
- Aponte a primeira assinatura para um endpoint de staging.
Para obter mais informações técnicas, incluindo o contrato para desenvolvedores e exemplos de assinatura, consulte o PhotoRobot Developer Portal – Webhooks.
