Get a telephony configuration
GET /api/v1/organizations/telephony-configs/{config_id} — config detail with masked credentials and, for Smartflo, the Voice Bot WSS URL.
GET /api/v1/organizations/telephony-configs/{config_id}Returns one configuration. Credentials are masked. For Tata Smartflo, the response also carries voice_bot_wss_url — the exact streaming URL you paste into the Tata portal so inbound calls reach zoxaAI.
Response
{
"id": 12,
"name": "Smartflo – IN",
"provider": "smartflo",
"is_default_outbound": false,
"credentials": { "auth_token": "****", "click_to_call_api_key": "****" },
"voice_bot_wss_url": "wss://dashboard.zoxa.ai/api/v1/telephony/smartflo/ws?token=eyJ...",
"created_at": "2026-07-01T08:00:00Z",
"updated_at": "2026-07-01T08:00:00Z"
}| Field | Type | Description |
|---|---|---|
id | int | The config_id. |
credentials | object | Provider credentials, masked. |
voice_bot_wss_url | string | null | Smartflo only. Static, signed WSS URL for the Voice Bot channel. null for other providers. |
Smartflo streams to this URL
Smartflo has no per-call HTTP webhook. The voice_bot_wss_url is signed with the config_id; every inbound stream on this account arrives here, and zoxaAI resolves the specific number → agent from the stream's to/from. Set it in Settings → Channels → Voice Bot in the Tata portal. See Tata Smartflo setup.
Examples
curl https://dashboard.zoxa.ai/api/v1/organizations/telephony-configs/12 \
-H "X-API-Key: zsk_..."import httpx
r = httpx.get(
"https://dashboard.zoxa.ai/api/v1/organizations/telephony-configs/12",
headers={"X-API-Key": "zsk_..."},
)
wss = r.json()["voice_bot_wss_url"]Errors
| Status | detail | When |
|---|---|---|
404 | "Telephony configuration not found" | No config with that config_id in your org. |
Related
Create a telephony configuration
POST /api/v1/organizations/telephony-configs — save a provider account (credentials) so its numbers can be managed and dialed.
List phone numbers
GET /api/v1/organizations/telephony-configs/{config_id}/phone-numbers — every number added to a config, with its inbound target.