Connecting phone and texting (Telnyx)
Calls and texts run on Telnyx, and only Telnyx. You connect your own Telnyx account on the Phone numbers page. We store the keys encrypted, read the numbers you already own, and point them back at the app so replies and calls land in your pipeline.
Who this is for
Whoever owns the telecom account and its bill. In a captive agency that's the admin only. For independent agents, each agent does this on their own account.
Before you begin
- A Telnyx account. We do not resell. The numbers and the usage are billed to you by Telnyx.
- Admin access to that account, so you can read credentials.
- Know which Telnyx account owns your numbers. An API key from a different account reads an empty number list.
What we do with your credentials
We read the numbers you already own and add them here, so you never re-buy a number you have. We point those numbers back at the app so replies and inbound calls land in your pipeline instead of vanishing. And your AI assistant sends on your own numbers, on your own account and your own bill.
Credentials are stored encrypted. Treat the auth token or API key like a password. It can send messages and spend money on your account.
One carrier: Telnyx
Telnyx is the only carrier the app calls and texts through. There is no second option to pick and nothing to compare. If your numbers are with another carrier today, move them into a Telnyx account first (Telnyx calls this porting, and the numbers stay yours), then connect that account here.
What to copy from Telnyx
You need an API key and, separately, the Public Key. Create the API key under Account Settings → API Keys, and copy it immediately: Telnyx shows the full key only once.
The Public Key is a DIFFERENT credential, under Account Settings → Keys & Credentials. It is not the API key. It's the signing key we use to prove an inbound call or text genuinely came from Telnyx, so without it we can't verify inbound traffic.
Add your Messaging Profile ID (Messaging → Messaging Profiles): it is what your 10DLC campaign attaches to, so it is what makes your texts deliver. Add your Voice Connection / Call Control App ID (Voice → Call Control Applications) if you will call; texting works without it.
Where you do it in the app
Open Phone numbers. The first card is Connect your carrier: paste the keys and save. The card under it imports the numbers you already own in that Telnyx account. Texting then waits on one more thing, your 10DLC registration, which has its own page (A2P registration) and its own article.
How this differs by setup
Solo agent You run everything yourself.
Captive agency The agency owns the numbers, the A2P brand and the bill.
Independent agent You're in an agency but buy your own number and register your own EIN.
How to check it worked
- After saving, the numbers you already own in that Telnyx account should appear in Phone Numbers. An empty list almost always means an API key from a different Telnyx account.
- Send one text to your own phone from the SMS inbox and confirm it arrives.
- Reply to that text from your phone and confirm the reply lands back in the app. That proves the webhook wiring, which is the half people forget to test.
Common mistakes
- Using the Telnyx API key where the Public Key is asked for. They're different credentials with different jobs.
- Copying the API key from a different Telnyx account than the one that holds your numbers, then wondering why no numbers import.
- Assuming saving credentials means you can send. You still need at least one phone number, and for SMS you still need A2P approval.
- Not copying the Telnyx API key at creation. It's shown once; after that you have to make a new one.
Troubleshooting
| No numbers imported after connecting | The API key belongs to a different Telnyx account than the one holding your numbers. Check which account owns the numbers in the Telnyx portal and create the API key there. |
|---|---|
| Outbound works but replies never arrive | The numbers aren't pointed back at the app, or a webhook signing key is missing. Re-run the connect flow, which repoints your numbers, and make sure the Public Key is filled in. |
| Texts send but never deliver | Almost always A2P, not credentials, carriers filter unregistered traffic silently. Check your A2P registration status. See the A2P guide. |
Related
Where this lives in the app
This is documentation for Virtual Closer. Book a walkthrough or sign in.