CallPal

Connect Telnyx to CallPal

Open a Telnyx account, buy a number, create the SIP login CallPal dials through and connect it as a trunk — about ten minutes from start to first call.

Before you start

  • A CallPal account. The 14-day trial is enough — no card required.
  • In CallPal, permission to manage SIP trunks. Owners and admins have it by default.
  • A card to add a few dollars of calling credit to Telnyx. Telnyx bills your minutes, CallPal does not.
  • The country you want your calls to come from, so you buy a number there.
  1. Create a Telnyx account and add credit

    Sign up at telnyx.com and confirm your email. That confirmation is all a new account needs to start: Telnyx verifies you at its first level automatically.

    In the Mission Control portal, press the green + at the top and add at least $3 of credit. Calls draw from this balance, not from your CallPal plan.

  2. Buy the number your calls will come from

    Search for a number in your country and buy it. This is the caller ID your contacts will see, so pick one local to the people you call.

  3. Create a SIP connection with a username and password

    Go to Voice → SIP Trunking and press Create SIP Connection. Choose Credentials (Username & Password) as the way it authenticates.

    Telnyx generates the username and password for you. Keep this page open — they are what you paste into CallPal in the last step.

  4. Attach your number to the connection

    In My Numbers, press the pencil in the SIP Connection column beside the number you bought, and choose the connection you just made.

  5. Allow outbound calls with an Outbound Voice Profile

    Go to Voice → Outbound Voice Profiles, press Add New Profile and give it a name. Add your SIP connection to it, choose the countries it may call, and save.

    Without this profile Telnyx refuses every outbound call, however correct the login is. A daily spend limit here is a sensible guard while you are trying things out.

  6. Add the trunk in CallPal

    In CallPal, open Settings → SIP Trunks and press Add Trunk. Give it a Name you will recognise in the call log — "Telnyx" is usually the right one.

    Pick Telnyx as the Provider template. It fills in the SIP server host, sip.telnyx.com, and the port for you, and selects Credentials (register) as the authentication method.

    Paste the Username and Password from step 3. Your password is written to a secrets manager, never to the trunk record.

    sip.telnyx.com
  7. Add your number as the caller ID

    Under Phone numbers (DIDs), enter the number from step 2 in E.164 format — a plus sign, the country code, then the number. Calls placed through this trunk present it.

    A number Telnyx has not authorised for your account will be rejected by Telnyx, not by CallPal — so it has to be the one attached to your connection in step 4.

    +14155550123
  8. Test the trunk, then activate it

    A trunk you have just added reads Pending, with Health Unknown. That is expected, not a fault.

    Press Test to probe Telnyx immediately. When the probe succeeds, Health reports Up. Then press Activate to enable the trunk — Status moves to Active straight away and your team can call.

    If Status settles on Failed or Health reads Down, the host or the credentials are wrong — the Telnyx portal will show the rejected registration attempt.

What you configure

Provider template
Telnyx. Fills in the host, port and audio settings Telnyx documents; you can still change any of them.
SIP server host
sip.telnyx.com, filled in by the template. This is where CallPal registers and sends your calls.
Authentication method
Credentials (register), selected by the template. CallPal signs in to Telnyx with the connection’s username and password.
Username and Password
The pair Telnyx generated for your SIP connection. The password is stored in a secrets manager, not on the trunk record.
Phone numbers (DIDs)
The Telnyx number your calls present as caller ID, in E.164 format. It must be attached to the same SIP connection.

What it does not do

Worth reading before you roll this out to a team — some of these are how CallPal works, others are the carrier’s own rules.

  • CallPal is outbound only. No inbound routing, no IVR, no predictive dialing.
  • You pay Telnyx directly for numbers and minutes, at Telnyx’s rate. CallPal does not resell phone service, so nothing about calling cost passes through your CallPal plan.
  • The caller ID must be a number on your Telnyx account, attached to this connection. Telnyx rejects any other.
  • A new Telnyx account allows two calls at a time and cannot call internationally until you complete Telnyx’s second verification level.
  • A trunk that tests healthy proves your login, not your permission to call a country — that is the Outbound Voice Profile’s job, and it is set in Telnyx, not in CallPal.

Questions

What does calling cost?

Whatever Telnyx charges you — there is no CallPal markup, because CallPal never bills minutes. You add credit to Telnyx and calls draw from that balance; your CallPal plan is the same however much you dial.

Why can only two of us call at once?

A new Telnyx account allows two calls at a time. Ask Telnyx for their second verification level (under Account Verification in Mission Control) to raise it to ten and to call internationally.

The trunk tests fine but every call fails.

Check the Outbound Voice Profile from step 5: it must include your SIP connection and allow the country you are calling. Then check that the caller ID in CallPal is the number attached to that connection.

Can I use a number I already have on Telnyx?

Yes. Skip buying one and attach your existing Telnyx number to the new SIP connection in step 4, then enter it as the caller ID in CallPal. It has to be on your Telnyx account — Telnyx will not present a number it has not authorised for you.

Can I add a second carrier for failover?

Yes. Add it as a second trunk in CallPal. If the first stops registering, calls move to the next healthy one.

Still stuck?

Write to [email protected] with your account name and what you saw. A person answers.