{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Deep Link Integration","description":"Start Treasure AI Voice recordings from a link in another app or file and attach reference metadata.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"deep-link-integration","__idx":0},"children":["Deep Link Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure AI Voice can be launched from a deep link in another app or file. The link's query parameters are saved as external metadata on the resulting recording, keeping references to related business records with the conversation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Install the Treasure AI Voice mobile app on the phone that opens the deep link."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign in to the app and pair a supported PLAUD device with your account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a link in the format below and place it in the app or file where users will open it."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-deep-link","__idx":2},"children":["Create a deep link"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["treasureaivoice://recording"]}," scheme and add each metadata key and value as a query parameter:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"treasureaivoice://recording?recordRef=REC7A91&sessionRef=SES42&interactionType=sales\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The link above passes a record reference, a session reference, and an interaction type to the recording. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recordRef"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sessionRef"]}," are example keys an external system can use to associate a recording with its own data; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interactionType"]}," adds descriptive context. Define the keys and values to match the app or workflow that creates the link."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both keys and values must contain only ASCII letters (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A-Z"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["a-z"]},") and digits (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0-9"]},"). Keys must be 1–50 characters, and values must be 1–128 characters. A link can contain up to 10 key-value pairs. Spaces, punctuation, underscores, and non-ASCII characters are not valid."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the link contains invalid metadata, Treasure AI Voice rejects it and does not start a recording from that link."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"start-a-recording","__idx":3},"children":["Start a recording"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the link from another app or file on the phone with Treasure AI Voice installed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the paired PLAUD device is connected, Treasure AI Voice starts recording and associates the link's metadata with the recording."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the device is not connected yet, the app keeps the metadata in the current app session. After the device connects, tap ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start Recording"]}," to create a recording with that metadata."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Pending metadata is not retained after an app restart"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If Treasure AI Voice restarts before the recording begins, the pending metadata is lost. Open the deep link again to pass the metadata to a recording."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-and-export-metadata","__idx":4},"children":["View and export metadata"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The AI Voice Console displays external metadata on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recordings"]}," page. Treasure Data CDP exports include the metadata in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_metadata"]}," column of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recordings"]}," table as a JSON string. For the full export schema, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-voice/cdp-integration#recordings"},"children":["Treasure Data CDP Integration"]},"."]}]},"headings":[{"value":"Deep Link Integration","id":"deep-link-integration","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Create a deep link","id":"create-a-deep-link","depth":2},{"value":"Start a recording","id":"start-a-recording","depth":2},{"value":"View and export metadata","id":"view-and-export-metadata","depth":2}],"frontmatter":{"seo":{"title":"Deep Link Integration","description":"Start Treasure AI Voice recordings from a link in another app or file and attach reference metadata."}},"lastModified":"2026-10-02T00:32:46.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/ai-voice/deep-link-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}