Carry over pre-existing WABA outreach automation WIP

This work already existed uncommitted in the main working tree (not
authored by this branch) and is required as a runtime dependency for the
campaign outreach port (zpro-client, templates, outreach routes/UI). Copied
in as-is, untouched, so this feature branch has a working baseline; the
original uncommitted state in the main checkout is left exactly as it was.

.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