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 as of v0.9.11. Open the app, then the Flow Designer, and use the Endpoint and Provider inspectors on the right panel. The old top-level Providers/Endpoints navigation entries are gone. 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. As a user you'll see them attached to conversations under the app's history. Visibility depends on your role. See Conversations.
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.
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. See Managed database secrets for the canonical example.
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. 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.