logo

Connecting Telnyx to SMS-iT and Getting a Number Through the SMS-iT Platform

1

Navigate to https://portal.telnyx.com/#/app/home to create a new Telnyx account

This guide is intended for individuals who wish to add a number to Telynx through the SMS-iT platform. You will still need to have a Telynx account and your billing for the number and charges will come from Telynx.

URGENT: We have identified a critical requirement for SmS-iT CRM users: To ensure high-quality audio during calls, it is essential to purchase a Telynx number with HD Voice capabilities. Without this, call quality may suffer significantly, resulting in poor audio with noticeable crackling.

2

After you create a Teleynx account you will need to add a payment source and add funds (typically $5 to start, that will cover getting a number and 300-400 SMS texts)


After you create a Teleynx account you will need to add a payment source and add funds (typically $5 to start, that will cover getting a number and 300-400 SMS texts)

API Key Copy/Paste

3

At the Telnyx "Home" page copy the API Key

At the Telnyx "Home" page copy the API Key
5

At the SMS-iT dashboard click on "SMS Gateway & SMPP"

At the SMS-iT dashboard click on "SMS Gateway & SMPP"
6

Choose Connect SMS Gateways and Click on "Connect"

Choose Connect SMS Gateways and Click on "Connect"
7

Click on the pull-down menu to select your gateway, Telnyx.

Click on the pull-down menu to select your gateway, Telnyx.
8

Find Telnyx and when you choose it, the Telnyx fields will appear to start your configuration.

Find Telnyx and when you choose it, the Telnyx fields will appear to start your configuration.
9

Paste the Telnyx API Key you copied from the Telnyx dashboard and click "Save"

Paste the Telnyx API Key you copied from the Telnyx dashboard and click "Save"
10

You'll see a green banner indicating that the SMS Gateway has been successfully updated.

You'll see a green banner indicating that the SMS Gateway has been successfully updated.
11

Return to "SMS Gateway Connect"

Return to  "SMS Gateway Connect"
12

And you'll notice the API Key displayed. This process will automatically fill in certain fields in Telnyx, removing the need for manual input.


And you'll notice the API Key displayed. This process will automatically fill in certain fields in Telnyx, 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 a number from SMS-iT

13

Click on "Get New Number"

Click on "Get New Number"
14

From the Pull-Down menu select Telynx

From the Pull-Down menu select Telynx
15

Select either a local number or a toll-free number and area code

Select either a local number or a toll-free number and area code
16

After inputting area code click "Search"

After inputting area code click "Search"
17

Select a number and click on "Buy this Number"

Select a number and click on "Buy this Number"
18

Now return to the Telynx dashboard to complete the next steps.

Setting SIP Connection and Messaging Profile

19

Go back to the Telnyx "Home" page, then click on "Numbers."


Go back to the Telnyx "Home" page, then click on "Numbers."
20

Click on "My Numbers"

Click on "My Numbers"
21

Click on "Forward Only" or set SIP Connection (it may be something different than "Forward Only")

Click on "Forward Only" or set SIP Connection (it may be something different than "Forward Only")
22

Click on the Pencil Icon

Click on the Pencil Icon
23

Click on the Pull-Down Menu

Click on the Pull-Down Menu
24

Click on "_CALL(youremail.com-xxxxx9409)" This is the auto-populated field that begins with _CALL and has your email signup from SMS-iT in the description

Click on "_CALL(youremail.com-xxxxx9409)" This is the auto-populated field that begins with _CALL and has your email signup from SMS-iT in the description
25

You'll see _CALL(.... Now click the the Green Checkmark to SAVE the setting

You'll see _CALL(.... Now click the the Green Checkmark to SAVE the setting
26

Now do the same procedure for "Messaging Profile"

Now do the same procedure for "Messaging Profile"
27

Click this icon

Click this icon
28

Click on "_SMS([email protected])"

Click on "_SMS(youremail@...-936737641)"
29

Click on the Check icon

Click on the Check icon

You'll see _CALL(...) and _SMS(...) Make sure these are set before continuing.

Add SMS webhook

30

Click on "Programmable Messaging"

Click on "Programmable Messaging"
31

Click on the Messaging icon at the left Navigation panel

Click on the Messaging icon at the left Navigation panel
32

You will see your available auto-created Messaging Profiles. Select the _SMS(...) profile you set above and when the profile opens, Scroll down the page and click on Send a webhook to this URL to set your webhook at the Inbound Settings.

You will see your available auto-created Messaging Profiles. Select the _SMS(...) profile you set above and when the profile opens, Scroll down the page and click on Send a webhook to this URL to set your webhook at the Inbound Settings.
33

