Este blog vai mostrar os passos relativamente simples para configurar um webhook que envia notificações da sua conta SuperSaaS para um canal do Slack de sua escolha. Isso é útil se você quiser acompanhar a atividade de reservas na sua agenda no Slack, se quiser ser notificado quando um compromisso estiver prestes a começar, se você ou os membros da sua equipe precisarem preparar uma sala antes do início do compromisso ou se você ou os membros da sua equipe precisarem limpá-la depois. Um webhook da SuperSaaS para o Slack vai poupar você de ter de verificar meticulosamente sua agenda SuperSaaS, mantém seu e-mail livre de notificações e lembretes de compromissos e pode ajudar a comunicar a atividade da sua empresa diretamente no Slack para outros funcionários.
Você começará o processo de configuração adicionando a opção de webhooks de entrada no Slack e depois seguirá para o SuperSaaS para configurar o gatilho do webhook e criar sua mensagem de notificação.
Início da configuração no Slack
- No Slack, adicione o aplicativo “Incoming WebHooks”
- Selecione o canal do Slack ao qual você quer adicionar as notificações do webhook
- Copie a URL fornecida pelo aplicativo Incoming WebHooks e siga para as etapas no SuperSaaS descritas abaixo
Talvez você perceba que o aplicativo “Incoming WebHooks” é um aplicativo legado. Isso significa que ele não é mais atualizado, mas ainda funciona para o propósito deste blog. Se você preferir usar o método mais novo recomendado pelo Slack, ignore as etapas anteriores. Vá ao diretório de aplicativos para criar um novo aplicativo no Slack e depois ative os webhooks de entrada. Consulte a ampla documentação do Slack para um guia detalhado de como fazer isso. Quando você tiver ativado os webhooks de entrada, poderá gerar uma URL. Copie a URL e siga para as etapas no SuperSaaS descritas abaixo.
Continuação da configuração no SuperSaaS
- No SuperSaaS, vá ao painel de administrador, clique em integrations e depois em webhooks (ou simplesmente clique neste link para ir diretamente)
- No cabeçalho “New Webhook”, selecione uma ação para acionar o webhook, adicione sua URL e clique em “create webhook”
- Agora defina o payload como “custom”
- O Slack exige que você adicione o campo “text” ao seu payload, então inclua-o com a mensagem que deseja incorporar à sua notificação do Slack. Se quiser que a mensagem do Slack contenha dados específicos do compromisso ou do usuário, insira as opções de autotexto correspondentes exibidas abaixo da caixa de texto
- Para confirmar que seu webhook está funcionando, talvez você queira testá-lo. Sinta-se à vontade para usar o exemplo abaixo
Seu payload personalizado inserido no SuperSaaS:
{ "text": "$full_name ($email) has created a new appointment for $start" }
A notificação resultante no Slack:
“John Smith (john@johns_email.com) has created a new appointment for 2024-08-30 14:00”
Diferentes tipos de gatilhos
Se você já usou webhooks antes, provavelmente sabe que muitas vezes há diferentes gatilhos que você pode usar para um webhook. Abaixo você encontra três gatilhos que pode querer usar ao conectar sua conta SuperSaaS ao seu workspace do Slack.
1. Novo compromisso
Para receber uma notificação no Slack quando um novo compromisso for criado, você pode usar o gatilho “new appointment”. Isso garantirá que a notificação seja enviada assim que o usuário tiver reservado um compromisso com você.
2. Compromisso alterado
Este gatilho enviará uma notificação do Slack assim que um compromisso for alterado ou excluído.
3. Lembretes e acompanhamentos
Se você preferir receber um lembrete quando um compromisso estiver prestes a começar, escolha o gatilho “reminder”. Em vez de enviar uma notificação do Slack quando um compromisso é criado ou alterado, a notificação será disparada no momento em que você quiser que o lembrete seja enviado. Você pode configurar as definições de lembrete em Configure > Process > “Devemos enviar um lembrete, ou uma mensagem de acompanhamento, sobre uma reserva nova ou alterada?” para definir com quanta antecedência o webhook deve ser disparado.
Nota importante: o webhook de lembrete substitui qualquer lembrete por e-mail ou SMS que você possa ter configurado anteriormente. Isso significa que, se você costumava receber lembretes por e-mail ou SMS diretamente da sua conta SuperSaaS, eles serão substituídos pela notificação de lembrete do Slack. Você pode transformar o acompanhamento em um segundo lembrete adicionando um valor negativo, e assim ele poderá ser usado no lugar.
Opções alternativas: Pipedream/Zapier/n8n
Além de conectar diretamente o SuperSaaS ao Slack, também é possível usar uma ferramenta de integração como Pipedream, n8n, Make ou Zapier para conectar o SuperSaaS ao Slack. Isso exige que você crie uma conta na ferramenta de integração de sua escolha e será necessário um plano pago se você usar mais do que o nível gratuito.
A vantagem de usar um intermediário é que você ganha um nível extra de flexibilidade, pois pode filtrar seus webhooks, por exemplo: “Me avise via WhatsApp se um compromisso for alterado dentro de 1 hora antes do horário de início da reunião, e envie um e-mail caso contrário.”
Se você tiver alguma dúvida sobre o processo de configuração no SuperSaaS, sinta-se à vontade para entrar em contato com nossa equipe de suporte.