Add WABA outreach automation (Z-PRO integration)

Per-product message templates, official/não-oficial channel selection,
manual per-number sending, and a 20-minute internal scheduler for the
existing automatic outreach batch — all pre-existing local work being
committed as-is.

.env.example

@@ -15,6 +15,17 @@
 # Senha pedida para confirmar a limpeza total da base (Configuracoes > Zona de risco)
 #GTI_RESET_PASSWORD=troque-esta-senha
 
+# Credenciais da API externa do Z-PRO (Admin > API no painel do Z-PRO), usadas
+# pela automacao de envio WhatsApp. Normalmente configuradas direto na tela
+# (Configuracoes > Credenciais Z-PRO) — essas variaveis aqui sao so um
+# fallback (util em deploy via Docker/Proxmox) e so valem se os campos da
+# tela estiverem vazios. Sem credenciais em nenhum dos dois lugares a
+# automacao fica sem efeito mesmo com outreach.ativo=true.
+#ZPRO_BASE_URL=seu-dominio-zpro.com.br
+#ZPRO_API_ID=
+#ZPRO_BEARER_TOKEN=
+#ZPRO_WHATSAPP_ID=
+
 # Endpoints das fontes gratuitas (padroes ja funcionam; mude so se precisar)
 #OVERPASS_API_URL=https://overpass-api.de/api/interpreter,https://overpass.kumi.systems/api/interpreter
 #NOMINATIM_API_URL=https://nominatim.openstreetmap.org/search
@@ -23,5 +34,5 @@
 
 # Ritmo das consultas ao OpenStreetMap (ms)
 #OVERPASS_REQUEST_DELAY_MS=5000
-#OVERPASS_TIMEOUT_MS=45000
-#OVERPASS_TEXT_SEARCH=true
+#OVERPASS_TIMEOUT_MS=15000
+#OVERPASS_TEXT_SEARCH=false