Add webhooks for OURA #901

toddkazakov · 2025-12-16T14:29:17Z

BACK-4162
BACK-4164
BACK-4165
BACK-4041
BACK-3959
BACK-4166

sequenceDiagram
    actor User
    participant JotForm
    participant Platform
    participant Customer.io
    participant Shopify

    User->>JotForm: Submits survey
    JotForm->>Platform: Webhook call with submission ID
    Platform->>JotForm: Pull submission details
    JotForm-->>Platform: Return submission data
    
    Platform->>Platform: Check eligibility criteria
    Platform->>Customer.io: Check if participant ID exists
    Customer.io-->>Platform: Return participant status
    
    Platform->>Shopify: Generate discount code
    Shopify-->>Platform: Return discount code
    
    Platform->>Customer.io: Send oura_eligibility_survey_completed event
    Customer.io->>Customer.io: Trigger Sizing Kit Campaign
    
    User->>Shopify: Place Sizing Kit Order
    Shopify->>Platform: Send orders/create notification
    Platform->>Customer.io: Send oura_sizing_kit_ordered event
    Shopify->>Platform: Send fulfillments/update or fulfillments/create notification
    Platform->>Shopify: Generate discount code
    Shopify-->>Platform: Return discount code
    Platform->>Shopify: Send oura_sizing_kit_delivered event
    Customer.io->>Customer.io: Trigger Ring Campaign

    User->>Shopify: Place Ring Order
    Shopify->>Platform: Send orders/create notification
    Platform->>Customer.io: Send oura_ring_ordered event
    Shopify->>Platform: Send fulfillments/update or fulfillments/create notification
    Platform->>Shopify: Send oura_ring_delivered event

toddkazakov · 2025-12-16T15:12:30Z

/deploy dev1

toddkazakov · 2025-12-16T15:15:19Z

/deploy dev

tidebot · 2025-12-16T15:15:23Z

toddkazakov updated values.yaml file in dev1

tidebot · 2025-12-16T15:15:24Z

toddkazakov updated flux policies file in dev1

tidebot · 2025-12-16T15:15:25Z

toddkazakov deployed platform tk-oura-webhooks-shopify branch to dev1 namespace

…w subscribing to webhooks from the shopify UI

…orders

ewollesen

A few things small things that I think can be quickly fixed. Nothing majorly blocking, though the use of the platform's error package might take a fair bit of cut and paste, if it's decided that it should be done at all.

In general, while there are tests, they seem to focus on successful completion, i.e. testing that things work, not that things that shouldn't work don't work, or that things that don't work fail in the expected manner. Given the relatively temporary nature of this code, that's not too concerning, but as always, today's hot fix is tomorrow production code. So... Shrug, something to think about maybe.

oura/customerio/customer.go

customerio/segment.go

ewollesen · 2026-01-08T11:00:43Z

oura/jotform/api/router.go

+	ctx := req.Context()
+	responder := request.MustNewResponder(res, req)
+
+	if err := req.ParseMultipartForm(multipartMaxMemory); err != nil {


It would be simpler I think to call to PostFormValue. It will call the appropriate ParseForm method as needed, and return the first matching field.

ewollesen · 2026-01-08T11:24:44Z

oura/shopify/discount.go

+	OuraRingProductID         = "15496765964675" // Todd's test store
+	OuraRingDiscountCodeTitle = "Oura Ring Discount Code"
+
+	DiscountCodeLength = 12


If these aren't being manually input, and I think they're not... is there any reason not to use the full output of rand.Text()?

The result contains at least 128 bits of randomness, enough to prevent brute force guessing attacks and to make the likelihood of collisions vanishingly small.

I don't have a problem with 12 characters, but better safe than sorry, especially if no one needs to copy the codes, right?

We are sending those in emails. I'd prefer to keep them short. The worst that can happen is to generate a duplicate value the shopify rejects. The reconciliation process should retry this.

ewollesen · 2026-01-08T11:28:41Z

oura/shopify/fulfillment.go

+		},
+	}
+
+	return f.customerIOClient.SendEvent(ctx, identifiers.ID, sizingKitDelivered)


