Call Masking
Anonymous two-party voice calls through a virtual number and Voice Conversations API.
Call Masking lets two parties speak by phone without exposing their real numbers. Routee routes the call through a virtual number and uses the Voice Conversations API to bridge the parties — common in ride-sharing, marketplaces, and on-demand services.
How it works
sequenceDiagram participant A as Client A participant V as Virtual number participant S as Your server participant B as Recipient B A->>V: Inbound call V->>S: POST dialplan URL S->>V: Return dialplan with DIAL V->>B: Bridged outbound call Note over A,B: Both parties keep their numbers private
When to use it
- Privacy — keep driver/rider or buyer/seller numbers private
- Security — reduce harassment and off-platform contact
- Compliance — limit PII exposure in two-sided marketplaces
Prerequisites
| Requirement | Resource |
|---|---|
| Routee account + OAuth app | Get Authenticated |
| Virtual number | Rent a number or activate in console |
| Voice Conversations API | Perform a voice conversation |
| Callback endpoints | Voice conversation callbacks |
Implementation path
- Rent a virtual number and configure Dialplan URL + Inbound Voice Callback URL on the number.
- On inbound call, your server returns a dialplan that DIALs the second party from the virtual number.
- Track both legs via
messageIdand tie them withconversationTrackingId.
Step-by-step tutorialBuild call masking with Conversation API — full ride-sharing-style scenario with sample payloads.
RelatedClick-to-Call example · Voice Conversations · Receive inbound voice calls
Updated 23 days ago

