Connect Telnyx to send SMS from NeetoCRM using your own Telnyx phone numbers. Once it's connected, you can send SMS from a lead, deal or contact, send SMS to many records at once with bulk actions, and send SMS automatically with automation rules.
Before you start
You need:
An active Telnyx account. If you don't have one, see Telnyx's guide to creating an account.
At least one Telnyx phone number that can send SMS.
A messaging profile in Telnyx, with your phone numbers assigned to it.
A Telnyx API key (V2) and your Telnyx public key.
The steps below walk you through each of these.
Phone number or messaging profile?
NeetoCRM can send SMS through Telnyx in two ways. You choose one when you connect Telnyx.
Phone number: NeetoCRM sends every SMS from one Telnyx number that you pick. Choose this if your contacts are in the same country as that number.
Messaging profile: NeetoCRM sends through a messaging profile and lets Telnyx pick which of the profile's numbers sends each SMS. Choose this if your contacts are in several countries. Add a number for each country you send to, because some carriers block SMS from foreign numbers. This method needs Number Pool turned on in Telnyx (Step 3).
If you're not sure, start with a phone number. You can switch to a messaging profile later.
Step 1: Create a messaging profile in Telnyx
Telnyx needs a messaging profile for both methods.
Log in to the Telnyx portal.
Click Real-Time Communications > Messaging in the left-hand menu.
Click Create profile.
Enter a name for the profile.
For API Version, select API V2. NeetoCRM doesn't support API V1.
Select the destinations you send SMS to, or select all destinations.
Leave Webhook URL and Webhook Failover URL empty. NeetoCRM gives Telnyx its own address for delivery updates with every SMS it sends, so the profile doesn't need one.
Under Outbound, select Restrict to mobile numbers only and Enable daily spend limit per connection. Set a daily spend limit that suits you. Many people start with $20.
Click Save.
Step 2: Assign your phone numbers to the messaging profile
A Telnyx number can send SMS only after it's assigned to a messaging profile. This applies to both methods.
In the Telnyx portal, go to Numbers > My Numbers.
For each number you want to send from, select your messaging profile under Messaging Profile.
Save your changes.
If you use the messaging profile method, assign a number for each country you send to.
Step 3: Turn on Number Pool (messaging profile method only)
Skip this step if you use the phone number method.
With the messaging profile method, NeetoCRM doesn't tell Telnyx which number to send from. Telnyx picks a number from the profile's number pool. If Number Pool is off, Telnyx has no number to pick, and your SMS won't be sent.
In the Telnyx portal, go to Messaging.
Click the edit icon next to your messaging profile.
Under Outbound, turn on Number Pool.
Set the weights for long code and toll-free numbers. If you're not sure, keep the defaults.
Click Save.
Step 4: Get your API key and public key
API key (V2)
Click your profile icon in the top-right corner of the Telnyx portal.
Select API keys.
Click Create API key.
Set Expiration to No Expiration (recommended).
Click Create.
Copy the API key right away and keep it somewhere safe. Telnyx shows it only once. If you lose it, you'll need to create a new one.
Public key
In the Telnyx portal, go to Account settings > Keys & Credentials.
Open the Public Key tab.
Copy the public key.
NeetoCRM uses the public key to check that delivery updates really come from Telnyx.
Step 5: Connect Telnyx to NeetoCRM
Go to Admin panel > Integrations > Telnyx.
Click Connect.
Paste your API key and Public key.
Click Verify. NeetoCRM loads your phone numbers and messaging profiles from Telnyx.
-
Under SMS sending method, choose one:
Phone number: select the number to send from. Make sure it's assigned to a messaging profile (Step 2).
Messaging profile: select your messaging profile. If the profile has no numbers assigned, NeetoCRM shows a warning. Go back to Step 2 before you save.
Click Save changes.
The Telnyx page now shows the phone number or messaging profile that NeetoCRM sends from. To switch methods, or to pick a different number or profile, open this page again.
If both Telnyx and Twilio are connected, NeetoCRM sends SMS through Telnyx.
Sending SMS
Make sure the SMS feature is turned on. See Activating and deactivating features.
One record: open a lead, deal or contact and click Send SMS.
Many records: select records on the list page and send SMS as a bulk action. See Bulk actions on leads and deals.
Automatically: add a Send SMS action to an automation rule. See Automation rules.
Troubleshooting
"Telnyx: messaging profile is missing senders" or "Telnyx: messaging profile has no usable numbers": no number is assigned to the messaging profile, or Number Pool is off. Check Steps 2 and 3.
"Telnyx: SMS rejected (destination not mobile)": the recipient's number is a landline. Telnyx blocks it because the profile is set to send to mobile numbers only.
For problems with your Telnyx account, buying numbers or API keys, contact the Telnyx support team.