I don't see any sort of retry logic here, maybe that'll be covered by the task / job that gets run 1x / day to reconcile?

The job will be run more frequently (every hour or so) and will reprocessed failures.

oura/jotform/webhook.go

oura/shopify/fulfillment.go

ewollesen · 2026-01-09T13:26:16Z

I believe there's a typo in your process diagram.

The last event is Send oura_sizing_kit_delivered event, but I think it should be something like Send oura_ring_kit_delivered event?

ewollesen · 2026-01-09T13:30:20Z

oura/jotform/api/router.go

nit: if this file lived in oura/jotformapi/router.go, then it would have a clear name, and not need any special naming when importing, i.e.

import "github.com/tidepool-org/platform/oura/jotformapi"

instead of

import ( jotformAPI "github.com/tidepool-org/platform/oura/jotform/api" )

By convention, go imports are all lowercase, so seeing jotformAPI can throw people off, and make them wonder if it's a variable (the capital letters hint that maybe it is) or an import.

I'd like to adhere to established structure and import aliasing in the project even if it is not perfect

darinkrauss

A few comments for your consideration.

oura/customerio/client.go

customerio/client.go

oura/customerio/customer.go

auth/service/service/service.go

oura/shopify/order.go

oura/jotform/webhook.go

darinkrauss

LGTM! I'll let @ewollesen review his comments and the updates to give final approval.

ewollesen · 2026-01-14T13:32:02Z

customerio/client.go

