Lembretes de agendamentos com Node.js e Express
Mario Celi
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!
Esse aplicativo da web do Node.js Express envia lembretes para agendamentos futuros que os clientes podem criar por meio do aplicativo também. Isso é feito por meio de uma tarefa em segundo plano que é executada a cada minuto.
Neste tutorial, vamos destacar os principais bits 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.
Confira como a Yelp usa o SMS para confirmar reservas de restaurantes para clientes.
Vamos começar! Clique no botão abaixo para começar.
Configurar o aplicativo para usar a Twilio
Antes de podermos usar a API do Twilio para enviar mensagens de texto de lembrete, precisamos configurar nossas credenciais de conta. Elas podem ser encontradas no Twilio Console. Você também precisará de um número de telefone habilitado para SMS - você pode encontrar ou comprar um novo aqui.
Para enviar um lembrete de agendamento, primeiro precisamos ter um agendamento!
Criar um novo agendamento
No controlador, inserimos as informações necessárias (nome e número de telefone de um cliente, mais uma data e hora para o agendamento) salvando‐as em um modelo Appointment.
Usamos o Mongoose neste aplicativo para armazenar nosso modelo no MongoDB.
var AppointmentSchema = new mongoose.Schema({
name:String,
phoneNumber: String,
notification : Number,
timeZone : String,
time : {type : Date, index : true}
});
Agora que criamos o Appointment, vamos ver como agendar um lembrete para ele.
Agendar um trabalho para enviar lembretes
A cada minuto, gostaríamos que nosso aplicativo verificasse o banco de dados de agendamentos para ver se algum agendamento está chegando, que exige o envio de lembretes.
Para fazer isso, usamos o node-cron.
Configuramos na função iniciar o código do trabalho que gostaríamos de executar e o intervalo no qual executá‐lo. Em seguida, chamamos ele do ponto de entrada de execução do aplicativo como: scheduler.start()
Esta função start usa um notificationsWorker, em seguida, veremos como funciona.
Criar uma função de trabalhador para executar o trabalho
Para realmente executar nossa lógica de trabalho recorrente, criamos uma função de trabalhador que usa um Método de modelo estático para consultar o banco de dados para agendamentos futuros e enviar lembretes conforme necessário.
Em seguida, vamos ver como o trabalho Appointment funciona em detalhes.
Encontrar agendamentos que precisam de lembretes
Nosso trabalho recorrente usa um método de modelo estático do modelo Appointment para consultar o banco de dados para agendamentos que chegam no minuto atual e enviar mensagens de lembrete usando um cliente Twilio REST que havíamos inicializado anteriormente com nossas credenciais de conta da Twilio.
Devido ao fato de que os agendamentos são definidos em diferentes fusos horários, usamos a biblioteca Moment.js para consultar adequadamente todos os próximos agendamentos considerando seu fuso horário.
Tudo o que resta a fazer é enviar o SMS real. Veremos isso a seguir.
Enviar mensagens de lembrete com a API da Twilio
Este código é chamado para cada agendamento que estiver chegando e que exija que um lembrete seja enviado. Fornecemos um objeto de configuração com um campo to, que é o número de telefone do cliente, um campo from, que é um número em nossa conta e um campo body, que contém o texto da mensagem. Em seguida, vamos passá‐lo para o método sendMessage juntamente com um retorno de chamada para registrar erros e sucessos.
É isso! Nosso aplicativo está pronto para enviar lembretes para os próximos agendamentos.
Para onde ir em seguida?
Esperamos que você tenha achado este exemplo de aplicativo útil. Se você for um desenvolvedor do Node.js/Express que trabalha com a Twilio, talvez queira conferir outros tutoriais:
Automação do fluxo de trabalho
Crie um fluxo de trabalho de SMS automatizado pronto para escalar para uma empresa de aluguel de férias.
Faça chamadas de navegador para telefone e de navegador para navegador com facilidade.
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.
