fix: force FORCE_TURN_RELAY for local IPs in setup

api/services/telephony/factory.py

@@ -28,7 +28,7 @@ from api.services.telephony.base import TelephonyProvider
 
 
 async def load_telephony_config_by_id(
-    telephony_configuration_id: int,
+    telephony_configuration_id: int | str | None,
     organization_id: int,
 ) -> Dict[str, Any]:
     """Load and normalize the config row by primary key, scoped to the org.
@@ -39,17 +39,19 @@ async def load_telephony_config_by_id(
     or doesn't belong to ``organization_id`` — the org scope is what makes
     this safe to expose to user-driven request flows.
     """
-    if not telephony_configuration_id:
-        raise ValueError("telephony_configuration_id is required")
+    try:
+        resolved_cfg_id = int(telephony_configuration_id)
+    except (TypeError, ValueError) as e:
+        raise ValueError("telephony_configuration_id must be an integer") from e
     if not organization_id:
         raise ValueError("organization_id is required")
 
     row = await db_client.get_telephony_configuration_for_org(
-        telephony_configuration_id, organization_id
+        resolved_cfg_id, organization_id
     )
     if not row:
         raise ValueError(
-            f"Telephony configuration {telephony_configuration_id} not found "
+            f"Telephony configuration {resolved_cfg_id} not found "
             f"for organization {organization_id}"
         )
     return await _normalize_with_phone_numbers(row)
@@ -120,7 +122,7 @@ async def find_telephony_config_for_inbound(
 
 
 async def get_telephony_provider_by_id(
-    telephony_configuration_id: int,
+    telephony_configuration_id: int | str | None,
     organization_id: int,
 ) -> TelephonyProvider:
     config = await load_telephony_config_by_id(
@@ -142,7 +144,7 @@ async def get_telephony_provider_for_run(
     still resolve.
     """
     cfg_id = (workflow_run.initial_context or {}).get("telephony_configuration_id")
-    if cfg_id:
+    if cfg_id is not None:
         return await get_telephony_provider_by_id(cfg_id, organization_id)
     return await get_default_telephony_provider(organization_id)
 
@@ -167,7 +169,7 @@ async def get_telephony_provider_for_inbound(
 
 async def load_credentials_for_transport(
     organization_id: int,
-    telephony_configuration_id: Optional[int],
+    telephony_configuration_id: Optional[int | str],
     expected_provider: str,
 ) -> Dict[str, Any]:
     """Helper for per-provider transport modules.
@@ -178,10 +180,9 @@ async def load_credentials_for_transport(
     so legacy runs created before the multi-config migration still work.
     Raises ValueError when the resolved config is for a different provider.
     """
-    if telephony_configuration_id:
-        config = await load_telephony_config_by_id(
-            telephony_configuration_id, organization_id
-        )
+    resolved_cfg_id = telephony_configuration_id
+    if resolved_cfg_id is not None:
+        config = await load_telephony_config_by_id(resolved_cfg_id, organization_id)
     else:
         config = await load_default_telephony_config(organization_id)
 
@@ -189,7 +190,7 @@ async def load_credentials_for_transport(
     if actual != expected_provider:
         raise ValueError(
             f"Expected {expected_provider} provider, got {actual} "
-            f"(config_id={telephony_configuration_id}, org={organization_id})"
+            f"(config_id={resolved_cfg_id}, org={organization_id})"
         )
     return config
 
@@ -199,11 +200,6 @@ async def get_all_telephony_providers() -> List[Type[TelephonyProvider]]:
     return [spec.provider_cls for spec in registry.all_specs()]
 
 
-# ---------------------------------------------------------------------------
-# Internals
-# ---------------------------------------------------------------------------
-
-
 async def _normalize_with_phone_numbers(
     row: TelephonyConfigurationModel,
 ) -> Dict[str, Any]:

api/tests/test_telephony_factory.py

@@ -0,0 +1,96 @@
+from types import SimpleNamespace
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from api.services.telephony.factory import (
+    get_telephony_provider_for_run,
+    load_credentials_for_transport,
+    load_telephony_config_by_id,
+)
+
+
+@pytest.mark.asyncio
+async def test_get_telephony_provider_for_run_casts_numeric_string_config_id():
+    workflow_run = SimpleNamespace(
+        initial_context={"telephony_configuration_id": "213"}
+    )
+
+    with (
+        patch(
+            "api.services.telephony.factory.get_telephony_provider_by_id",
+            new_callable=AsyncMock,
+            return_value="provider",
+        ) as get_provider,
+        patch(
+            "api.services.telephony.factory.get_default_telephony_provider",
+            new_callable=AsyncMock,
+        ) as get_default,
+    ):
+        result = await get_telephony_provider_for_run(workflow_run, 2617)
+
+    assert result == "provider"
+    get_provider.assert_awaited_once_with("213", 2617)
+    get_default.assert_not_awaited()
+
+
+@pytest.mark.asyncio
+async def test_get_telephony_provider_for_run_rejects_non_numeric_string_config_id():
+    workflow_run = SimpleNamespace(
+        initial_context={"telephony_configuration_id": "twilio-main"}
+    )
+
+    with patch(
+        "api.services.telephony.factory.get_default_telephony_provider",
+        new_callable=AsyncMock,
+    ) as get_default:
+        with pytest.raises(
+            ValueError,
+            match="telephony_configuration_id must be an integer",
+        ):
+            await get_telephony_provider_for_run(workflow_run, 2617)
+
+    get_default.assert_not_awaited()
+
+
+@pytest.mark.asyncio
+async def test_load_credentials_for_transport_casts_numeric_string_config_id():
+    with (
+        patch(
+            "api.services.telephony.factory.load_telephony_config_by_id",
+            new_callable=AsyncMock,
+            return_value={"provider": "twilio"},
+        ) as load_by_id,
+        patch(
+            "api.services.telephony.factory.load_default_telephony_config",
+            new_callable=AsyncMock,
+        ) as load_default,
+    ):
+        result = await load_credentials_for_transport(2617, "213", "twilio")
+
+    assert result == {"provider": "twilio"}
+    load_by_id.assert_awaited_once_with("213", 2617)
+    load_default.assert_not_awaited()
+
+
+@pytest.mark.asyncio
+async def test_load_telephony_config_by_id_casts_numeric_string_before_db_lookup():
+    row = SimpleNamespace(id=213)
+
+    with (
+        patch(
+            "api.services.telephony.factory.db_client.get_telephony_configuration_for_org",
+            new_callable=AsyncMock,
+            return_value=row,
+        ) as get_config,
+        patch(
+            "api.services.telephony.factory._normalize_with_phone_numbers",
+            new_callable=AsyncMock,
+            return_value={"provider": "twilio"},
+        ) as normalize,
+    ):
+        result = await load_telephony_config_by_id("213", 2617)
+
+    assert result == {"provider": "twilio"}
+    get_config.assert_awaited_once_with(213, 2617)
+    normalize.assert_awaited_once_with(row)