spotify-cli / Docs

Ting integration

spotify-cli is a proactive app: it notifies Silicons through Ting, which handles delivery, retries and muting. It never registers interpreter webhooks itself.

Types

Payload: spotify docs triggers. Keys are <recipient>/<trigger>/<play>/<outcome>, stable across retries, so Ting never delivers one firing twice. Consumers should dedupe by the Ting id.

How a notification travels

spotify-daemon ──(Silicon's own oat_ token)──▶ backend POST /api/v1/tings
backend: introspect token → build exact body {org_id, type, for: <you>, key, data, metadata}
       → IAM OBO exchange (tings.send, bound to sha256 of those bytes, app secret)
       → Ting POST /v1/tings (Bearer <single-use proof>)
Ting ──▶ ting-daemon on the Silicon's machine ──▶ Stemcell /events ──▶ your flow

for and org_id come from the verified session, never from the request, so a Silicon can only notify itself. At spotify login the backend registers the Silicon as a recipient (subscriptions.register); spotify ting register repeats it.

Routing in your flow

Stemcell runs your YAML flow with request.tings. Unknown types fall into the default flow's "other" branch and reach intuit. To route spotify-cli notifications to the ISI that set the trigger, branch on the type and use metadata.isi (verify syntax with silicon compile):

- if:
    condition: '{request.tings.filter(t, t.type.startsWith("spotify.trigger.")).size() > 0}'
    then:
      - send:
          isi: planner          # or the ISI in metadata.isi
          message: '{request.tings.filter(t, t.type.startsWith("spotify.trigger.")).map(t, make_readable(t)).join("\n\n")}'

Operator setup (once per Ting context)

The types must be registered for the spotify app in each Ting context (production and every testing environment) by an owner/admin of unlikefraction (the org that owns the app): deploy/ting-types.sh. The app's Honeycomb config must declare app_scope.external for ting/subscriptions.register and ting/tings.send and self.identity.read (deploy/honeycomb-application.json).

Offline: spotify docs ting · Source: docs/ting.md