Uma das boas funcionalidades da SuperSaaS é o sistema de crédito, que permite aos usuários finais comprar crédito uma única vez e depois pagar facilmente pelos compromissos sem precisar passar por todo o processo de pagamento a cada vez. Há vários fatores que podem afetar um saldo de crédito. Compras de crédito e novos compromissos, é claro, mas também reembolsos por compromissos cancelados e ajustes manuais de crédito feitos por um superuser.
Às vezes pode ser útil analisar em detalhe as ações que afetaram o saldo de crédito de um usuário, mas nem sempre é fácil reconstruir o que aconteceu a partir do histórico de compras e do histórico de compromissos. É justamente em situações como essa que combinar serviços como as integrações do Pipedream com a SuperSaaS e o Google Sheets pode ser muito útil para exibir um registro de todos os eventos que afetam o crédito.
Este post é um tutorial passo a passo para configurar o registro de informações de crédito do usuário em uma planilha do Google usando o Pipedream, um poderoso serviço de integração de APIs.
Ao final deste tutorial, sua planilha ficará assim:
Conta do Pipedream e criação da planilha
O Pipedream funciona com workflows, que são fluxos de informação capazes de conectar vários serviços, como SuperSaaS e Google Sheets. Para este caso de uso específico, um único workflow é suficiente.
A primeira coisa que você precisa fazer é criar uma conta na SuperSaaS e no Pipedream.com. Certifique-se de que você esteja autenticado antes de prosseguir.
Após se autenticar, vá para a página Workflows na sua conta do Pipedream e clique no botão New Workflow para criar um novo workflow e depois no botão Add Trigger para adicionar a condição de disparo.
Conectando a SuperSaaS
Em seguida, configure o trigger do workflow que vai ouvir eventos relacionados ao crédito da SuperSaaS.
Na barra de busca, digite SuperSaaS e selecione-o na lista de resultados. Depois, você vai querer o trigger Credit Balance Changes, então clique nele. Agora você tem um workflow com um trigger, mas ainda precisa conectar seu trigger à sua conta SuperSaaS. Clique no botão azul Connect a SuperSaaS account no painel da direita e informe o nome da sua conta e a chave de API.
Siga as instruções na caixa de diálogo para criar a conexão entre suas contas Pipedream e SuperSaaS.
Obtenha sua chave de API da SuperSaaS na parte inferior da sua página de Informações da conta e insira-a no campo api_key e clique no botão Save.
Agora selecione todas as agendas nas quais seus usuários possam gastar seu crédito. Este workflow não acompanhará crédito gasto em outras agendas, então selecione todas elas para ter certeza de que sua planilha não ficará sem dados.
Não se esqueça de clicar no botão Save and continue e gerar um evento de teste de alteração de crédito na SuperSaaS para testar e ativar o trigger.
Após criar um novo cliente com crédito, em alguns segundos você deverá ver:
Clique no botão azul Continue para seguir em frente e adicionar uma ação que acontece quando o trigger dispara.
Adicionando a etapa de registro no Google Sheets
Agora que o trigger está configurado, você pode selecionar o Google Sheets na lista de ações disponíveis. A opção pronta Add Single Row é a recomendada.
Clique no botão azul Connect a Google Sheets account e siga as instruções para conectar sua conta do Pipedream a uma conta do Google Sheets onde você queira armazenar seus registros de crédito do usuário.
Após conectar com sucesso, abra o Google Sheets e crie uma planilha para armazenar seus registros de crédito. Você pode dar o nome que quiser; o nome aparecerá no menu suspenso do Pipedream na próxima etapa.
Selecione a planilha que acabou de criar no menu suspenso e depois o nome da aba da planilha no campo Worksheet ID.
Dependendo de a sua planilha conter ou não uma linha de cabeçalho com os nomes dos campos, escolha TRUE ou FALSE no próximo campo para continuar.
No campo Values, você precisa selecionar, a partir dos dados carregados do evento de teste, cada campo que deseja usar para preencher as novas colunas. Uma configuração recomendada é a seguinte:
Isso lhe dará Created On, Event Type (New User, Credit Change, etc.), User Email e Credit Value de forma organizada.
Clique no botão azul Test e confirme que a linha foi criada na sua planilha. A partir de agora, tudo o que você precisa fazer é clicar no botão Deploy e seu pipeline estará pronto para funcionar!
Teste para ter certeza de que funciona!
Agora que você configurou tudo, certifique-se de criar uma nova conta, fazer compromissos e verificar sua planilha para ver se tudo está funcionando. Após cada ação do usuário, a atualização da planilha deve levar menos de 5 segundos.
Use os filtros normais do Google Sheets para verificar o histórico de saldo de um único usuário nos intervalos de data/hora que você quiser analisar.
Vá além
Se você estiver animado com esse tipo de automação e integração de serviços, talvez queira construir outra coisa que atenda às suas necessidades específicas?
Nesse caso, confira as outras fontes/triggers de eventos da SuperSaaS disponíveis para o Pipedream:
O procedimento de configuração do trigger sempre será muito semelhante ao do Credit balance changes que criamos anteriormente, então esperamos que você tenha vontade de brincar com as outras opções também.
Outras integrações de saída talvez não exijam muito conhecimento técnico, como enviar e-mails para você quando compromissos forem criados ou atualizados, sem custo algum.
Usando os webhooks personalizados da SuperSaaS
Quando você usa os triggers da SuperSaaS para o Pipedream, o que eles estão realmente fazendo nos bastidores é configurar webhooks da SuperSaaS contra os triggers HTTP/Webhook integrados do Pipedream.
Com o recurso premium de webhooks personalizados da SuperSaaS, você também pode fazer isso manualmente e encaminhar qualquer evento possível de webhook da SuperSaaS para seus workflows do Pipedream, até eventos que ainda não integramos ao Pipedream, como os eventos Changed form e Send mail.
Digamos que você queira configurar um workflow que seja acionado toda vez que um de seus usuários atualizar um formulário. Na sua conta do Pipedream, clique novamente em New Workflow e selecione o trigger integrado HTTP / Webhook.
As configurações padrão do endpoint estão boas para os webhooks da SuperSaaS, clique em Save and continue.
Clique em Save and continue e copie o endpoint gerado (por exemplo, https://example.m.pipedream.net) para a página de webhooks personalizados da SuperSaaS. Selecione o trigger que você quer usar (por exemplo, formulário alterado), preencha os parâmetros dele (se houver, neste caso, qual formulário acompanhar) e use o endpoint HTTP do Pipedream como URL de destino.
Todos os outros webhooks existentes na captura de tela foram criados automaticamente e são gerenciados pelo trigger Credit balance changes da SuperSaaS que configuramos no início deste tutorial.
Você também pode criar vários webhooks personalizados para o mesmo URL de destino, se isso fizer sentido para o seu caso de uso específico. Como exemplo, fontes de evento de Credit balance changes exigem pelo menos 3 webhooks: Changed user, Credit purchase e Changed appointment (um para cada agenda monitorada), e todos apontam para o mesmo endpoint do workflow.
Após criar seu webhook personalizado, você pode clicar no link Test webhook e depois no botão Post payload now para enviar um evento de teste para o seu workflow. Você poderá usar esse evento de teste como referência para configurar o restante do seu workflow, além de reproduzi-lo facilmente na interface do Pipedream para testar rapidamente todo o fluxo.
Assim que o payload for enviado, você deverá vê-lo em breve no seu workflow do Pipedream.
Com isso, você já está pronto para adicionar as ações do Pipedream que achar necessárias para serem executadas quando sua conta SuperSaaS emitir eventos Changed form para o formulário que você está acompanhando.
Se você tiver alguma dúvida relacionada à SuperSaaS, nossa equipe de suporte está pronta para ajudar.
Esta é uma versão reescrita de um artigo publicado em 2 de novembro de 2020