Lembretes de agendamentos com C# e ASP.NET MVC
Ahoy! Agora recomendamos que você crie seus lembretes de agendamento por SMS com a funcionalidade de programação de mensagens integrada da Twilio. Acesse a documentação de recursos de mensagens para saber mais sobre como programar mensagens SMS!
Pronto para implementar lembretes de agendamentos em seu aplicativo? Veja como funciona:
- Um administrador cria um agendamento para uma data e hora futuras e armazena o número de telefone de um cliente no banco de dados para esse agendamento
- Um processo em segundo plano verifica o banco de dados em um intervalo regular, procurando agendamentos que exijam o envio de um lembrete
- Em um horário configurado antes do agendamento, um lembrete de SMS é enviado ao cliente para lembrá‐lo do agendamento
Confira como a Yelp usa o SMS para confirmar reservas de restaurantes para clientes.
Blocos de construção
Aqui estão as tecnologias que usaremos para fazer isso:
- ASP.NET MVC para criar um aplicativo da web orientado por banco de dados
- O recurso de mensagens da API REST da Twilio para enviar mensagens de texto
- Hangfire para nos ajudar a programar e executar tarefas em segundo plano de forma recorrente
Neste tutorial, vamos destacar os principais trechos de código que fazem este aplicativo funcionar. Confira o README do projeto no GitHub para ver como executar o código por conta própria.
Como ler este tutorial
Para implementar lembretes de agendamentos, trabalharemos em uma série de histórias de usuários que descrevem como implementar totalmente lembretes de agendamentos em um aplicativo da web. Veremos o código necessário para satisfazer cada história e exploraremos o que precisávamos adicionar em cada etapa.
Tudo isso pode ser feito com a ajuda da Twilio em menos de meia hora.
Criar um agendamento
Como usuário, quero criar um agendamento com um nome, números de telefone de convidado e um horário no futuro.
Para criar um aplicativo de lembrete de agendamento automatizado, provavelmente devemos começar com um agendamento. Esta história requer que criemos um pouco de IU e um objeto de modelo para criar e salvar um novo Appointment em nosso sistema. Em um nível alto, vamos adicionar o que precisamos:
- Um formulário para inserir detalhes sobre o agendamento
- Uma rota e uma função de controlador no servidor para processar o formulário
- Uma rota e uma função de controlador no servidor para lidar com a solicitação POST do formulário
- Um objeto de modelo
Appointmentpersistente para armazenar informações sobre o usuário
Muito bem, então sabemos o que precisamos para criar um novo agendamento. Agora, vamos começar analisando o modelo, onde decidimos quais informações queremos armazenar com o agendamento.
Modelo de agendamento
O modelo de agendamento é bastante simples, mas como os humanos estarão interagindo com ele, vamos nos certificar de que adicionamos alguma validação de dados.
Nosso aplicativo conta com o ASP.NET Data Annotations. Em nosso caso, queremos apenas validar que alguns campos são obrigatórios. Para isso, usaremos a anotação de dados [Required].
Por padrão, ASP.NET MVC exibe o nome da propriedade ao processar um controle. Em nosso exemplo, esses nomes de propriedade podem ser Name ou PhoneNumber. Para renderização de Name, não deve haver nenhum problema. Mas para PhoneNumber, poderíamos querer exibir algo melhor, como "Número de telefone". Para esse tipo de cenário, podemos usar outra anotação de dados: [Display(Name = "Phone Number")].
Para validar o conteúdo do campo PhoneNumber, estamos usando a anotação de dados [Phone] que confirma que os números de telefone inseridos pelo usuário estão de acordo com os padrões de formatação E.164.
O nosso modelo de agendamento agora está definido. É hora de dar uma olhada no formulário que permite que um administrador crie novos agendamentos.
Novo formulário de agendamento
Quando criamos um novo agendamento, precisamos de um nome de convidado, um número de telefone e uma hora. Usando as classes de auxiliador de HTML, podemos vincular o formulário ao objeto do modelo. Esses auxiliares gerarão a marcação HTML necessária que criará um novo agendamento no envio.
Agora que temos um modelo e uma IU, veremos como podemos interagir com Appointments.
Interação com agendamentos
Como usuário, quero exibir uma lista de todos os agendamentos futuros e poder excluir esses agendamentos.
Se você é uma organização que lida com muitos agendamentos, provavelmente deseja poder visualizá‐los e gerenciá‐los em uma única interface. É isso que vamos abordar nesta história do usuário. Criaremos uma IU para:
- Mostrar todos os agendamentos
- Excluir agendamentos individuais
Sabemos quais interações queremos implementar, então vamos ver primeiro como listar todos os futuros Agendamentos.
Obter uma lista de agendamentos
No nível do controlador, vamos obter uma lista de todos os agendamentos no banco de dados e vamos renderizá‐los com uma exibição. Também adicionamos um prompt se não houver agendamentos, para que o usuário admin possa criar um.
É assim que retornamos a lista de agendamentos, agora precisamos renderizá‐los. Vamos analisar o modelo de agendamentos para isso.
Exibição de todos os agendamentos
A exibição de índice lista todos os agendamentos classificados por ID. A única coisa que precisamos adicionar para preencher nossa história de usuário é um botão de exclusão. Adicionaremos o botão de edição apenas para começar.
Auxiliares de HTML
Você pode notar que, em vez de codificar os urls para Editar e Excluir, estamos usando os auxiliares de HTML do ASP.NET MVC. Se você visualizar a marcação renderizada, verá esses caminhos.
/Appointments/Edit/idpara editar/Appointments/Delete/idpara excluir
AppointmentsController.cs contém métodos que lidam tanto com operações de edição quanto de exclusão.
Agora que temos a capacidade de criar, visualizar, editar e excluir agendamentos, podemos nos aprofundar na parte divertida: agendar um trabalho recorrente que enviará lembretes por SMS quando um agendamento estiver chegando!
Enviar lembretes
Como um sistema de agendamentos, desejo notificar um usuário via SMS sobre um intervalo arbitrário antes de um agendamento futuro.
Há muitas maneiras de criar essa parte de nosso aplicativo, mas não importa como você o implemente, deve haver duas partes em movimento:
- Um script que verifica o banco de dados quanto a qualquer agendamento que esteja por vir e, em seguida, envia um SMS.
- Um trabalhador que executa esse script continuamente.
Vamos dar uma olhada em como decidimos implementar este último com o Hangfire.
Trabalhando com o Hangfire
Se você nunca usou um agendador de tarefas antes, você pode querer verificar esta publicação do Scott Hanselman que mostra algumas maneiras de executar tarefas em segundo plano em ASP.NET MVC. Decidimos usar o Hangfire devido à sua simplicidade. Se tiver uma maneira melhor de programar trabalhos em ASP.NET MVC, comente com a gente.
O Hangfire precisa de um back‐end de algum tipo para enfileirar os trabalhos futuros. Nesta implementação, estamos usando o SQL Server Database, mas é possível usar um armazenamento de dados diferente. Você pode verificar a documentação dele para obter mais detalhes.
Agora que incluímos dependências do Hangfire no projeto, vamos dar uma olhada em como configurá‐lo para usá‐lo em nosso aplicativo de lembretes de agendamentos.
Classe de configuração do Hangfire
Criamos uma classe nomeada Hangfire para configurar nosso agendador de trabalhos. Essa classe define dois métodos estáticos:
ConfigureHangfirepara definir parâmetros de inicialização para o agendador do trabalho.InitialzeJobspara especificar quais trabalhos recorrentes devem ser executados e com que frequência devem ser executados.
É apenas isso para a configuração. Vamos dar uma olhada rápida em como inicializamos o agendador de trabalhos.
Inicialização do Agendador de trabalhos
Este projeto do ASP.NET MVC é aplicativo baseado em OWIN, que nos permite criar uma classe de inicialização para executar qualquer lógica de inicialização personalizada necessária em nosso aplicativo. Este é o local preferido para iniciar o Hangfire: consulte os documentos de configuração para obter mais informações.
Agora que começamos o agendador de trabalhos, vamos dar uma olhada na lógica que é executada quando nosso trabalho é executado.
Trabalho em segundo plano de notificação
Nesta classe, definimos um método chamado Execute que é chamado a cada minuto pelo Hangfire. Sempre que o trabalho é executado, precisamos:
- Obter uma lista de agendamentos futuros que requerem o envio de notificações
- Usar a Twilio para enviar lembretes de agendamentos via SMS
As classe AppointmentsFinder consulta nosso banco de dados do SQL Server para encontrar todos os agendamentos cuja data e hora estão chegando em breve. Para cada um desses agendamentos, usaremos a API REST da Twilio para enviar uma mensagem formatada.
Agora que estamos recuperando uma lista de agendamentos futuros, vamos dar uma olhada em como usamos a Twilio para enviar notificações via SMS.
Solicitação da API REST da Twilio
Esta classe é responsável por ler nossas credenciais de conta da Twilio no Web.confige usar a API REST da Twilio para realmente enviar uma notificação a nossos usuários. Também precisamos de um número da Twilio para usar como remetente para a mensagem de texto. Na verdade, enviar a mensagem é uma única linha de código!
Tutorial divertido, certo? Onde podemos levá‐lo a partir daqui?
Para onde ir em seguida?
E com um pequeno código e um pouco de configuração, estamos prontos para receber lembretes automatizados de agendamentos disparados em nosso aplicativo. Bom trabalho!
Se você for um desenvolvedor de C# que trabalha com a Twilio, talvez queira conferir outros tutoriais:
Coloque um botão em sua página da web que conecta os visitantes ao suporte ao vivo ou à equipe de vendas por telefone.
Melhore a segurança da funcionalidade de login do seu app Flask adicionando autenticação de dois fatores por mensagem de texto.
Isso ajudou?
Obrigado por conferir este tutorial! Se você tiver algum feedback para compartilhar, entre em contato pelo Twitter... adoraríamos ouvir suas ideias e saber o que você está desenvolvendo!
Precisa de ajuda?
Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.
