---
title: Webhooks
description: 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](./feature-availability) 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

1. Aguarde a mensagem de inicialização terminar.
2. Se **A inicialização está demorando mais do que o esperado** aparecer, selecione **Tentar novamente** uma vez.
3. Aguarde o portal incorporado substituir a tela de inicialização.
4. 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

1. Leia o aviso **Reconecte sua loja Shopify**.
2. Selecione **Reconectar Shopify**.
3. Conclua o fluxo de conexão na página de integração do Shopify.
4. 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](./feature-availability). |
| 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. |

## Guias relacionados

- [Disponibilidade de recursos](./feature-availability)
- [Segurança e sessões](../account-and-settings/security-and-sessions)
- [Solução de problemas de aplicativos](../apps-and-integrations/troubleshooting)
- [Suporte e comunidade](../help-and-reference/support-and-community)