Telephony
Connect phone numbers you already own to a Dynamiq voice agent with a SIP trunk, and handle inbound calls and keypad input.
Dynamiq does not sell phone numbers. You bring numbers you already own at a SIP provider — Twilio, Telnyx, or anyone else — and point that provider's trunk at Dynamiq. You keep your carrier relationship, your rates, and your numbers.
Everything here lives on the Telephony tab of the agent page.
Deploy the agent before connecting numbers. Inbound calls are routed to the agent's hosted worker, which only exists once the agent is deployed, so Connect numbers is refused on a draft agent rather than merely having no effect.
The exception is the create wizard: numbers entered there are queued and connected as part of the deploy itself.
Connect your numbers
Choose a provider
Provider is Twilio, Telnyx, or Other SIP provider. The choice tailors the setup guide Dynamiq shows you afterwards; any SIP provider works.
Add the numbers
In Phone numbers, enter each number with its country code — +14155550134. Press Enter or comma after each, or paste a whole list and Dynamiq splits it into chips, telling you how many entries it skipped as invalid.
Spaces, brackets, dashes and dots are fine — the field normalizes them away, and a leading 00 becomes +. The one thing it will not guess is the country code: a bare national number is rejected with a prompt to add one. Numbers are stored in strict E.164 form regardless of how you typed them.
Add digest authentication if your provider uses it
Turn on Digest authentication and enter the Username and Password your SIP provider sends with inbound calls. Recommended for Telnyx.
The password is passed through to the routing layer when the trunk is provisioned and is not returned by the API afterwards — if you need to change it, re-enter it.
Connect
Click Connect numbers. Dynamiq provisions a dedicated inbound SIP trunk and a routing rule for this agent, and the card switches to the connected state showing status Active.
In the create wizard there's no button — numbers you enter are queued and connected as part of Deploy.
Point your trunk at Dynamiq
The connected card shows Point your trunk's origination at followed by a copyable SIP URI. Set that as the origination target of the trunk at your provider, and follow the provider-specific setup guide shown underneath.
The Telephony tab in the connected state showing the SIP URI, the connected numbers, and the provider setup guide
screenshot: voice-telephony-connected
Call the number. It should reach your agent.
One number, one agent
Phone numbers are unique across the whole platform. Attempting to connect a number that is already attached somewhere fails with a conflict, and the error distinguishes the two cases — already connected to another agent, or already connected to this one, in which case you disconnect the existing trunk first.
This is deliberate: a number can only ring one agent, so there is never an ambiguous route.
Disconnecting
Disconnect phone numbers removes the trunk and routing rule. Inbound calls to those numbers stop reaching the agent immediately, and the numbers become available to attach elsewhere.
Deleting a voice agent does the same thing as part of the delete, along with removing its hosted deployment.
Inbound calls
An inbound call arrives at the agent exactly as a browser call does, with two differences you can see on the Calls tab: kind is phone rather than web, and the caller's number is recorded.
Telephony audio is narrowband, so auto noise cancellation selects the telephony-tuned model for these callers automatically. Phone callers also tend to pause more than browser callers — if the agent interrupts them, raise End-of-speech silence in Turn-taking & latency.
Keypad input
Digits a caller presses are delivered to the agent as conversation. Dynamiq collects them, waits 1.2 seconds for the caller to finish typing, and passes the whole string as one turn — so an account number typed as 4, 1, 7 arrives as a single "the caller entered 417", not three separate interruptions.
Tell the agent in its instructions that callers may type as well as speak, and what to do with what they type.
The agent can also send tones — useful once it has been transferred into another system's IVR. See Tools & transfers.
Outbound calls
Dynamiq has no outbound dialing API today. Voice agents answer calls; they do not place them. Calls are recorded with a direction, and an outbound-originated call reaches the agent through the same path, but originating the call is your telephony stack's job — connect it to the agent over the WebSocket transport once your side has the audio.