Repository navigation
Commit 37bc55f
docs: explain how to track clicks on HSM Dynamic URL buttons (#642)
## Summary
Fixes #265
Adds a "Tracking clicks on a URL button" section right after the Dynamic
URL example in the HSM Templates doc, explaining:
- Why Glific can't show click counts for Static/Dynamic URL buttons:
WhatsApp never sends an event back to Glific when a contact taps a URL
button (unlike Quick Reply buttons, whose taps come back as a message).
- The workaround: embed a unique per-contact value in the Dynamic URL
and route it through a redirect/link-tracking service that logs the
click before forwarding the contact to the real destination.
- A pointer to use Quick Reply buttons instead, if the flow itself needs
to branch on whether the contact engaged.
## Verification
Confirmed against `glific/glific`:
- `lib/glific_web/providers/gupshup/router.ex` only routes an inbound
`button_reply` (Quick Reply) webhook to the message controller — there
is no equivalent inbound route/handler for CTA/URL button taps, so
Glific never learns a URL button was tapped.
- This matches the existing caveat already in this same doc file
("clicks on this button won't be recorded, as the link opens outside and
does not send a response back to the flow"), which this PR generalizes
into concrete guidance.
## Test plan
- [ ] Docs site renders the new section and `:::note` admonition
correctly
- [ ] Reviewer confirms this matches what's told to orgs on
Discord/support
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Documentation**
* Updated the HSM Templates documentation date.
* Added guidance on tracking URL button clicks: WhatsApp doesn’t report
URL taps back, so use dynamic URLs with a tracking/redirect layer to
record clicks.
* Clarified that for flow logic reacting to engagement, Quick Reply
buttons should be used since they return responses to the flow.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: sangeeta1911 <[email protected]>
Co-authored-by: Claude Sonnet 5 <[email protected]>1 parent 0a7d120 commit 37bc55f
1 file changed
Lines changed: 12 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
112 | 112 | | |
113 | 113 | | |
114 | 114 | | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
115 | 127 | | |
116 | 128 | | |
117 | 129 | | |
| |||
0 commit comments