+	}
+
+	if len(errResp.Errors) > 0 {
+		return errors.Newf("API error (status %d): %s", res.StatusCode, errResp.Errors[0].Message)


Has there ever been more than one error here? If so, it might be useful to in some way at least log the other errors—they might provide useful hints as to what went wrong.

I've only seen a single error during testing

ewollesen · 2026-01-14T13:35:58Z

customerio/event.go

+	ctx = log.NewContextWithLogger(ctx, c.logger)
+	url := c.trackClient.ConstructURL("api", "v1", "customers", cid, "events")
+
+	mutators := []request.RequestMutator{


This is fine, but I feel like maybe we should include a way to include default mutators with a client, so this doesn't need to be run on every request. Maybe a slice of mutators could be passed to the constructor. Thoughts @darinkrauss?

Either way, work for another day / PR.

FWIW, I'm in favor of moving to slog now that there is standard structured logging library in go. The way we instantiate loggers and pass them in context is far from ideal.

Sounds like a conversation to be had. Totally in favor of moving to slog, but I still want to retain the ability to add values to any log message further down the stack. Right now that is attached to the Logger attached to the Context. Oh, and I really, really don't want to add a Logger parameter to every function call, Context is enough.

If a logger is required for a function to work then that dependency should be made explicit. I've been bitten too many times by nil pointer derefs because a function down the stack requires a logger but one isn't present in the context. Another option is to just use a global logger. We can (an I agree that we should) use the context to add additional context to log messages.

Ah, okay, yea that makes sense.

oura/shopify/fulfillment.go

toddkazakov added 7 commits December 5, 2025 12:23

Add jotform webhooks for Oura

61a0934

Use the configured jotform API base url

599118c

Ensure user exists before creating consent

48c809f

Parse date time fields correctly

01c769f

Add tests for jotform webhooks

aea76a4

Process oura sizing kit fulfillment webhooks from shopify

e29bcbf

Add tests for fulfillment event webhooks

da418c4

toddkazakov force-pushed the tk-oura-webhooks-shopify branch from 8e9edd8 to 3935ecd Compare December 16, 2025 14:31

Add shopify webhook routes

9a99e16

toddkazakov force-pushed the tk-oura-webhooks-shopify branch from 3935ecd to 9a99e16 Compare December 16, 2025 14:49

toddkazakov added 6 commits December 17, 2025 10:53

Use fulfillment created/updated instead of fulfillment_events to allo…

80d6b51

…w subscribing to webhooks from the shopify UI

Use test store product id

0242687

Use product GID when creating discount code

20a5de8

Configure discount codes correctly

a4b8333

Fix default customer.io track api base url

a951e35

Use id instead of cid when sending events to customer io

27ec01d

toddkazakov force-pushed the tk-oura-webhooks-shopify branch from 37d1eac to 27ec01d Compare December 17, 2025 15:03

Remove some of the unused fields of the fulfillment event

d0d7ec6

toddkazakov force-pushed the tk-oura-webhooks-shopify branch 6 times, most recently from 91c0bc2 to 6c322c7 Compare December 18, 2025 20:34

Add webhook for orders create events to notify customer.io of placed …

a3aa538

…orders

toddkazakov force-pushed the tk-oura-webhooks-shopify branch 2 times, most recently from 3997ec3 to 22aae96 Compare December 23, 2025 10:21

Add tests for shopify orders

9995641

toddkazakov force-pushed the tk-oura-webhooks-shopify branch from 22aae96 to 9995641 Compare December 23, 2025 14:44

toddkazakov added 2 commits January 5, 2026 13:22

Generate account linking code when ring is delivered

a9e257a

Add oura account linking token expiration time

6b33383

toddkazakov requested a review from ewollesen January 7, 2026 13:00

toddkazakov mentioned this pull request Jan 8, 2026

[BACK-4163] Add jotform webhooks for Oura #900

Closed

toddkazakov changed the title ~~Add shopify webhooks for OURA~~ Add webhooks for OURA Jan 8, 2026

ewollesen reviewed Jan 8, 2026

View reviewed changes

Address code review feedback

8af6266

ewollesen reviewed Jan 9, 2026

View reviewed changes

ewollesen previously approved these changes Jan 9, 2026

View reviewed changes

darinkrauss reviewed Jan 9, 2026

View reviewed changes

Reorganize the oura releated code

d0e99a7

toddkazakov dismissed ewollesen’s stale review via d0e99a7 January 12, 2026 13:41

toddkazakov added 2 commits January 12, 2026 16:16

Use the client module to implement the customerio client

7b057b0

Remove unused variable

002e3c0

darinkrauss reviewed Jan 12, 2026

View reviewed changes

oura/shopify/order.go Outdated Show resolved Hide resolved

darinkrauss reviewed Jan 12, 2026

View reviewed changes

oura/jotform/webhook.go Outdated Show resolved Hide resolved

Remove import alias

e52c935

toddkazakov changed the base branch from master to BACK-3960-oura-connection January 13, 2026 17:38

toddkazakov requested a review from darinkrauss January 13, 2026 17:39

darinkrauss reviewed Jan 14, 2026

View reviewed changes

toddkazakov requested a review from ewollesen January 14, 2026 07:36

ewollesen approved these changes Jan 14, 2026

View reviewed changes

toddkazakov merged commit 818a57d into BACK-3960-oura-connection Jan 14, 2026
3 checks passed

toddkazakov deleted the tk-oura-webhooks-shopify branch January 14, 2026 15:47

darinkrauss mentioned this pull request Jan 22, 2026

[WIP] Add Oura functionality #908

Draft

Uh oh!

Add webhooks for OURA #901

Add webhooks for OURA #901

Uh oh!

Conversation

toddkazakov commented Dec 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

toddkazakov commented Dec 16, 2025

Uh oh!

toddkazakov commented Dec 16, 2025

Uh oh!

tidebot commented Dec 16, 2025

Uh oh!

tidebot commented Dec 16, 2025

Uh oh!

tidebot commented Dec 16, 2025

Uh oh!

ewollesen left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ewollesen commented Jan 9, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

darinkrauss left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

darinkrauss left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

toddkazakov commented Dec 16, 2025 •

edited

Loading