# Como realizar a integração via Webhook com o GS Engage?

> Receba notificações em tempo real dos eventos do GS Engage via Webhook: aprenda a criar, editar, pausar, reativar, regerar a chave secreta e excluir webhooks.

- URL canônica: https://docs.growthstation.app/docs/integracoes/webhook
- Idioma: pt-BR
- Última atualização: 2026-08-17T12:49:19.121Z
- Produto: GS Engage
- Mantido por: Produto GS Engage



































































<PageHero emoji="🔗" title="Integração via Webhook com o GS Engage" description="Notificações em tempo real dos eventos de prospecção enviadas automaticamente para a URL do seu sistema." gradient="brand" />

A integração via Webhook no GS Engage é uma funcionalidade essencial para automatizar e otimizar fluxos de trabalho, permitindo que diferentes sistemas se comuniquem de forma eficiente. Webhooks são uma maneira de receber notificações em tempo real sobre eventos ocorridos em um sistema, sem a necessidade de consultas constantes. Isso é particularmente útil em ambientes de vendas e marketing, onde a agilidade na troca de informações pode fazer uma grande diferença.

🔌 O que é um Webhook? [#-o-que-é-um-webhook]

Um Webhook é um método de comunicação entre sistemas que permite que um aplicativo envie dados automaticamente para outro aplicativo quando um evento específico ocorre. Ao contrário das APIs tradicionais, que exigem que um sistema solicite informações, os webhooks enviam informações assim que um evento é acionado.

🔄 Como funcionam os Webhooks? [#-como-funcionam-os-webhooks]

<Steps>
  <Step num={1} title="Configuração">
    Primeiramente, você deve configurar o sistema para enviar dados para uma URL específica sempre que um evento ocorrer.
  </Step>

  <Step num={2} title="Evento">
    Quando o evento ocorre (por exemplo, um lead é dado como agendado), o sistema dispara o webhook.
  </Step>

  <Step num={3} title="Envio de Dados">
    O sistema envia os dados do evento para a URL configurada. As informações enviadas geralmente é um objeto JSON que contem detalhes sobre o evento.
  </Step>

  <Step num={4} title="Processamento">
    A aplicação receptora processa os dados e realiza as ações configuradas (como atualizar uma base de dados ou enviar uma notificação).
  </Step>
</Steps>

🔔 Quais são os eventos disponíveis? [#-quais-são-os-eventos-disponíveis]

Os eventos disponíveis para integração via Webhook no GS Engage são:

| Evento               | Quando é disparado                                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **prospection.won**  | Envia informações quando um lead é considerado uma conversão bem-sucedida, ou seja, quando um lead recebe o status de **Agendado** no GS Engage. |
| **prospection.lost** | Envia informações quando um lead for marcado como **Perdido** no GS Engage.                                                                      |

⚙️ Como configurar Webhooks no GS Engage? [#️-como-configurar-webhooks-no-gs-engage]

Para configurar a integração via Webhook no GS Engage, siga os seguintes passos:

<Steps>
  <Step num={1} title="Acesse Ajustes e Permissões">
    Acesse a página de Ajustes e Permissões, através da navbar clique no atalho <TextHighlight>Ajustes e Permissões</TextHighlight>.

        <img alt="Atalho Ajustes e Permissões na navbar do GS Engage" src={__img0} placeholder="blur" />
  </Step>

  <Step num={2} title="Selecione Configurações de Webhook">
    Selecione a seção de <TextHighlight>Configurações de Webhook</TextHighlight>.

        <img alt="Seção Configurações de Webhook nos ajustes" src={__img1} placeholder="blur" />
  </Step>

  <Step num={3} title="Clique em +Novo Webhook">
    Clique no botão <TextHighlight>+Novo Webhook</TextHighlight> para configurar o Webhook.

        <img alt="Botão +Novo Webhook na tela de configurações" src={__img2} placeholder="blur" />
  </Step>

  <Step num={4} title="Preencha as informações">
    No modal de criação de Webhook, preencha as informações de "Nome do Webhook" e "URL".

        <img alt="Modal de criação de Webhook com os campos Nome e URL" src={__img3} placeholder="blur" />

    <Callout type="info" title="Documentação técnica">
      Para saber mais sobre eventos e contratos de payload, acesse a [Referência da API do GS Engage](/docs/api/referencia).
    </Callout>
  </Step>

  <Step num={5} title="Selecione o evento">
    No modal de criação de Webhook, selecione o evento que acionará o envio de informações par a URL informada.

        <img alt="Seleção do evento que aciona o Webhook no modal de criação" src={__img4} placeholder="blur" />
  </Step>

  <Step num={6} title="Clique em Criar">
    Clique em <TextHighlight>Criar</TextHighlight> para finalizar a criação do Webhook.
  </Step>

  <Step num={7} title="Copie a chave secreta">
    Após criar o Webhook será geraada a chave secreta vinculada ao Webhook criado, clique em <TextHighlight>Copiar</TextHighlight> para guardar a chave e, em seguida, clique em <TextHighlight>Fechar</TextHighlight>.

        <img alt="Chave secreta gerada com o botão Copiar após criar o Webhook" src={__img5} placeholder="blur" />
  </Step>
</Steps>

<Callout type="warning" title="Guarde a chave secreta">
  A chave secreta é exibida apenas no momento da criação. Copie e guarde em local seguro antes de fechar o modal.
</Callout>

🔎 Como acessar os Webhooks criados? [#-como-acessar-os-webhooks-criados]

Para acessar os Webhook criados no GS Engage, siga os seguintes passos:

<Steps>
  <Step num={1} title="Acesse Ajustes e Permissões">
    Acesse a página de Ajustes e Permissões, através da navbar clique no atalho <TextHighlight>Ajustes e Permissões</TextHighlight>.

        <img alt="Atalho Ajustes e Permissões na navbar do GS Engage" src={__img6} placeholder="blur" />
  </Step>

  <Step num={2} title="Selecione Configurações de Webhook">
    Selecione a seção de <TextHighlight>Configurações de Webhook</TextHighlight>.

        <img alt="Seção Configurações de Webhook nos ajustes" src={__img7} placeholder="blur" />
  </Step>

  <Step num={3} title="Visualize os Webhooks">
    Nesta seção é possível visualizar os Webhooks criados, juntamente aos eventos associados a cada Webhook.

        <img alt="Lista de Webhooks criados com os eventos associados" src={__img8} placeholder="blur" />
  </Step>
</Steps>

📝 Como editar um Webhook criado? [#-como-editar-um-webhook-criado]

Para editar as informações do Webhook criado, siga os seguintes passos:

<Steps>
  <Step num={1} title="Acesse Ajustes e Permissões">
    Acesse a página de Ajustes e Permissões, através da navbar clique no atalho <TextHighlight>Ajustes e Permissões</TextHighlight>.

        <img alt="Atalho Ajustes e Permissões na navbar do GS Engage" src={__img9} placeholder="blur" />
  </Step>

  <Step num={2} title="Selecione Configurações de Webhook">
    Selecione a seção de <TextHighlight>Configurações de Webhook</TextHighlight>.

        <img alt="Seção Configurações de Webhook nos ajustes" src={__img10} placeholder="blur" />
  </Step>

  <Step num={3} title="Localize o webhook">
    Localize o Webhook que deseja editar as informações.

        <img alt="Lista de Webhooks criados para localizar o webhook a editar" src={__img11} placeholder="blur" />
  </Step>

  <Step num={4} title="Clique em Editar">
    Clique no menu de ações, localizado a direita do nome do Webhook criado, e selecione a opção <TextHighlight>Editar</TextHighlight>.

        <img alt="Menu de ações do Webhook com a opção Editar" src={__img12} placeholder="blur" />
  </Step>

  <Step num={5} title="Clique em Salvar">
    No modal exibido altere as informações que deseja e, em seguida, clique em <TextHighlight>Salvar</TextHighlight> para que as edições realizadas sejam guardadas.

        <img alt="Modal de edição do Webhook com o botão Salvar" src={__img13} placeholder="blur" />
  </Step>
</Steps>

⏸️ Como pausar o envio de informações para um Webhook? [#️-como-pausar-o-envio-de-informações-para-um-webhook]

Para pausar o envio de informações para um Webhook criado, siga os seguintes passos:

<Steps>
  <Step num={1} title="Acesse Ajustes e Permissões">
    Acesse a página de Ajustes e Permissões, através da navbar clique no atalho <TextHighlight>Ajustes e Permissões</TextHighlight>.

        <img alt="Atalho Ajustes e Permissões na navbar do GS Engage" src={__img14} placeholder="blur" />
  </Step>

  <Step num={2} title="Selecione Configurações de Webhook">
    Selecione a seção de <TextHighlight>Configurações de Webhook</TextHighlight>.

        <img alt="Seção Configurações de Webhook nos ajustes" src={__img15} placeholder="blur" />
  </Step>

  <Step num={3} title="Localize o webhook">
    Localize o Webhook que pausar o envio de informações.

        <img alt="Lista de Webhooks criados para localizar o webhook a pausar" src={__img16} placeholder="blur" />
  </Step>

  <Step num={4} title="Clique em Pausar">
    Clique no menu de ações, localizado a direita do nome do Webhook criado, e selecione a opção <TextHighlight>Pausar</TextHighlight>.

        <img alt="Menu de ações do Webhook com a opção Pausar" src={__img17} placeholder="blur" />

    <Callout type="warning" title="Status Pausado">
      Após pausar o envio de informações para o Webhook, ele receberá o status de Pausado para sinalizar que os dados associados aos eventos não estão sendo enviados para a URL configurada.
    </Callout>
  </Step>
</Steps>

▶️ Como reativar o envio de informações para um Webhook pausado? [#️-como-reativar-o-envio-de-informações-para-um-webhook-pausado]

Para reativar o envio de informações para um Webhook pausado, siga os seguintes passos:

<Steps>
  <Step num={1} title="Acesse Ajustes e Permissões">
    Acesse a página de Ajustes e Permissões, através da navbar clique no atalho <TextHighlight>Ajustes e Permissões</TextHighlight>.

        <img alt="Atalho Ajustes e Permissões na navbar do GS Engage" src={__img18} placeholder="blur" />
  </Step>

  <Step num={2} title="Selecione Configurações de Webhook">
    Selecione a seção de <TextHighlight>Configurações de Webhook</TextHighlight>.

        <img alt="Seção Configurações de Webhook nos ajustes" src={__img19} placeholder="blur" />
  </Step>

  <Step num={3} title="Localize o webhook">
    Localize o Webhook que deseja reativar.

        <img alt="Lista de Webhooks criados para localizar o webhook a reativar" src={__img20} placeholder="blur" />
  </Step>

  <Step num={4} title="Clique em Ativar">
    Clique no menu de ações, localizado a direita do nome do Webhook criado, e selecione a opção <TextHighlight>Ativar</TextHighlight>.

        <img alt="Menu de ações do Webhook com a opção Ativar" src={__img21} placeholder="blur" />

    <Callout type="info" title="Status Ativo">
      Após reativar o envio de informações, o Webhook receberá o status de Ativo sinalizando que as informações associadas aos eventos estão sendo enviadas para a URL configurada.
    </Callout>
  </Step>
</Steps>

🔑 Como regerar a chave secreta do Webhook? [#-como-regerar-a-chave-secreta-do-webhook]

Para regerar a chave secreta associada a um Webhook criado, siga os seguintes passos:

<Steps>
  <Step num={1} title="Acesse Ajustes e Permissões">
    Acesse a página de Ajustes e Permissões, através da navbar clique no atalho <TextHighlight>Ajustes e Permissões</TextHighlight>.

        <img alt="Atalho Ajustes e Permissões na navbar do GS Engage" src={__img22} placeholder="blur" />
  </Step>

  <Step num={2} title="Selecione Configurações de Webhook">
    Selecione a seção de <TextHighlight>Configurações de Webhook</TextHighlight>.

        <img alt="Seção Configurações de Webhook nos ajustes" src={__img23} placeholder="blur" />
  </Step>

  <Step num={3} title="Localize o webhook">
    Localize o Webhook que deseja regerar a chave secreta.

        <img alt="Lista de Webhooks criados para localizar o webhook" src={__img24} placeholder="blur" />
  </Step>

  <Step num={4} title="Clique em Editar">
    Clique no menu de ações, localizado a direita do nome do Webhook criado, e selecione a opção <TextHighlight>Editar</TextHighlight>.

        <img alt="Menu de ações do Webhook com a opção Editar para regerar a chave" src={__img25} placeholder="blur" />
  </Step>

  <Step num={5} title="Copie a chave secreta">
    Copie e Salve a nova chave secreta gerada e, em seguida, clique em <TextHighlight>Fechar</TextHighlight>.

        <img alt="Nova chave secreta gerada com o botão para copiar" src={__img26} placeholder="blur" />
  </Step>
</Steps>

⛔ Como excluir um Webhook criado no GS Engage? [#-como-excluir-um-webhook-criado-no-gs-engage]

Para excluir um Webhook criado, siga os seguintes passos:

<Steps>
  <Step num={1} title="Acesse Ajustes e Permissões">
    Acesse a página de Ajustes e Permissões, através da navbar clique no atalho <TextHighlight>Ajustes e Permissões</TextHighlight>.

        <img alt="Atalho Ajustes e Permissões na navbar do GS Engage" src={__img27} placeholder="blur" />
  </Step>

  <Step num={2} title="Selecione Configurações de Webhook">
    Selecione a seção de <TextHighlight>Configurações de Webhook</TextHighlight>.

        <img alt="Seção Configurações de Webhook nos ajustes" src={__img28} placeholder="blur" />
  </Step>

  <Step num={3} title="Localize o webhook">
    Localize o Webhook que deseja excluir.

        <img alt="Lista de Webhooks criados para localizar o webhook a excluir" src={__img29} placeholder="blur" />
  </Step>

  <Step num={4} title="Clique em Excluir">
    Clique no menu de ações, localizado a direita do nome do Webhook criado, e selecione a opção <TextHighlight>Excluir</TextHighlight>.

        <img alt="Menu de ações do Webhook com a opção Excluir" src={__img30} placeholder="blur" />
  </Step>

  <Step num={5} title="Confirme a exclusão">
    Confirme a exclusão do Webhook clicando em <TextHighlight>Excluir Webhook</TextHighlight>.

        <img alt="Diálogo de confirmação com o botão Excluir Webhook" src={__img31} placeholder="blur" />
  </Step>
</Steps>

💡 Casos de uso comuns [#-casos-de-uso-comuns]

<CardGrid cols={2}>
  <CardLink icon="👥" title="Integração com CRM">
    Ao integrar o GS Engage com um CRM via webhook, você pode automaticamente criar ou atualizar registros de leads no CRM sempre que um lead no GS Engage atingir um determinado estágio.
  </CardLink>

  <CardLink icon="🔔" title="Notificações em Tempo Real">
    Configure webhooks para enviar notificações a um sistema de mensagens ou e-mail sempre que um lead é atualizado, garantindo que sua equipe de vendas esteja sempre informada sobre mudanças importantes.
  </CardLink>
</CardGrid>

<Callout type="info" title="Gerenciar webhooks via API">
  Através da API do GS Engage é possível listar, criar e excluir webhooks. Consulte os endpoints na [Referência da API do GS Engage](/docs/api/referencia).
</Callout>

Ainda tem dúvida? [Abra uma solicitação](/docs/configuracoes/tickets-de-suporte) para o nosso time.

<RelatedArticles>
  <RelatedArticle href="/docs/integracoes/api" title="Integração via API" description="Conecte o GS Engage a CRMs e ferramentas de marketing via API para automatizar cadências, leads e prospecções." />

  <RelatedArticle href="/docs/integracoes/zapier" title="Integração via Zapier" description="Automatize fluxos entre o GS Engage e diversos aplicativos usando o app Growth Station no Zapier." />

  <RelatedArticle href="/docs/integracoes/pipedrive" title="Integração com o Pipedrive" description="Envie leads trabalhados no GS Engage para o CRM Pipedrive de forma manual ou automática." />
</RelatedArticles>