Connecting Telnyx to SMS-iT with a Telnyx Number Already in Telnyx or purchasing a number in Teleynx
This guide will ensure that the API and all settings are configured correctly in SMS-iT and Telynx. It's designed for users who already have a number in Telynx or would like to purchase a number in Telynx and want to connect it to the SMS-it Platform. This integration will enable you to utilize the Telynx SMS Gateway for various purposes, including bulk messaging, promotional campaigns, OTP (One-Time Password) delivery, and leveraging SMS-iT Smart Tools for customer acquisition and retention strategies
Navigate to: https://portal.telnyx.com/#/app/home
Buying a number in Telynx
To purchase a number if you haven't already, click on "Numbers" in the menu.
Click on "My Numbers"
Click on "Search & Buy Numbers"
Complete the required fields as needed and select between local or toll-free options.
In this example, if you choose "local" and select area code 209, then you would decide on the specific number you want and click "Add to Cart." The cost for the number is $1 per month.
Click on "My Numbers"
You'll see active
Now click on "Home" to begin to connect to SMS-iT
API Key Copy/Paste
Copy the API Key
Return to the SMS-iT dashboard and click on "SMS Gateway"
Click on "Connect"
Click on the pull-down menu
Find Teleynx
Paste the API Key and "Save"
You'll see a green banner indicating that the SMS Gateway has been successfully updated.
Return to "SMS Gateway Connect"
And you'll notice the API Key displayed. This process will automatically fill in certain fields in Telynx, removing the need for manual input.
Before proceeding, ensure that you have pasted the API Key into the designated field and clicked "SAVE." Then, return to the SMS Gateway connection panel before continuing.
Add SMS Webhook
Click ton "Messaging"
Click on "Programmable Messaging"
Click on "Add new profile"
Name your profile.
Paste: https://aicpanel.smsit.ai/api/incoming/sms into "Send a webhook to this URL".
Scroll down.
Click on "Manage Allowed Destinations"
Click the plus icon on your region. (Noth America for US)
Click on "Set Destinations"
Click on "Save"
Your webhook is set.
Setting SIP Connection and Messaging Profile
Go back to the Telnyx "Home" page, then click on "Numbers."
Click on "My Numbers"
Click on "Forward Only" or set SIP Connection (it may be something different than "Forward Only")
Click on the Pencil Icon
Click on the Pull-Down Menu
Click on "_CALL(youremail.com-xxxxx9409)" This is the auto-populated filed that begins with _CALL and has your email signup from SMS-iT in the description
You'll see _CALL(.... Now click the the Green Checkmark to SAVE the setting
Now do the same procedure for "Messaging Profile"
Click this icon
Click on "_SMS([email protected])"
Click this icon
You'll see _CALL(...) and _SMS(...) Make sure these are set before continuing.
Creating a TeXML ID
Click on "Voice"
Click on "Programmable Voice"
Scroll Up
Click on "TeXML Applications"
Click the "Pencil" icon
Click on "Copy ID"
Return to SMS-iT and click on "Connect"
Paste to TeXML App ID
Now return to Telynx
Now we'll connect the SIP username and SIP password. Please return to Telnyx
SIP Username and SIP password
Click on "Voice"
Click on "SIP Trunking"
Click on "Create SIP Connection"
Name the connection "SMS-iT SIP"
Select "Credentials"
Click on "Create"
Scroll Down
Copy Username to SMS-iT
Paste into "SIP Username"
View Password
Copy Password
Paste password into "SIP Password"
Click on "Voice Webhook URL:" and COPY
Return to Telynx and Paste it into "Webhook URL"
Pasted
Click on "Save"
Go back to SMS-iT and click on "Save"
The Green Banner will appear signalling the SMS Gateway is updated.
OVP (Outbound Voice Profile)
Click on "Voice"
Click on "SIP Trunking"
Scroll down
Click on "Select an OVP"
Click on "_VOICE([email protected])"
Click "SAVE"
Final Steps: Adding Number to SMS-iT and checking connection
Click this "Numbers"
Click on "My Numbers"
Copy your number
Click on "Menu"
Click on "Numbers"
Click on "Add Number"
Click on "Telynx" in the pull-down menu
Paste your number
WARNING: You must remove the plus sign "+" from the front of the number before saving
Remove the "+" sign before saving.
Number saved
Click on the number to change to a "Friendly Number"
Edit to a name you'll be able to recognize and "Save"
Check your number is working
Click on Quick Links
Click on "Send a Text"
Click on "Select Send Number"
Choose your Telynx number
Manually input your cell number or a number that you can check
compose a simple text
Click on "Send"
The green banner will indicate a successful message was sent, and verify the text is received on your cell phone.
Done