> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Enviando eventos do workspace com webhooks > Envie uma requisição assinada para seus próprios sistemas quando algo acontecer no seu workspace. Crie, ative, pause e gerencie webhooks de saída nas configurações do workspace. Os webhooks de saída avisam seus próprios sistemas quando algo muda no seu workspace. Quando algo acontece, como a publicação de um app ou o chat de IA terminando uma resposta, a Base44 envia uma requisição assinada para a URL que você escolher. Assim, seus sistemas ficam atualizados sem precisar verificar mudanças. > [!WARNING] > > Você precisa de um plano Enterprise (Business ou Enterprise) para usar webhooks de saída, e apenas proprietários e admins do workspace podem gerenciá-los. Seus desenvolvedores precisam primeiro de um receptor na URL. Para saber como criar um, veja a [visão geral dos webhooks de saída](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md). ![A aba Outgoing listando 4 webhooks: 2 ativos, 1 pausado e 1 pendente](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhooks-list.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=9db3c1b0c640a60be866ef912e96fca4) Webhooks de saída na página Webhooks *** ## Criando um webhook Crie um webhook para cada URL que deve receber eventos. Você pode criar até 10 por workspace. Um novo webhook fica como **Pending** e não recebe nada até você ativá-lo. Depois que você o cria, a Base44 mostra a chave pública de assinatura do seu workspace. Seu receptor usa essa chave para confirmar que cada requisição veio da Base44. A chave pode ser compartilhada com seus desenvolvedores com segurança. **Para criar um webhook:** 1. Clique no nome do seu workspace no canto inferior esquerdo e clique em **Settings**. 2. Clique em **Webhooks** na barra lateral e depois na aba **Outgoing**. 3. Clique em **Create webhook**. 4. Digite a **Endpoint URL**. Ela precisa começar com `https://`. 5. Em **Events to send**, selecione os eventos que essa URL deve receber. Há 2 tipos: * **App events:** Um app do seu workspace é criado, publicado, tirado do ar, movido para a lixeira ou restaurado da lixeira. * **AI chat events:** O chat de IA no editor do app começa a trabalhar em uma mensagem (**Chat turn started**) ou termina (**Chat turn ended**). 6. (Opcional) Digite uma **Description** para sua equipe saber para que serve o webhook. 7. Clique em **Create webhook**. ![O formulário Create webhook com uma URL de endpoint, 3 eventos selecionados e uma descrição](https://mintcdn.com/base44/Cv0IQGEx6eX2LIU1/images/create-outgoing-webhook.png?fit=max\&auto=format\&n=Cv0IQGEx6eX2LIU1\&q=85\&s=d67e53d0c07a4791f5aab4869bbad414) Criando um webhook *** ## Ativando um webhook Ativar um webhook envia um evento de teste para a sua URL. O webhook fica **Active** quando seu receptor responde e retorna o código do evento de teste. Se a ativação não for concluída, a Base44 informa o motivo. Por exemplo, seu endpoint não respondeu a tempo ou não retornou o código. Corrija o receptor e ative de novo. **Para ativar um webhook:** 1. Clique no nome do seu workspace no canto inferior esquerdo e clique em **Settings**. 2. Clique em **Webhooks** na barra lateral e depois na aba **Outgoing**. 3. Clique no ícone **More actions** ao lado do webhook e selecione **Activate**. ![Um webhook de saída pendente com o menu More actions aberto e Activate destacado](https://mintcdn.com/base44/61xNA58oJUO_TLT3/images/outgoing-webhook-activate-menu.png?fit=max\&auto=format\&n=61xNA58oJUO_TLT3\&q=85\&s=bd0fe1030aa91e8178100c9dc8474dc7) Ativando um webhook pendente *** ## Gerenciando webhooks Pause um webhook enquanto seu receptor está sendo atualizado, altere o que ele recebe ou remova-o. A Base44 coloca como **Auto-paused** um webhook que falha por vários dias seguidos. Quando seu receptor voltar a funcionar, retome o webhook. A Base44 executa o teste de ativação de novo antes de voltar a enviar. **Para gerenciar um webhook:** 1. Clique no nome do seu workspace no canto inferior esquerdo e clique em **Settings**. 2. Clique em **Webhooks** na barra lateral e depois na aba **Outgoing**. 3. Clique no ícone **More actions** ao lado do webhook e selecione uma opção: * **Send test event:** Envia um evento de teste para verificar seu receptor. * **Edit endpoint:** Altera a URL, os eventos ou a descrição. Alterar a URL interrompe as entregas até você ativar a nova URL. * **Pause deliveries** ou **Resume deliveries:** Interrompe ou retoma o envio. Os eventos que acontecem enquanto um webhook está pausado não são enviados depois. * **Delete endpoint:** Interrompe o envio para a URL imediatamente. > [!NOTE] > > As assinaturas dos eventos antigos `builder.turn_started.v1` e `builder.turn_ended.v1` não recebem mais eventos. Selecione **Chat turn started** e **Chat turn ended**. ![O menu More actions aberto em um webhook ativo, com Send test event, Edit endpoint, Pause deliveries e Delete endpoint](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-actions-menu.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=93c4093385d7bf5870fa2618d5ea03fe) Gerenciando um webhook *** ## Gerenciando a chave de assinatura Cada requisição é assinada com a chave do seu workspace. A rotação substitui a chave por uma nova. A Base44 assina com a chave antiga e com a nova durante 24 horas, para que seu receptor continue funcionando enquanto seus desenvolvedores adicionam a nova chave. Quando eles terminarem, clique em **Finish rotation** para parar de usar a chave antiga antes. > [!WARNING] > > **Revoke** faz a Base44 parar de assinar com uma chave imediatamente. Os receptores que só têm essa chave rejeitam todas as entregas até receberem a nova. Para uma troca de rotina, faça a rotação da chave. **Para fazer a rotação da chave de assinatura:** 1. Clique no nome do seu workspace no canto inferior esquerdo e clique em **Settings**. 2. Clique em **Webhooks** na barra lateral e depois na aba **Outgoing**. 3. Clique em **See public keys**. 4. Clique em **Rotate key** e depois em **Rotate key** novamente para confirmar. ![A caixa de diálogo Public signing keys durante uma rotação, com a chave atual, a data de desativação da chave antiga e Finish rotation](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-signing-keys.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=8ede530dbaeb433e3fc2c19c1707030e) As chaves de assinatura durante uma rotação *** ## Perguntas frequentes Clique em uma pergunta abaixo para saber mais sobre webhooks de saída. > **Um webhook pode enviar eventos de apenas um app?** > > Não. Um webhook recebe os eventos que você escolher para todos os apps do seu workspace. Cada evento inclui o app a que se refere. Assim, seu receptor pode ignorar os apps de que não precisa. > **O que acontece se meu servidor estiver fora do ar?** > > A Base44 continua tentando enviar cada evento por cerca de um dia, esperando mais tempo entre cada tentativa. Se o webhook continuar falhando por vários dias, a Base44 o pausa automaticamente. Quando seu servidor voltar a funcionar, retome o webhook pelo menu **More actions**. > **Os webhooks usam créditos?** > > Não. Enviar eventos para seus webhooks não usa nenhum crédito. > **Como meus desenvolvedores criam um receptor?** > > Compartilhe com eles o [guia para desenvolvedores de webhooks de saída](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md). Ele aborda os [tipos de evento](https://docs.base44.com/developers/references/outbound-webhooks/get-started/event-types.md), a [verificação de requisições](https://docs.base44.com/developers/references/outbound-webhooks/get-started/verifying-requests.md) e a [entrega e novas tentativas](https://docs.base44.com/developers/references/outbound-webhooks/get-started/delivery-and-retries.md). > [!NOTE] > > Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.