Olá a todos!
Bem-vindos a este tutorial sobre como configurar um fluxo de automação com Integromat, que permitirá que você receba automaticamente uma notificação por e-mail sempre que um novo usuário se cadastrar na sua comunidade Discourse.
Para conectar o Discourse ao Integromat, você precisa ter uma conta no Integromat. Se ainda não tiver uma, pode se cadastrar aqui.
Este método utiliza o recurso de webhooks oferecido pelo Discourse, portanto, você precisará ter acesso de administrador à sua comunidade Discourse antes de começar.
Depois de ter acesso de administrador, a primeira coisa a fazer é criar uma nova solicitação de webhook. Para isso, clique no ícone do seu perfil no canto superior direito e, na aba de perfil, selecione a opção Resumo.
Isso levará você à página do seu perfil. Clique no botão Admin para navegar até a página de administração.
Clique na opção API.
Selecione a aba Webhooks e clique no botão Novo Webhook para gerar uma nova solicitação de webhook.
A página de configuração deve aparecer assim.
Para preencher este formulário, você precisará gerar um novo webhook no Integromat, que será usado para receber os dados enviados pelo Discourse sempre que um novo usuário se cadastrar na sua comunidade.
Para isso, faça login na sua conta do Integromat e crie um novo cenário.
Primeiro, você precisará configurar um módulo de gatilho, ou seja, o módulo que fará com que seu cenário seja executado. Neste caso, será um módulo de webhook, então você pode clicar no ícone de interrogação e pesquisar pelo aplicativo Webhooks.
Clique no aplicativo Webhooks e selecione o módulo Webhook Personalizado.
Em seguida, crie um novo webhook para que seu cenário possa receber os dados enviados pelo Discourse. Para isso, clique no aplicativo Webhooks para abrir sua janela de configuração e clique no botão Adicionar para configurar um novo webhook.
Dê um nome ao seu webhook. Pode ser qualquer coisa que você goste, por exemplo, Discourse Webhook.
O próximo passo será clicar na opção Mostrar configurações avançadas e selecionar a opção Obter cabeçalhos da solicitação. Após fazer isso, clique em Salvar para gerar seu novo webhook.
Seu webhook agora deve estar visível. É a URL destacada em azul. Clique no botão Copiar endereço para a área de transferência para copiar seu webhook e navegue até a página de configuração de webhook do Discourse.
Cole a URL do seu webhook do Integromat no campo URL do Payload.
Em seguida, selecione a opção Evento de Usuário na lista e certifique-se de que tudo o mais esteja desmarcado. Isso garantirá que este webhook receba apenas dados baseados em eventos específicos de usuários.
Finalmente, selecione as caixas de seleção Verificar certificado TLS da URL do payload e Ativo no final da página e clique no botão Criar para estabelecer esta conexão entre sua comunidade Discourse e seu webhook do Integromat.
A nova conexão agora deve estar visível na página Webhooks da sua conta Discourse.
O próximo passo será garantir que a conexão entre a comunidade Discourse e seu webhook do Integromat tenha sido estabelecida. Para isso, clique em Inativo.
Você verá um pequeno menu parecido com este. Basta clicar em Ping e navegar até seu cenário no Integromat para verificar se seu webhook detectou com sucesso este evento.
Se tiver funcionado, você verá uma mensagem dizendo Determinado com sucesso.
O próximo passo é verificar se o webhook pode realmente receber dados da sua comunidade Discourse. Para isso, você precisa executar o cenário uma vez clicando no botão Executar uma vez.
Assim que o módulo do webhook começar a girar, navegue até sua comunidade Discourse, faça logout e crie uma nova conta de usuário na sua comunidade. Assim que o novo usuário for criado com sucesso, o webhook receberá alguns dados, que aparecerão assim.
Isso ajudará você a garantir que o webhook possa detectar eventos reais (não apenas pings) e também permitirá mapear os elementos de dados recebidos para o aplicativo de e-mail mais tarde neste tutorial. Se seu webhook do Integromat tiver detectado o evento com sucesso, o cenário terá sido executado com sucesso e deverá aparecer assim.
Agora que você sabe que o módulo do webhook funciona como esperado e seu cenário do Integromat é acionado sempre que um novo usuário é criado, é hora de expandir o cenário e configurá-lo para que ele envie automaticamente um e-mail com todas as informações do usuário.
A primeira etapa será anexar um módulo Iterador ao módulo de gatilho do webhook. Você pode encontrá-lo no menu Ferramentas do construtor de cenários. Explicaremos o uso deste módulo mais tarde.
Clique no módulo Iterador para abrir sua janela de configuração.
Ao clicar no campo Array, um menu se abrirá no lado esquerdo com alguns elementos de dados recuperados do módulo de webhooks. Basta arrastar e soltar o elemento de dados chamado Headers para o campo Array do módulo Iterador. Este será um array com muitos valores.
O próximo passo será anexar o aplicativo de E-mail após o aplicativo Iterador. Clique no ícone de mais e pesquise pelo aplicativo E-mail. Ao encontrá-lo, clique nele para selecionar o módulo que deseja usar.
Selecione o módulo Enviar um E-mail na lista para enviar um e-mail para você mesmo sempre que um novo usuário for criado na sua comunidade Discourse.
Antes de configurar o módulo de E-mail, você precisa configurar um filtro entre os aplicativos Iterador e E-mail, que garantirá que você receba e-mails apenas para os usuários que se cadastram na sua comunidade. Isso é necessário porque, por padrão, o Discourse aciona solicitações de webhook para todos os tipos de atividades de usuários.
Na janela de configuração do filtro, você precisará inserir primeiro um rótulo. Pode ser qualquer coisa que você goste, por exemplo, Novo Usuário.
Em seguida, você precisará criar uma condição que acionará este filtro. No primeiro campo da condição, basta mapear o elemento de dados Valor do módulo Iterador. Para o operador lógico, selecione Igual a. Finalmente, no campo inferior, insira o valor user_created.
A forma como esta condição funciona é a seguinte:
Os dados do webhook que o Integromat recebe do Discourse sempre que um usuário realiza uma ação contêm um array de Headers (um array é uma coleção de valores). A função do iterador é recuperar cada um desses valores individualmente para que possam ser processados e aplicados ao filtro. Em algum lugar deste array de valores, há um valor que especifica o tipo de evento que o usuário realizou. Como o evento que nos interessa é chamado user_created (porque isso indica que a ação realizada pelo usuário foi criar uma nova conta), precisamos configurar um filtro para garantir que os valores de cabeçalho dos dados do webhook realmente contenham este valor. Se contiverem, prosseguimos com a execução dos módulos subsequentes do cenário. Se não contiverem, a execução do cenário termina rapidamente e nenhum e-mail é enviado.
Depois de configurar seu filtro, você pode clicar no módulo de E-mail para abrir sua janela de configuração.
A primeira coisa a fazer é conectar a conta de e-mail que você deseja usar para enviar e-mails. Se estiver conectando seu Gmail, certifique-se de seguir este guia, que explica o processo passo a passo.
Depois que seu e-mail estiver conectado, você pode prosseguir configurando as outras opções do módulo de e-mail.
Para o campo Para, você pode clicar em Adicionar destinatário e inserir o e-mail no qual deseja receber essas atualizações.
Para Assunto, você pode inserir qualquer coisa que desejar, e para Tipo de Conteúdo, você pode selecionar a opção Texto simples para construir a mensagem que deseja enviar sempre que este módulo for executado.
O campo Conteúdo é onde você pode construir a mensagem do e-mail. Aqui, você pode escrever algum texto estático (ou seja, texto que permanece sempre o mesmo em cada execução), mas também pode mapear elementos de dados dinâmicos do módulo de webhook. O webhook contém muitos dados sobre o usuário que você pode usar, incluindo seu nome de usuário, nome, e-mail, etc.
E pronto! Você conseguiu criar com sucesso um cenário no Integromat que notifica você sempre que um novo usuário se junta à sua comunidade Discourse.
Esperamos que este tutorial tenha sido útil! Se você tiver alguma dúvida ou recomendação sobre o que gostaria de ver a seguir, não hesite em nos informar nos comentários, enviar um ticket para a equipe de suporte do Integromat ou conferir a Comunidade do Facebook do Integromat com 10 mil membros.
Feliz automação!
LINKS
Como Conectar o Discourse a Centenas de Aplicativos Usando o Integromat