Webhooks

Inspecione os destinos do webhook e a atividade de entrega ou recupere quando o portal do provedor 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 Criar → Webhooks quando Runner disponibilizar a entrada para seu espaço de trabalho. Se não houver nenhuma entrada, não adivinhe uma URL; consulte Disponibilidade do recurso ou pergunte ao suporte se o recurso está ativado.

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

Seu espaço de trabalho pode mostrar o ambiente de trabalho webhook do Runner ou um portal de provedor incorporado. Siga a seção que corresponde à sua tela.

Inspecione a bancada de trabalho Runner

Condicional: quando o ambiente de trabalho primário estiver ativado, use estas guias:

Guia	O que avaliar
Pontos finais	Destinos de recebimento configurados e seus status.
Catálogo	Tipos de eventos disponíveis antes de escolher o que um destino receberá.
Registros	Entregas registradas e seu status devolvido.
Atividade	Atividade recente de webhook.

Abra Pontos finais e identifique o destino que pretende fiscalizar.
Leia Catálogo para verificar o tipo de evento relevante.
Abra Registros e veja uma entrega disponível para aquele destino.
Compare seu status com o registro do próprio serviço de recebimento antes de declarar que a entrega foi bem-sucedida.

Confira: um endpoint salvo confirma a configuração; um registro de entrega bem-sucedido e um registro de destinatário correspondente confirmam esse evento específico. Um log vazio não prova que a entrega está funcionando. Ações de teste, reenvio e repetição enviam eventos; use-os apenas para um teste pretendido.

Portal de provedor incorporado

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
A carregar…	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.