Canal SMS

Notificações e assistente automático por SMS, através de um telemóvel Android com SIM na loja — sem Meta, sem custo por mensagem.

O que o módulo faz

Com o canal SMS ativo, a app usa um telemóvel Android na loja como «gateway»: as notificações aos clientes (reparação pronta, orçamento enviado, lembretes) saem por SMS pela rede móvel normal — e as respostas dos clientes entram na app e recebem resposta automática.

É o mesmo assistente do WhatsApp, com os mesmos comandos — o cliente escreve «estado» e recebe o ponto da reparação, escreve «orçamento» e recebe o valor, responde SIM ou NÃO para aprovar ou recusar. A diferença: não precisa de conta Meta, de modelos aprovados, nem de internet no telemóvel do cliente.

O cliente escreve	O bot responde
«está pronto?» ou qualquer texto	Estado da reparação + previsão de entrega
«orçamento» / «preço»	Valor do orçamento pendente + instruções
SIM	Aprova o orçamento pendente — mesmo fluxo do balcão
NÃO	Recusa o orçamento
Código da reparação (REP-…)	Estado dessa reparação específica
Número sem ficha	Mensagem simpática com os contactos da loja

O que é preciso

Um telemóvel Android — pode ser um equipamento antigo; fica sempre na loja
Um cartão SIM ativo — idealmente com SMS incluídos no tarifário (o custo das mensagens é da operadora)
A app gratuita «SMS Gateway for Android» (sms-gate.app), da Play Store ou do site oficial
O telemóvel e o PC do OficinaOS na mesma rede Wi-Fi/LAN
Nada mais — o canal SMS é gratuito e não precisa de Cloud nem de módulos

Instalação — passo a passo (~5 minutos)

1. No telemóvel Android, instale «SMS Gateway for Android» (sms-gate.app) a partir da Play Store ou do site oficial.

2. Abra a app e ative o modo «Local Server» (Servidor Local). A app mostra três coisas: o endereço local (ex.: 192.168.1.50:8080), um nome de utilizador e uma palavra-passe.

3. Confirme que o telemóvel está ligado à mesma rede Wi-Fi do PC onde corre o OficinaOS.

4. No PC, na app OficinaOS: Menu → Notificações → Canais → secção SMS.

5. No campo «URL do gateway», escreva http:// seguido do endereço que a app do telemóvel mostra — por exemplo http://192.168.1.50:8080.

6. Preencha o utilizador e a palavra-passe exatamente como aparecem no telemóvel e guarda.

7. Carregue em «Enviar SMS de teste», indique o seu próprio número e confirme que a mensagem chega.

8. Por fim, carregue em «Registar webhook no telemóvel» — isto diz à app do telemóvel para onde enviar os SMS recebidos dos clientes.

SMS Gateway for Android (site oficial)

O detalhe do webhook — porque não pode ser localhost

O botão «Registar webhook» ensina a app do telemóvel a reencaminhar os SMS recebidos para o PC da loja. Para isso, a OficinaOS precisa de saber o seu próprio endereço na rede — e descobre-o a partir do endereço que usa no browser.

Se abrir a app em http://localhost:4000, o webhook fica registado como «localhost» — que para o telemóvel significa ele próprio, não o PC. O registo falha ou fica a apontar para o sítio errado.

Abra a app pelo endereço de rede do PC (ex.: http://192.168.1.20:4000 — o mesmo que usa noutros dispositivos da loja) antes de carregar em «Registar webhook». A app avisa se estiver em localhost.

Manter o gateway fiável

Deixe o telemóvel sempre ligado ao carregador — o gateway é ele; desligado, os SMS não saem
Nas definições do Android, exclua «SMS Gateway» da otimização de bateria (Bateria → Otimização → «Não otimizar») para o Android não o suspender
No router da loja, reserve o IP do telemóvel (reserva DHCP) — se o IP mudar, a configuração deixa de apontar para o sítio certo
Se a loja tiver uma rede Wi-Fi de convidados separada, o telemóvel tem de estar na rede principal — a mesma do PC
Teste rápido de saúde: a app chama GET /health no gateway a cada envio; se falhar, a notificação fica na fila e tenta de novo

Privacidade — o que sai e o que fica

A conversa entre a app e o telemóvel acontece toda dentro da rede da loja (LAN) — nada passa pela OficinaOS Cloud nem por servidores externos. O SMS em si viaja pela rede móvel da operadora, como qualquer SMS.

A palavra-passe do gateway fica guardada na app encriptada (AES-256-GCM) e nunca volta a aparecer nos campos — só se substitui.

Limites honestos

Flood control: máximo 20 mensagens por hora por número — protege contra spam acidental
O custo por SMS é do tarifário do SIM da loja — com SMS incluídos o custo marginal é zero, mas convém confirmar com a operadora
SMS com acentos (ç, ã, é…) consomem mais do limite de 160 caracteres — os modelos devem ser curtos
Uso automatizado intensivo pode violar o fair-use do tarifário — o módulo é para notificações e respostas, não para campanhas em massa
SMS não é WhatsApp: sem imagens, sem botões, texto simples — mas funciona em qualquer telemóvel, até nos mais antigos

Resolução de problemas

Sintoma	O que verificar
SMS de teste não chega	URL correto (http:// + IP:porta)? Número de destino com indicativo (ex.: +351…)? Saldo/SMS disponíveis no SIM?
«Falha na ligação ao gateway»	O telemóvel está ligado e na mesma Wi-Fi do PC? O IP não mudou (ver na app do telemóvel)?
Erro de autenticação	Utilizador e palavra-passe exatamente como na app do telemóvel (são gerados por ela, não é o utilizador que os escolhe)
Cliente responde e nada acontece	O webhook está registado? (botão «Registar webhook») — e foi registado com a app aberta pelo IP de rede, não localhost?
Funcionava e parou	Otimização de bateria do Android suspendeu a app? O IP do telemóvel mudou?

Segurança

Nunca exponha a porta do gateway (ex.: 8080) à internet — é só para a rede interna da loja
Mantenha o telemóvel e o PC na rede de confiança da loja — não na Wi-Fi de clientes/convidados
Se trocar de telemóvel ou de SIM, repita a configuração e registe o webhook outra vez