🎙️ 1. WebRTC Softphone Token Issuance
Grapphen Vox provides a cryptographically signed access token granting WebRTC voice capabilities to browser and mobile softphones. Tokens auto-renew every 45 minutes.
GET
/api/token
Auth: Bearer / Session
Returns client connection credentials, Twilio Voice capability tokens, and agent identity for incoming and outgoing SIP routing.
Response (JSON)
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"identity": "agent_bhanu_ext_101",
"expires_in": 2700,
"ice_servers": [
{ "urls": "stun:stun.l.google.com:19302" }
]
}💬 2. 10DLC Carrier Compliant SMS
Grapphen Vox routes text messaging via TCR-registered 10DLC campaigns with automated STOP/HELP keyword compliance and real-time carrier delivery receipts.
POST
/api/mobile/sms/send
Outbound SMS
| Parameter | Type | Description |
|---|---|---|
| to | String | E.164 destination telephone number (e.g. +15551234567). |
| message | String | SMS body text (UTF-8, GSM-7 / UCS-2 automatically segmented). |
| from | String | Optional. Assigned DID number from organization pool. |
🔄 3. Real-Time Call Flip & Presence Sync
Transfer live, active phone calls between mobile devices (iOS/Android companion app) and desktop browser consoles with zero audio interruption.
POST
/api/call/flip
Zero-Drop Handoff
Issues an in-dialog SIP REFER to the target endpoint, transferring the active media stream while keeping call metadata and AI transcription uninterrupted.
🎧 4. Audio Recordings & AI Summaries
Retrieve secure audio recordings and post-call Gemini AI summaries, sentiment scoring, and candidate keyword extractions.
GET
/api/mobile/calls/{id}/recording
Audio Stream (MP3/WAV)
Streams dual-channel caller/callee audio with signed temporary URLs.
🌐 5. Unified Grapphen Cloud OS Grid
Grapphen Vox integrates natively with ATS, Rooms, and Mail via shared tenant identities and HMAC-authenticated sync channels:
- Grapphen ATS: Click-to-call candidate profiles directly inside recruitment pipelines.
- Grapphen Rooms: Dial-in phone bridge support for candidates without stable internet or webcams.
- Grapphen Mail: Instant email alerts for missed voicemails with inline audio player and AI transcripts.
💻 6. Code Samples & SDK Quickstart
Dispatch an SMS using cURL or Python:
curl -X POST "https://vox.grapphen.com/api/mobile/sms/send" \
-H "Authorization: Bearer YOUR_SANCTUM_TOKEN" \
-H "Content-Type: application/json" \
-d '{"to": "+15551234567", "message": "Hi Alex, your interview with Grapphen is confirmed for 2:00 PM EST."}'