Notificações: email, SMS, templates e lembretes

O FIRO trabalha com três canais hoje:

• Email — através de GmailMailer com Gmail SMTP. Suporta HTML rico.
• SMS — através de BulkGateSmsService com integração à API BulkGate (provedor profissional, alcance global).
• Notificações internas — BackofficeNotification para mensagens visíveis no painel da equipa.

WhatsApp como canal de envio está no roadmap. Hoje é usado apenas como booking source (origem da marcação) para tracking de marketing.

O motor é orientado a eventos. Os principais são:

• Marcação criada (pendente) — email de aviso à equipa para aprovar.
• Marcação confirmada — email ao cliente com detalhes e instruções.
• Marcação rejeitada/cancelada — email com explicação.
• Lembrete antes do slot — SMS e/ou email enviado horas antes (configurável).
• Marcação reagendada — comunicação dos novos detalhes.
• Pedidos de RGPD — confirmação ao cliente, alerta à equipa.

O comando artisan SendBookingReminders corre periodicamente e dispara lembretes para marcações que entram na janela configurada.

O FIRO separa conteúdo de código. Há dois tipos de template:

Templates de email globais

EmailTemplate existe ao nível da plataforma. Cada um tem:

• Chave (key) que o sistema procura ao disparar o evento.
• Subject com placeholders.
• HTML com placeholders.
• Estado activo / inactivo para desligar canais inteiros.

O renderer (EmailTemplateRenderer) substitui placeholders pelos dados reais da marcação/cliente.

Templates SMS por tenant

SmsTemplate é editável por cada tenant. Permite adaptar o tom da mensagem ("Olá {{nome}}, lembrete da tua marcação no Salão Maria às {{hora}}.") à voz da marca.

Os lembretes são a feature com retorno mais directo. O argumento típico é "redução de no-shows até 60%" — facilmente verificável depois de uma ou duas semanas de uso.

Configuração

• Tempo de antecedência configurável por tenant.
• Canal (email, SMS ou ambos) configurável.
• Template adaptável.

Limite mensal de SMS

Cada tenant tem um limite mensal de SMS (sms_monthly_limit) consoante o plano. Quando atingido, o sistema mantém os emails mas pára os SMS para evitar custos inesperados. O limite é editável e há contadores no backoffice.

Cada notificação enviada (email ou SMS) deixa registo em NotificationLog:

• Tipo (email / sms).
• Destinatário e contexto.
• Subject e corpo que foi entregue.
• Estado — sucesso, falha, mensagem de erro.
• Metadata em JSON com info adicional (IDs externos, tracking).

Isto resolve a questão clássica "o cliente diz que não recebeu o lembrete". Em segundos, vê-se exactamente o que foi enviado, quando e o estado de entrega.

SMS no FIRO usa BulkGate, um provedor europeu profissional. As credenciais (API key) são geridas centralmente pela administração da plataforma e estão disponíveis ao tenant via configuração.

• Envio individual ou em lote.
• Confirmação de entrega via callback (quando suportado).
• Faturação mensal por tenant ligada ao limite acima.
• Test send disponível na admin para validação inicial.

O serviço BookingSmsNotifier abstrai a chamada — o resto do sistema só dispara um evento.

Cada tenant pode:

• Editar o template SMS — texto, tom, assinatura.
• Desactivar canais inteiros — só email, só SMS, ou nenhum (raro).
• Configurar antecedência dos lembretes.
• Definir o limite mensal de SMS consoante apetite de gasto.

Os emails partem do FIRO mas com remetente ajustado à identidade do tenant onde fizer sentido.