Configurar notificações do Slack para comentários de revisão

Se quiser, receba notificações em um canal do Slack a cada novo comentário em um link de revisão do Commentful compartilhado com um cliente.

Gerar um webhook no Slack ​

1. Crie um app do Slack (se ainda não tiver um) ​

Crie seu app do Slack

Escolha um nome, selecione o workspace ao qual o app será associado (lembrando que você provavelmente vai publicar muitas mensagens de teste, então pode ser bom criar um canal só para testes) e clique em Create App. Se você já criou um app, pode usar esse.

2. Ative os Incoming Webhooks no seu app do Slack ​

Depois de criar o app do Slack, você será redirecionado para a página de configurações do novo app (se estiver usando um app existente, basta abrir as configurações dele pelo painel de gerenciamento de apps).

Nessa página, selecione o recurso Incoming Webhooks e clique na chave Activate Incoming Webhooks para ativá-lo.

3. Crie um Incoming Webhook no seu workspace do Slack ​

Com os Incoming Webhooks ativados, a página de configurações deve ser atualizada e mostrar algumas opções extras. Uma delas é um botão muito útil chamado Add New Webhook to Workspace: clique nele.

Esse botão inicia uma versão simplificada do fluxo de instalação de apps do Slack, totalmente independente, para que você não precise escrever nenhum código para gerar uma URL de Incoming Webhook. Você verá uma tela parecida com esta:

Tela de permissões com o seletor de canal dos incoming webhooks

Escolha um canal em que o app vai publicar e clique no botão Authorize. Se precisar adicionar o Incoming Webhook a um canal privado, você precisa primeiro estar nesse canal.

Você voltará para as configurações do app e verá uma nova entrada na seção Webhook URLs for Your Workspace, com uma URL de webhook parecida com esta:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Essa URL é o seu novo Incoming Webhook, específico para um único usuário e um único canal.

Adicionar a URL do webhook do Slack pelo plugin Commentful ​

Para configurar as notificações do Commentful no Slack, crie uma URL de webhook do Slack seguindo os passos acima. Depois, no plugin Commentful para Figma, abra o botão de ícone Settings (no canto superior direito da janela do plugin), clique em Enable webhook notifications for review links, confira se Slack está selecionado no menu suspenso Webhook Platform, copie e cole a URL do webhook do Slack (por exemplo, https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX) e clique em Save Webhook URL.

Para conferir se a integração com o Slack está funcionando, clique no botão Send Test Message, que envia uma notificação de teste do Commentful para o seu canal do Slack.

Adicionar a URL do webhook do Slack pelo app web do Commentful ​

Para configurar as notificações do Commentful no Slack, crie uma URL de webhook do Slack seguindo os passos acima. Depois, no app web do Commentful (ao abrir qualquer link de revisão compartilhado no navegador), pressione as teclas CTRL + K no teclado e copie e cole a URL do webhook do Slack (por exemplo, https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX).

Para conferir se a integração com o Slack está funcionando, clique no botão Send Test Message to Slack, que envia uma notificação de teste do Commentful para o seu canal do Slack.

As notificações por webhook do Slack são enviadas ao canal do Slack escolhido como alertas do canal. Se você incluir um texto como @name nos comentários do Commentful, o Slack pode mostrar esse texto no corpo da mensagem, mas o Commentful não associa automaticamente os revisores do Commentful aos usuários do Slack para garantir menções nativas no Slack.