Skip to main content

Sticky Sender

| cURL | Python | PHP | Node | .NET | Ruby | Portal |


cURL

Sticky Sender makes sure the same “From” number is selected every time your application sends a message to a particular recipient. This allows your application to consistently send messages to your user from a single recognizable phone number. When Sticky Sender is enabled, Telnyx will maintain a mapping of the “To” and “From” numbers. This mapping is created after the first message is sent to a particular recipient. Any future messages to that recipient will use the same “From” number.

This information is stored during 8 days since the last message sent to the destination number. Once the 8 days window expires with no new messages, another "From" number could be assigned to start a new Sticky Sender process.

If Sticky Sender is turned off, Telnyx will disregard previously established "To" and "From" mappings when selecting the "From" number for new messages. When a Telnyx phone number is removed from your profile, all associated Sticky Sender mappings are removed.

Your Messaging Profile ID can found at the top of your Messaging Profile under the "Profile Info" section.

The code below enables Sticky Sender for a Messaging Profile:

Note

Don't forget to update YOUR_API_KEY here.

curl -X PATCH \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Authorization: Bearer YOUR_API_KEY" \
--data '{"number_pool_settings":{"sticky_sender": true}}' \
"https://api.telnyx.com/v2/messaging_profiles/{YOUR_MESSAGING_PROFILE_ID}"

curl -X PATCH \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Authorization: Bearer YOUR_API_KEY" \
--data '{"number_pool_settings":{"sticky_sender": false}}' \
"https://api.telnyx.com/v2/messaging_profiles/{YOUR_MESSAGING_PROFILE_ID}"
Note

After pasting the above content, Kindly check and remove any new line added

Python

Sticky Sender makes sure the same “From” number is selected every time your application sends a message to a particular recipient. This allows your application to consistently send messages to your user from a single recognizable phone number. When Sticky Sender is enabled, Telnyx will maintain a mapping of the “To” and “From” numbers. This mapping is created after the first message is sent to a particular recipient. Any future messages to that recipient will use the same “From” number.

This information is stored during 8 days since the last message sent to the destination number. Once the 8 days window expires with no new messages, another "From" number could be assigned to start a new Sticky Sender process.

If Sticky Sender is turned off, Telnyx will disregard previously established "To" and "From" mappings when selecting the "From" number for new messages. When a Telnyx phone number is removed from your profile, all associated Sticky Sender mappings are removed.

Your Messaging Profile ID can found at the top of your Messaging Profile under the "Profile Info" section.

The code below enables and then disables Sticky Sender for a Messaging Profile:

import telnyx
telnyx.api_key = "YOUR_API_KEY"

mp = telnyx.MessagingProfile.retrieve("YOUR_MESSAGING_PROFILE_ID")

# turn on sticky sender
mp.number_pool_settings = {"sticky_sender": True}
mp.save()

# turn off sticky sender
mp.number_pool_settings = {"sticky_sender": False}
mp.save()
Note

After pasting the above content, Kindly check and remove any new line added

PHP

Sticky Sender makes sure the same “From” number is selected every time your application sends a message to a particular recipient. This allows your application to consistently send messages to your user from a single recognizable phone number. When Sticky Sender is enabled, Telnyx will maintain a mapping of the “To” and “From” numbers. This mapping is created after the first message is sent to a particular recipient. Any future messages to that recipient will use the same “From” number.

This information is stored during 8 days since the last message sent to the destination number. Once the 8 days window expires with no new messages, another "From" number could be assigned to start a new Sticky Sender process.

If Sticky Sender is turned off, Telnyx will disregard previously established "To" and "From" mappings when selecting the "From" number for new messages. When a Telnyx phone number is removed from your profile, all associated Sticky Sender mappings are removed.

Your Messaging Profile ID can found at the top of your Messaging Profile under the "Profile Info" section.

The code below enables and then disables Sticky Sender for a Messaging Profile:

\Telnyx\Telnyx::setApiKey('YOUR_API_KEY');

//Turn on sticky sender
\Telnyx\MessagingProfile::Update("YOUR_MESSAGING_PROFILE_ID", ["number_pool_settings" => {"sticky_sender": true}]);

//Turn off sticky sender
\Telnyx\MessagingProfile::Update("YOUR_MESSAGING_PROFILE_ID", ["number_pool_settings" => {"sticky_sender": false}]);
Note

After pasting the above content, Kindly check and remove any new line added

Node

Sticky Sender makes sure the same “From” number is selected every time your application sends a message to a particular recipient. This allows your application to consistently send messages to your user from a single recognizable phone number. When Sticky Sender is enabled, Telnyx will maintain a mapping of the “To” and “From” numbers. This mapping is created after the first message is sent to a particular recipient. Any future messages to that recipient will use the same “From” number.

This information is stored during 8 days since the last message sent to the destination number. Once the 8 days window expires with no new messages, another "From" number could be assigned to start a new Sticky Sender process.

If Sticky Sender is turned off, Telnyx will disregard previously established "To" and "From" mappings when selecting the "From" number for new messages. When a Telnyx phone number is removed from your profile, all associated Sticky Sender mappings are removed.

