> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar a integração com o Slack

> Saiba como conectar o Slack às suas landing pages no LanderLab e enviar notificações instantâneas de leads para um canal do Slack em tempo real usando um incoming webhook.

<iframe src="https://www.youtube.com/embed/JHm5Kde3POg" title="Player de vídeo do YouTube" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

Conecte o Slack às suas landing pages no LanderLab para receber uma mensagem instantânea no canal do Slack da sua equipe sempre que chegar um novo lead. A sua equipe vê cada lead no momento em que ele é enviado, sem sair do Slack nem abrir o painel.

## O que é a integração com o Slack?

A integração com o Slack usa um **incoming webhook** do Slack para publicar uma mensagem no canal que você escolher sempre que um lead é coletado na sua landing page. Você cria o webhook uma única vez no Slack, copia a URL dele e cola no LanderLab.

Ela é ideal para alertas em tempo real: notifique a sua equipe de vendas em um canal compartilhado ou envie leads para um canal privado que só a sua equipe pode ver.

## Antes de começar

Você só precisa de uma coisa para conectar o Slack: uma **URL de incoming webhook**. Você a cria pelo site para desenvolvedores do Slack, criando um pequeno app do Slack. Os passos abaixo mostram como fazer isso.

## Passo 1: Criar um app do Slack

<Steps>
  <Step title="Abra a página de apps do Slack">
    Acesse [https://api.slack.com/apps](https://api.slack.com/apps) e faça login na sua conta do Slack. Clique em **Create an App**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/image-28.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=ab0a885d045f9e0c6c5d5f92c45d5c73" alt="A página de apps do Slack em api.slack.com, com o botão Create an App" width="1568" height="782" data-path="images/image-28.png" />
    </Frame>
  </Step>

  <Step title="Escolha From scratch">
    Na janela pop-up, selecione **From scratch**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/image-29.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=9a167b7075c0ca90fcb37a4b21a501fb" alt="A janela de criação de app do Slack, com a opção From scratch selecionada" width="706" height="487" data-path="images/image-29.png" />
    </Frame>
  </Step>

  <Step title="Dê um nome ao app e escolha um espaço de trabalho">
    Informe um **App Name** (por exemplo, `LanderLab`) e selecione o **workspace** (espaço de trabalho) em que você quer que as notificações de leads apareçam. Clique em **Create App**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/image-30.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=25d7bc97ded14070aff3a7e61647efa2" alt="A tela de nomeação do app no Slack, com o campo App Name e o seletor de espaço de trabalho" width="564" height="607" data-path="images/image-30.png" />
    </Frame>
  </Step>
</Steps>

## Passo 2: Ativar os Incoming Webhooks e obter a sua URL

<Steps>
  <Step title="Abra Incoming Webhooks">
    Na barra lateral das configurações do app, em **Features**, clique em **Incoming Webhooks**. Mude a chave **Activate Incoming Webhooks** para **On**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/MaOcKn9x-e0o8fS_/images/turnonwebhooks.png?fit=max&auto=format&n=MaOcKn9x-e0o8fS_&q=85&s=fa914e7d332518b63900e3888ce35686" alt="A página Incoming Webhooks nas configurações do app do Slack, com a chave de ativação ligada" width="1568" height="783" data-path="images/turnonwebhooks.png" />
    </Frame>
  </Step>

  <Step title="Adicione um novo webhook">
    Role até o final da página e clique em **Add New Webhook to Workspace**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/h9RQlkuYw4-wACaD/images/addwebhook.png?fit=max&auto=format&n=h9RQlkuYw4-wACaD&q=85&s=ffffaad6ebfa7da30ec82625cfc1c7ca" alt="O botão Add New Webhook to Workspace no final da página Incoming Webhooks do Slack" width="1565" height="784" data-path="images/addwebhook.png" />
    </Frame>
  </Step>

  <Step title="Escolha um canal e permita o acesso">
    Selecione o **canal** em que você quer que os leads sejam publicados e clique em **Allow**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/h9RQlkuYw4-wACaD/images/allow.png?fit=max&auto=format&n=h9RQlkuYw4-wACaD&q=85&s=5cf756b906f5e3ebc7d93ce5eca179b6" alt="A tela de permissão do Slack, com um canal selecionado e o botão Allow" width="1568" height="782" data-path="images/allow.png" />
    </Frame>
  </Step>

  <Step title="Copie a URL do seu webhook">
    De volta à página Incoming Webhooks, o seu novo webhook aparece na lista. Clique em **Copy** para copiar a URL. Ela é parecida com esta:

    ```text theme={null}
    https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX
    ```

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/copywebhook.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=42d29f80b26c43be64215367957b4cbd" alt="A lista de incoming webhooks do Slack, com o botão Copy ao lado da URL do webhook" width="1685" height="782" data-path="images/copywebhook.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Trate a URL do seu webhook como uma senha. Qualquer pessoa que a tenha pode publicar mensagens no seu canal do Slack. Nunca a compartilhe publicamente.
</Warning>

## Passo 3: Conectar o Slack no LanderLab

Com a URL do webhook copiada, você pode conectar a integração.

<Steps>
  <Step title="Abra sua landing page">
    Acesse **Landing Pages** e clique no **nome da landing page** para a qual você quer receber notificações de leads.
  </Step>

  <Step title="Abra a aba de integrações">
    Clique em **Add Integration** para abrir o painel de integrações; depois, pesquise **Slack** e selecione-o.
  </Step>

  <Step title="Informe um nome e cole a URL do seu webhook">
    Dê à integração um **Name** (nome) para identificá-la e cole a **Webhook URL** que você copiou do Slack. Clique em **Continue**.
  </Step>

  <Step title="Escolha o formato da mensagem">
    Escolha como cada notificação será escrita. **List** formata automaticamente todos os campos do lead e só pede um texto de introdução, enquanto **Custom** permite que você escreva o seu próprio modelo de mensagem. Clique em **Continue**.
  </Step>

  <Step title="Revise e conecte">
    Confira o canal de destino, o formato da mensagem e o texto de introdução. Todos os campos do lead são incluídos automaticamente. Se estiver tudo certo, clique em **Connect Slack**.
  </Step>
</Steps>

<Note>
  Se a sua landing page tiver várias variantes de teste A/B, você precisará escolher a quais variantes esta integração se aplica antes que ela seja adicionada.
</Note>

## Testar a integração

Envie um lead de teste pelo formulário ou quiz da sua landing page e confira o seu canal do Slack. O app deve publicar uma mensagem com os detalhes do lead em poucos segundos.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Nenhuma mensagem está chegando ao Slack">
    Confirme se a URL do webhook foi colada corretamente, sem espaços extras. Verifique também se Incoming Webhooks continua **On** nas configurações do seu app do Slack.
  </Accordion>

  <Accordion title="As mensagens são publicadas no canal errado">
    Cada URL de webhook está vinculada ao canal que você escolheu ao criá-la. Para publicar em outro canal, crie um novo webhook no Slack (Passo 2), copie essa URL e atualize a integração no LanderLab.
  </Accordion>

  <Accordion title="A URL do webhook parou de funcionar">
    Se o app foi reinstalado ou os tokens dele foram revogados, a URL antiga do webhook deixa de ser válida. Gere um novo webhook no Slack e cole a nova URL no LanderLab.
  </Accordion>
</AccordionGroup>