Add the webhook ( https://aicpanel.smsit.ai/api/incoming/sms ) there and click save.

Add the webhook ( https://aicpanel.smsit.ai/api/incoming/sms ) there and click save.
34

Click on "Manage Allowed Destinations"

Click on "Manage Allowed Destinations"
35

Select the Continent or country you want by clicking on the + icon

Select the Continent or country you want by clicking on the + icon
36

Click on "Set Destinations"

Click on "Set Destinations"
37

Click on "Save"

Click on "Save"
38

Click on Programmable Messaging at the left navigation, underneath Messaging and confirm that your profile Status is turned on which means its active. eg as we have for "SMSiT" in the image below.

Click on Programmable Messaging at the left navigation, underneath Messaging and confirm that your profile Status is turned on which means its active. eg as we have for "SMSiT" in the image below.

Creating a TeXML ID

39

Click on "Voice"

Click on "Voice"
40

Click on "Programmable Voice"

Click on "Programmable Voice"
41

Scroll Up

Scroll Up
42

Click on "TeXML Applications"

Click on "TeXML Applications"
43

Click the "Pencil" icon

Click the "Pencil" icon
44

Click on "Copy ID"

Click on "Copy ID"
45

Return to SMS-iT and click on "Connect"

Return to SMS-iT and click on "Connect"
46

Paste to TeXML App ID

Paste to TeXML App ID
47

Now return to Telynx

Now return to Telynx

Now we'll connect the SIP username and SIP password. Please return to Telnyx

SIP Username and SIP password

48

Click on "Voice"

Click on "Voice"
49

Click on "SIP Trunking"

Click on "SIP Trunking"
50

Click on "Create SIP Connection"

Click on "Create SIP Connection"
51

Name the connection "SMS-iT SIP"

Name the connection "SMS-iT SIP"
52

Select "Credentials"

Select "Credentials"
53

Click on "Create"

Click on "Create"
54

Scroll Down

Scroll Down
55

Copy Username to SMS-iT

Copy Username to SMS-iT
56

Paste into "SIP Username"

Paste into "SIP Username"
57

View Password

View Password
58

Copy Password

Copy Password
59

Paste password into "SIP Password"

Paste password into "SIP Password"
60

Click on "Voice Webhook URL:" and COPY

Click on "Voice Webhook URL:" and COPY
61

Return to Telynx and Paste it into "Webhook URL"

Return to Telynx and Paste it into "Webhook URL"
62

Pasted

Pasted
63

Change API v2 to TeXML. Without this step, you wont be able to view your calls logs in SMS-iT when you make and receive calls.

Change API v2 to TeXML. Without this step, you wont be able to view your calls logs in SMS-iT when you make and receive calls.
64

Scroll up and click on "Inbound"

Scroll up and click on "Inbound"
65

Click "SIP URI calls" and Select "From anyone"

Click "SIP URI calls" and Select "From anyone"
66

Click on "Save"

Click on "Save"
67

Go back to SMS-iT and click on "Save"

Go back to SMS-iT and click on "Save"
68

The Green Banner will appear signalling the SMS Gateway is updated.

The Green Banner will appear signalling the SMS Gateway is updated.

OVP (Outbound Voice Profile)

69

Click on "Voice"

Click on "Voice"
70

Click on "SIP Trunking"

Click on "SIP Trunking"
71

Scroll down

Scroll down
72

Click on "Select an OVP"

Click on "Select an OVP"
73

Click on "_VOICE([email protected])"

Click on "_VOICE(youremail@gmail.com-295075946)"
74

Click "SAVE"

Click "SAVE"

Final Steps: Adding Number to SMS-iT and checking connection

75

Click this "Numbers"

Click this "Numbers"
76

Click on "My Numbers"

Click on "My Numbers"
77

Copy your number

Copy your number
78

Click on "Menu"

Click on "Menu"
79

Click on "Numbers"

Click on "Numbers"
80

Click on "Add Number"

Click on "Add Number"
81

Click on "Telynx" in the pull-down menu

Click on "Telynx" in the pull-down menu
82

Paste your number

Paste your number

WARNING: You must remove the plus sign "+" from the front of the number before saving

83

Remove the "+" sign before saving.

Remove the "+" sign before saving.
84

Number saved

Number saved
85

Click on the number to change to a "Friendly Number"

Click on the number to change to a "Friendly Number"
86

Edit to a name you'll be able to recognize and "Save"

Edit to a name you'll be able to recognize and  "Save"

Check your number is working

87

Click on Quick Links

Click on Quick Links
88

Click on "Send a Text"

Click on "Send a Text"
89

Click on "Select Send Number"

Click on "Select Send Number"
90

Choose your Telynx number

Choose your Telynx number
91

Manually input your cell number or a number that you can check

Manually input your cell number or a number that you can check
92

compose a simple text

compose a simple text
93

Click on "Send"

Click on "Send"
94

The green banner will indicate a successful message was sent, and verify the text is received on your cell phone.

The green banner will indicate a successful message was sent, and verify the text is received on your cell phone.

Done