Your Messaging Profile ID can found at the top of your Messaging Profile under the "Profile Info" section.

The code below enables and then disables Sticky Sender for a Messaging Profile:

import Telnyx from 'telnyx';

const telnyx = new Telnyx("YOUR_API_KEY");

// Turn on sticky sender
const { data : messagingProfile } = await telnyx.messagingProfiles.update(
'YOUR_MESSAGING_PROFILE_ID',
{
"number_pool_settings": { "sticky_sender": true }
}
)

// Turn off sticky sender
const { data : messagingProfile } = await telnyx.messagingProfiles.update(
'YOUR_MESSAGING_PROFILE_ID',
{
"number_pool_settings": { "sticky_sender": false}
}
)
Note

After pasting the above content, Kindly check and remove any new line added

.NET

Sticky Sender makes sure the same “From” number is selected every time your application sends a message to a particular recipient. This allows your application to consistently send messages to your user from a single recognizable phone number. When Sticky Sender is enabled, Telnyx will maintain a mapping of the “To” and “From” numbers. This mapping is created after the first message is sent to a particular recipient. Any future messages to that recipient will use the same “From” number.

This information is stored during 8 days since the last message sent to the destination number. Once the 8 days window expires with no new messages, another "From" number could be assigned to start a new Sticky Sender process.

If Sticky Sender is turned off, Telnyx will disregard previously established "To" and "From" mappings when selecting the "From" number for new messages. When a Telnyx phone number is removed from your profile, all associated Sticky Sender mappings are removed.

Your Messaging Profile ID can found at the top of your Messaging Profile under the "Profile Info" section.

The code below enables and then disables Sticky Sender for a Messaging Profile:

using System;
using Telnyx.net.Services.VerifyAPI;
private static string TELNYX_API_KEY ="TELNYX_API_KEY";

Telnyx.TelnyxConfiguration.SetApiKey(TELNYX_API_KEY);
VerificationService verifyService = new VerificationService();

string webhookURL = "";

var messagingProfile = new Telnyx.MessagingProfileService()
// Sticky Sender turned on
var stickyTrue = new Telnyx.MessagingProfileUpdate
{
NumberPoolSettings = {
StickySender = true
}
};

// Sticky Sender turned off
var stickyFalse = new Telnyx.MessagingProfileUpdate
{
NumberPoolSettings = {
StickySender = false
}
};
messagingProfile.Update(webhookURL, stickyTrue); // Sticky settings to true
messageProfile.Update(webhookURL, stickyFalse); // Sticky settings to false
Note

After pasting the above content, Kindly check and remove any new line added

Ruby

Sticky Sender makes sure the same “From” number is selected every time your application sends a message to a particular recipient. This allows your application to consistently send messages to your user from a single recognizable phone number. When Sticky Sender is enabled, Telnyx will maintain a mapping of the “To” and “From” numbers. This mapping is created after the first message is sent to a particular recipient. Any future messages to that recipient will use the same “From” number.

This information is stored during 8 days since the last message sent to the destination number. Once the 8 days window expires with no new messages, another "From" number could be assigned to start a new Sticky Sender process.

If Sticky Sender is turned off, Telnyx will disregard previously established "To" and "From" mappings when selecting the "From" number for new messages. When a Telnyx phone number is removed from your profile, all associated Sticky Sender mappings are removed.

Your Messaging Profile ID can found at the top of your Messaging Profile under the "Profile Info" section.

The code below enables and then disables Sticky Sender for a Messaging Profile:

require "telnyx"
Telnyx.api_key = "YOUR_API_KEY"

mp = Telnyx::MessagingProfile.retrieve("YOUR_MESSAGING_PROFILE_ID")

# turn on sticky sender
mp.number_pool_settings = {
sticky_sender: true
}
mp.save

# turn off sticky sender
mp.number_pool_settings = {
sticky_sender: false
}
mp.save
Note

After pasting the above content, Kindly check and remove any new line added

Portal

Sticky Sender makes sure the same “From” number is selected every time your application sends a message to a particular recipient. Your application will consistently send messages to your end user from a single recognizable phone number. Once this feature is enabled, Telnyx will maintain a mapping of the “To” and “From” numbers after the first message is sent to a particular recipient, and any future messages to that recipient will use the same “From” number.

This information is stored during 8 days since the last message sent to the destination number. Once the 8 days window expires with no new messages, another "From" number could be assigned to start a new Sticky Sender process.

If Sticky Sender is turned off, Telnyx will disregard previously established "To" and "From" mappings when selecting the "From" number for new messages. When a Telnyx phone number is removed from your profile, all associated Sticky Sender mappings are removed.

To configure Sticky Sender in your Portal:

  1. Click on “Messaging” in the navigation menu on the left-hand side of the Telnyx Mission Control Portal.
  2. Click the edit symbol next to the Messaging Profile you want to use.
  3. Under Outbound, toggle on “Number Pool” to enable.
  4. Select the “Sticky Sender” checkbox.
  5. Click “Save”.

sticky sender

That’s it! You’re ready to use Sticky Sender.