Articles in this section

Manage Number Mapping

  • Updated

📘 Number Mapping User Guide

The Number Mapping feature allows you to associate country-specific sender IDs (either local numbers or alphanumeric sender IDs) with your primary text number. This ensures your international messages are sent using a local, compliant sender ID while still centralizing replies and workflows through your U.S.-based number.

🔍 What is Number Mapping?

When a message is sent from your primary U.S. text number (e.g., +1-212-xxx-xxxx) to a recipient in another country, the system checks if there is a mapped local sender ID for that destination. If a mapping exists, the message is automatically sent using that localized sender ID, improving:

  • Deliverability
  • Regional compliance
  • Brand familiarity

All replies are routed back to your primary number, so your inbox, workflows, and campaigns work seamlessly — no matter where the recipient is located.

🧭 Navigating the Number Mapping Page

1. Search & Filter Panel

  • Text Number Dropdown: Select your U.S. primary number to manage mappings.
  • Country Filter: Filter by specific country.
  • Status Checkbox: Show only active mappings.
  • Search Button: Apply selected filters.
  • Add New Mapping: Launch the modal to create a new country-specific mapping.

2. Mapping Table Columns

Column
Description
Country
Destination country where your SMS is sent.
Local Number
The sender ID (number or alphanumeric) used for that country.
Type
Indicates whether the number is Shared or Dedicated.
Action
Delete icon to remove the mapping.

➕ Adding a New Mapping

Clicking “Add New Mapping” opens a modal where you can configure a country-specific sender ID:

Add Mapping Fields

Field
Description
Text Number
Your primary text number (pre-filled).
Country
Select the destination country for mapping.
Available Long Code
Choose a local sender ID or alphanumeric option (if available).
Description (optional)
Add internal notes or labels for this mapping.

Steps to Add

  1. Select your primary number.
  2. Choose the country where you want messages delivered.
  3. Select an available sender ID.
  4. Optionally enter a description.
  5. Click Add to save the mapping.

🔄 Shared vs Dedicated Sender IDs

📤 Shared Sender ID

  • Used by multiple accounts.
  • Ideal for sending outbound SMS and receiving replies.
  • Supported in countries like UK, Germany, Australia, and more.
  • Replies are routed back to your primary number.

✅ Use When:

  • You’re sending notifications or promotional messages.
  • You want to consolidate replies under your main U.S. number.
  • You do not expect users to initiate contact via keywords.

📩 Dedicated Sender ID

  • Exclusively assigned to your account.
  • Required when users need to text you first (e.g., Text-to-Join, Text-to-Vote).
  • Ensures full control over incoming traffic.

💡 How to Get a Dedicated Number:

  1. Go to Manage Text Numbers.
  2. Click Add New Dedicated Number.
  3. Select the country and complete the provisioning.

🔁 Comparison Table

Feature
Shared Sender ID
Dedicated Sender ID
Send SMS
✅
✅
Receive replies
✅ (via primary number)
✅
Users can text first
❌
✅
Exclusive use
❌
✅
Use Case
Alerts, replies
Keywords, voting, workflows

✅ Best Practices

  • Add mappings for countries where you regularly send messages.
  • Use Shared IDs for alerts, promotions, and customer replies.
  • Use Dedicated IDs for campaigns where the customer initiates the conversation.
  • Always verify country-specific sender ID regulations before configuring mappings.

Related articles