FAQ

A short Q&A index. If something is missing here that should be, file it via Getting help and we'll add it.

For users

My test call won't connect — what now?

Open the Flow Designer on a flow in Draft state and start a test call. Test calls only work when the WebRTC feature flag is enabled on your platform and your browser has microphone permission. See Troubleshooting → For users for the full tree.

Where do I edit providers and endpoints?

Both live inside the Flow Designer. Open the app, then the Flow Designer, and use the Endpoint and Provider inspectors on the right panel. Provider settings are stored inline in the flow; saved provider records are not supported in v0.9.14-patch1 and later. See Endpoints and Providers.

Why are some features missing from my view?

Most Delphi features are gated by feature flags that platform operators control. If a feature mentioned in these docs isn't visible to you, ask your platform admin to check Feature flags. The docs surface the flag name beside the relevant content via the FeatureFlag callout.

Why can't I publish my flow?

Publishing requires a non-empty flow, a valid endpoint binding, and the appropriate role. See Draft and publish. If the Publish button is disabled, check the inspector for unresolved errors and confirm your role under Access roles.

Where do conversation recordings go?

Recordings are written by the Voice service to the platform's recordings bucket when RECORDING_ENABLED=true and the app has Recording on. As a user you'll see them attached to conversations under the app's history. Visibility depends on your role. See Conversations.

How do I stop call transcripts from being saved?

Leave Recording off on the app (Rec Off on the app overview, or Flow Designer → Flow Settings → App settings). Transcript retention is tied to the recording toggle — there is no separate transcript-only setting. Platform PII redaction (ENABLE_PII_LOGGING=false) hides text in TelWeb and SigNoz but does not prevent full transcript persistence when recording is enabled. See Recording and transcript retention.

For team admins

How do I invite a member?

Open Team settings → Members and use Invite. Roles are documented in Access roles. If an invite isn't arriving, also check the platform's email delivery — your platform admin can verify it in Web operations.

My API key returns 401 — what's wrong?

Common causes: the key was rotated, the scope is wrong, you're hitting a different environment than the key was issued for, or your platform has the webrtc feature flag off (API keys only apply to the WebRTC slice of TelAPI). See Troubleshooting → For team admins → API keys and API authentication.

Why can't I see Billing in Team settings?

Billing UI surfaces only when the billingEnabled feature flag is on. See Subscription for the customer-visible model and Feature flags for the flag itself.

Where do I configure tools and variables?

Both moved into the Flow Designer. Tools are edited via the Tool inspector; team-shared variables live in the Variable catalogue. See Tools and Variables.

The call hung up before the bot finished speaking — why?

Usually Wait for silence is off on the managed hangup action, the flow uses Realtime mode (no modular TTS queue), or the carrier sent BYE upstream. See Speech playback and hangup.

Can I run text-only browser chat without voice?

Yes — issue a TelAPI session token with mode: "text" and open the channel WebSocket. You can upgrade to voice mid-session. See Text chat (API) and SDK quick start → Text chat.

For platform operators

Where's the source code?

The Delphi platform source is not public. You deploy from prebuilt container images via the Delphi Portal. The TelPhi client SDK is the only public source-level surface.

How do I change a non-secret environment variable?

Update vars.yaml (or the variable's authoritative source — see Environment variable resolution), re-run the service's update.sh, and restart the affected containers. The full reference is in Environment variable index.

How do I change a secret?

Update it in AWS Secrets Manager (or your equivalent), then restart the container that consumes it. Some secrets require a re-run of the service update.sh to be re-fetched. Postgres rotation and migration vs runtime users: Database credentials. RDS composition: Managed database secrets.

How do new teams get shared OpenAI/Azure keys?

SUPERUSERs must register openaiDefaultKey and azureDefaultKey under Platform Settings → Platform Secrets and Set Secret before autopopulate can copy values to teams. See Team default secrets.

Which platform version is running?

Several places agree on the same version — see Version sources. The most reliable is the running container image tag (docker compose images).

How do I roll back a release?

Re-run a service's update.sh with the previous --ecr-tag. If the new release ran database migrations you can't downgrade with, see Recovery recipes → Redeploy a service for the safe path.

Where do I see logs, traces, and metrics?

Use SigNoz monitoring first. SIP method/response-code reference: SIP signaling reference. Drop down to Instance debugging when telemetry isn't flowing.

General

How do I report a bug?

See Getting help for the support request template and the information to attach. Short answer: open a ticket with the platform version, the affected URL/route, repro steps, and (for operators) the relevant logs or trace ID from SigNoz.

Is there a public roadmap?

There isn't a public roadmap page on this site. Release-by-release changes are published as release notes.