This guide explains how to connect a Telnyx phone number to a Newo AI Employee for voice and SMS. After completing this setup, the agent will receive inbound calls and SMS and can send outbound SMS on the configured number.
🗒️ NOTE
You need a Telnyx phone number purchased through the Newo Telnyx account. If you have not purchased one yet, see Purchase a phone number via Telnyx.
Find an available number in Telnyx
Open the Telnyx Portal.
Navigate to Real-Time Communications > Numbers > Manage Numbers.
Filter by the target country.
Check the Connection/Application column for each number:
Column value | Meaning |
Empty | The number is available and not connected to any agent |
Has an ID | The number is already in use by another agent |
Configure the voice connector
Open the Builder.
Navigate to Integrations.
Locate
newo_voice_connectorand click the three-dot menu.Select Edit Settings.
Configure the following fields:
Field | Value |
Provider |
|
Agent Phone Number (Provider: Telnyx section) | The purchased Telnyx number in E.164 format |
Click Save. Do not click Publish All yet — complete the SMS connector and attribute setup first, then publish once at the end.
🗒️ NOTE
No webhook URL needs to be pasted into Telnyx. The connection is established automatically via the Telnyx API when the phone number is entered in the connector.
Configure the SMS connector
In the Builder, navigate to Integrations.
Locate
newo_sms_connectorand click the three-dot menu.Select Edit Settings.
Configure the following fields:
Field | Value |
Provider |
|
Telnyx phone number | The same number entered in the voice connector |
Click Save. Do not click Publish All yet.
Set the SMS provider attribute
Navigate to Attributes in the Builder.
Search for
sms_provider.Change the value from
twilio_messengertosms_service.Click Save.
Click Publish All.
⚠️ CAUTION
sms_service sends via the Telnyx SMS connector. twilio_messenger is the default and sends via Twilio Messenger. sip sends via the Voice SIP integration (falls back to twilio_messenger if SIP is not enabled). Select the correct value for your provider.
Verify the connection in Telnyx
Return to the Telnyx Portal.
Navigate to Real-Time Communications > Numbers > Manage Numbers.
Search for the phone number you configured.
Check the Connection/Application column. It should now display an ID (e.g.
a1ce0eae-...), confirming the number is linked to the Newo agent.
🗒️ NOTE
Voice and SMS are now fully configured for this number. The agent will receive inbound calls and SMS, and can send outbound SMS using the sms_service provider.
Next step
Test and validate that voice and SMS are working correctly.