Skip to main content
The video uses a specific AI coding tool to demonstrate the setup, but the configuration works 1:1 with Cursor, Claude Code, or any other tool. Despia is web framework and tooling agnostic, so the only thing that matters is the SDK call.
Siri Shortcuts is currently in beta. The SDK shape is stable but edge cases around HomePod and CarPlay invocation may change. Test on real iOS hardware before relying on this in production.
Register a natural language phrase that the user can speak to Siri. When Siri matches the phrase, it opens your app and calls the JavaScript function you bound to the shortcut. The bridge runs through a single SDK call plus a function defined on the global scope.

​
Installation

npm install despia-native

import despia from 'despia-native';

​
How it works

Two pieces have to line up. First, define the function you want Siri to trigger as a global on window. Second, call addtosiri:// with the phrase the user will speak and the name of that global function. The native runtime registers the shortcut with Siri, and when the user later speaks the phrase, your app launches and calls the function. 
import despia from 'despia-native'

const isDespia = navigator.userAgent.toLowerCase().includes('despia')

window.orderCoffee = function () {
    // your logic here, runs when Siri triggers the shortcut
}

if (isDespia) {
    despia('addtosiri://?command=Order Coffee&jsFunction=orderCoffee()')
}
The jsFunction value must include the trailing parentheses, since the runtime executes it as a callable expression. The function itself must be globally accessible, attaching it to window is the simplest way to guarantee that across bundlers.

​
URL parameters

The addtosiri:// scheme takes two query parameters.
ParameterValueNotes
commandThe natural language phrase the user will speak to SiriEncode special characters with encodeURIComponent. Keep it short and distinctive, Siri matches phonetically, not semantically
jsFunctionA global function name with trailing parensMust exist on window before Siri triggers it. Include parentheses, e.g. orderCoffee(), not just orderCoffee
const phrase = 'Order my usual'
despia(`addtosiri://?command=${encodeURIComponent(phrase)}&jsFunction=orderUsual()`)

​
Register a shortcut from a button

The typical pattern is a “Add to Siri” button in your settings or onboarding flow. The user taps it, the native shortcut registration sheet appears, and the shortcut is now live on their device. 
import { useEffect } from 'react'
import despia from 'despia-native'

const isDespia = navigator.userAgent.toLowerCase().includes('despia')

function OrderCoffeeShortcut() {
    useEffect(() => {
        // define the global before the user can register the shortcut
        window.orderCoffee = async () => {
            await fetch('/api/orders', {
                method: 'POST',
                body: JSON.stringify({ item: 'usual' }),
            })
        }
    }, [])

    function addShortcut() {
        if (isDespia) {
            despia('addtosiri://?command=Order Coffee&jsFunction=orderCoffee()')
        }
    }

    return <button onClick={addShortcut}>Add "Order Coffee" to Siri</button>
}
Define the global inside useEffect rather than in the component body, so it lands on window on mount and is available the next time Siri launches your app, even if the component is no longer rendered.

​
Pass arguments to the function

The jsFunction value is executed as a literal expression, so you can hardcode arguments directly into it. This is useful when one shortcut should always do one specific thing. 
window.orderItem = function (item) {
    // your logic here
}

despia('addtosiri://?command=Order a latte&jsFunction=orderItem("latte")')
despia('addtosiri://?command=Order a black coffee&jsFunction=orderItem("black")')
Each shortcut registers as a separate Siri command, so the user can have several, each calling the same function with different arguments. Keep the phrases distinct enough that Siri’s matching does not collapse them.

​
Platform support

Siri Shortcuts work anywhere Siri itself is available, with the limit that some surfaces only run a subset of shortcut types. Custom JavaScript shortcuts launch your app to run the function, so they are best for surfaces where launching the app is acceptable.
SurfaceWorks
iPhone, iPad, iPod touchYes
Apple Watch (paired with iPhone)Yes, opens iPhone app
HomePod (linked to user account)Yes, opens iPhone app
CarPlayYes, for shortcuts that do not require complex UI
Mac (designed for iPad apps)Yes
Android has no Siri equivalent, the SDK call is a no-op when an Android user reaches it. The isDespia guard keeps it safe in browsers, but you may also want to detect platform and hide the “Add to Siri” button on Android entirely. 
const isDespia = navigator.userAgent.toLowerCase().includes('despia')

const isDespiaIOS = isDespia && (
    navigator.userAgent.toLowerCase().includes('iphone') ||
    navigator.userAgent.toLowerCase().includes('ipad')
)

const isDespiaAndroid = isDespia &&
    navigator.userAgent.toLowerCase().includes('android')

const showSiriButton = isDespiaIOS

​
Resources

NPM Package

despia-native

Support

support@despia.com