Mint campaign UTM links through the piha.li shortener #10

2026-08-30T13:20:14-07:00

westfarn commented

2026-08-30 13:20:14 -07:00

Summary

Closes #9.

Campaign composer auto-inserts a tracked homepage link (utm_source=monica, utm_medium = channel, utm_campaign = slug of the name) for email, SMS, and postcard QR — no manual UTM paste.
When SHORTENER_BASE_URL + SHORTENER_API_TOKEN are set, the app mints that long HTTPS URL via POST /api/links/ on the shortener API host and puts the returned piha.li / beta.piha.li short URL in SMS, email hrefs, and QR codes. Empty env (local) falls back to the long UTM URL.
Live composer resolves shorts through a portal JSON endpoint (login + CSRF). Browser never calls the shortener.

Secrets (control node, not git)

monica_site (~/Documents/secrets/monica_site/):

# prod
SHORTENER_BASE_URL=https://shortener.aimloperations.com
SHORTENER_API_TOKEN=monica:<secret>

# beta
SHORTENER_BASE_URL=https://shortener-beta.aimloperations.com
SHORTENER_API_TOKEN=monica:<beta-secret>

url_shortening_service (same secret, named token):

SHORTENER_API_TOKENS=monica:<secret>
SHORT_ALLOWED_HOSTS=mkdrealtor.com,aimloperations.com

Prod public short host: piha.li. Beta: beta.piha.li. Generate with python -c "import secrets; print(secrets.token_urlsafe(32))".

Template port: westfarn/web_django_template#3

Test plan

cd site && uv run python manage.py test messaging.tests.CampaignUtmLinkTests
Composer: type a campaign name — email gets an HTML link, SMS gets a URL, postcard shows a QR
With shortener env set: SMS/QR show piha.li (or beta.piha.li); without it, long UTM URL still works
Copy/download QR into postcard designer
Secret files have SHORTENER_* on both caller and operator sides before beta/prod deploy

## Summary Closes #9. - Campaign composer auto-inserts a tracked homepage link (`utm_source=monica`, `utm_medium` = channel, `utm_campaign` = slug of the name) for email, SMS, and postcard QR — no manual UTM paste. - When `SHORTENER_BASE_URL` + `SHORTENER_API_TOKEN` are set, the app mints that long HTTPS URL via `POST /api/links/` on the shortener **API host** and puts the returned `piha.li` / `beta.piha.li` short URL in SMS, email hrefs, and QR codes. Empty env (local) falls back to the long UTM URL. - Live composer resolves shorts through a portal JSON endpoint (login + CSRF). Browser never calls the shortener. ## Secrets (control node, not git) **monica_site** (`~/Documents/secrets/monica_site/`): ``` # prod SHORTENER_BASE_URL=https://shortener.aimloperations.com SHORTENER_API_TOKEN=monica:<secret> # beta SHORTENER_BASE_URL=https://shortener-beta.aimloperations.com SHORTENER_API_TOKEN=monica:<beta-secret> ``` **url_shortening_service** (same secret, named token): ``` SHORTENER_API_TOKENS=monica:<secret> SHORT_ALLOWED_HOSTS=mkdrealtor.com,aimloperations.com ``` Prod public short host: `piha.li`. Beta: `beta.piha.li`. Generate with `python -c "import secrets; print(secrets.token_urlsafe(32))"`. Template port: https://git.aimloperations.com/westfarn/web_django_template/issues/3 ## Test plan - [ ] `cd site && uv run python manage.py test messaging.tests.CampaignUtmLinkTests` - [ ] Composer: type a campaign name — email gets an HTML link, SMS gets a URL, postcard shows a QR - [ ] With shortener env set: SMS/QR show `piha.li` (or `beta.piha.li`); without it, long UTM URL still works - [ ] Copy/download QR into postcard designer - [ ] Secret files have `SHORTENER_*` on both caller and operator sides before beta/prod deploy

westfarn added 1 commit 2026-08-30 13:20:15 -07:00

Mint campaign UTM links through the piha.li shortener.

CI / test (pull_request) Successful in 21s

Details

ef0655e8d5

Closes #9.

Auto-insert tracked homepage links in campaign compose, register them with
url_shortening_service, and put short piha.li URLs in SMS, email hrefs, and
postcard QR codes when SHORTENER_* is configured.

westfarn merged commit 2b3f10e784 into main

2026-08-30 13:24:41 -07:00

westfarn deleted branch feat/9-campaign-utm-shortener

2026-08-30 13:24:41 -07:00

westfarn referenced this pull request from westfarn/web_django_template

2026-09-01 11:54:27 -07:00

Add campaign UTM links and piha.li shortener #4

westfarn referenced this issue from a commit

2026-09-01 13:36:02 -07:00

Add campaign UTM links and piha.li shortener (#4)

Sign in to join this conversation.