|
| 1 | +--- |
| 2 | +title: SPID Protocol SDK |
| 3 | +--- |
| 4 | + |
| 5 | +# SPID Protocol SDK |
| 6 | + |
| 7 | +The **SPID Protocol SDK** enables you to publish and retrieve Smart Packets — structured, voice-ready, AI-retrievable answers — using a lightweight, open standard designed for the AI Web. |
| 8 | + |
| 9 | +SPID is the routing layer that powers identity, intent, and resolution for asynchronous, AI-powered communication. |
| 10 | + |
| 11 | +## Core Concepts |
| 12 | + |
| 13 | +- **Smart Packets**: Structured voice messages with transcript, intent, metadata, and CTAs |
| 14 | +- **SPIDs**: Globally unique identifiers that resolve to Smart Packets |
| 15 | +- **PulseIDs**: Async voice inboxes for people, businesses, or agents |
| 16 | +- **Intents**: Describe the purpose and auto-generate actions |
| 17 | + |
| 18 | +## Why Use the SPID Protocol SDK |
| 19 | + |
| 20 | +### Principles |
| 21 | + |
| 22 | +- **Structure over sprawl** — clean formatting & metadata |
| 23 | +- **Human-first** — built for voice, identity, and permission |
| 24 | + |
| 25 | +### Key Features |
| 26 | + |
| 27 | +- **Smart Packet Format** |
| 28 | +- **SPID Resolution** |
| 29 | +- **Intent-to-CTA Mapping** |
| 30 | +- **PulseID Routing** |
| 31 | +- **Open Schema / No Lock-in** |
| 32 | + |
| 33 | +## Hello World Packet |
| 34 | + |
| 35 | +```json |
| 36 | +{ |
| 37 | + "spid": "spid://demo.voicemate.id/welcome", |
| 38 | + "packet": { |
| 39 | + "title": "Welcome to VoiceMate!", |
| 40 | + "voice_url": "https://cdn.voicemate.id/audio/welcome.mp3", |
| 41 | + "transcript": "Hey there, welcome to your new voice inbox.", |
| 42 | + "intent": "onboard_user", |
| 43 | + "ctas": [ |
| 44 | + { "label": "Learn More", "type": "link", "url": "https://voicemate.id/how-it-works" }, |
| 45 | + { "label": "Get Your PulseID", "type": "link", "url": "https://voicemate.id/signup" } |
| 46 | + ] |
| 47 | + } |
| 48 | +} |
| 49 | +``` |
0 commit comments