Webhooks

Entenda a página Webhooks do projeto e recupere-se quando seu portal incorporado não estiver pronto.

Webhooks permitem que outro serviço receba eventos selecionados de um projeto do Runner. Este é um recurso avançado e sensível à segurança: use-o apenas quando souber qual serviço deve receber os eventos e como esse serviço os verifica.

Caminho de entrada

Abra a página Webhooks do projeto apenas através de uma entrada que o Runner disponibiliza para seu espaço de trabalho. Se não houver entrada, não adivinhe uma URL; consulte Disponibilidade de recursos ou pergunte ao suporte se o recurso está habilitado.

Antes de começar

Use Webhooks apenas quando o Runner ou suporte expõe uma entrada aprovada.
Conheça o serviço receptor pretendido e como ele verifica eventos.
Trate endereços de endpoint, segredos de assinatura e dados entregues como sensíveis.

O que o Runner mostra

O Runner prepara o serviço de webhook antes de exibir o portal de gerenciamento incorporado.

Estado da página ou controle	O que significa ou faz
Carregando…	O Runner está verificando se o serviço de webhook está pronto.
Plataforma de webhook está inicializando	A configuração ainda está em andamento. Aguarde e mantenha a página aberta ou retorne mais tarde.
A inicialização está demorando mais do que o esperado	A configuração não foi concluída após a espera normal. Tentar novamente pede ao Runner para provisionar o serviço novamente.
Tentando novamente…	A tentativa está em andamento; o botão permanece indisponível até que a solicitação termine.
Mensagem de erro	O Runner não conseguiu preparar o serviço. Mantenha a mensagem visível para o suporte.
Portal de webhook incorporado	O serviço está pronto. Os rótulos e controles exatos dentro deste portal gerenciado pelo provedor podem mudar, então siga as instruções mostradas lá em vez de confiar em nomes de botão fixos neste guia.
Reconectar Shopify	Abre a página de integração do Shopify quando uma conexão Shopify mais antiga precisa de novas permissões de webhook. Reconecte antes de esperar que eventos do Shopify cheguem.

Recupere-se de uma inicialização longa

Aguarde a mensagem de inicialização terminar.
Se A inicialização está demorando mais do que o esperado aparecer, selecione Tentar novamente uma vez.
Aguarde o portal incorporado substituir a tela de inicialização.
Se um erro aparecer novamente, salve o nome do projeto e a mensagem exata e entre em contato com o suporte em vez de tentar novamente repetidamente.

Reconecte o Shopify quando solicitado

Leia o aviso Reconecte sua loja Shopify.
Selecione Reconectar Shopify.
Conclua o fluxo de conexão na página de integração do Shopify.
Retorne a Webhooks e confirme que o aviso de reconexão desapareceu antes de confiar na entrega de eventos.

Reconectar altera a autorização de integração da loja. Apenas uma pessoa que tem permissão para gerenciar essa conexão de loja deve continuar.

Notas de segurança

Trate endereços de endpoint, segredos de assinatura e conteúdos de eventos como sensíveis.
Adicione ou altere um destino apenas quando seu proprietário forneceu o endereço seguro correto.
Revise cada confirmação mostrada dentro do portal incorporado; suas ações podem afetar entregas futuras.
Se um valor de assinatura for exposto, substitua-o no serviço de webhook do Runner e no sistema receptor antes de enviar mais eventos.

Solução de problemas

Problema	Próximo passo
Nenhuma entrada de Webhooks	O recurso não está exposto neste espaço de trabalho. Verifique Disponibilidade de recursos.
A inicialização não termina	Use Tentar novamente uma vez e relate o estado exato se se repetir.
Mensagem de erro aparece	Mantenha a mensagem completa e o nome do projeto para o suporte.
O aviso de reconexão do Shopify permanece	Termine de reconectar na página de integração e recarregue Webhooks uma vez.
O portal incorporado está em branco ou se comporta diferentemente	Recarregue uma vez. Se persistir, capture o que está visível; a interface do provedor incorporado pode diferir por conta ou lançamento.