KK-DATA avatar KK-DATA

Complete Guide to Custom Number Generation: Batch Generate Global Numbers via CSV Import and Seamlessly Integrate Number Screening

全球号码生成 号段 kkdata 出海营销

Complete Guide to Custom Number Prefix Generation: Bulk Generate Global Numbers via CSV Import and Seamlessly Connect to Number Filtering

In B2B SaaS outbound lead generation scenarios, efficiently building a number pool for a target country is the first step for Telegram mass messaging and WhatsApp marketing. Generating numbers in bulk directly from number prefixes (e.g., US +1 555 prefix), then validating their active status and engagement through filtering tools has become a standard workflow for mature teams. This guide will walk you through how to import custom number prefixes via CSV and seamlessly connect number generation with filtering on the KK-DATA platform, covering 240+ countries.

What Is Custom Number Prefix Generation and Why Does Outbound Marketing Need It?

Custom number prefix generation means that instead of relying on the platform’s pre-set random numbers, users specify number prefixes (i.e., the number segment) themselves, and the system generates complete random numbers in bulk based on those prefixes. Each country/region has fixed number prefix allocation rules. For example, US numbers typically start with +1, followed by a three-digit NPA (Numbering Plan Area) code and a seven-digit local number. When you focus on a specific region or carrier, manually entering dozens or even hundreds of prefixes is extremely inefficient; the CSV import mode perfectly solves this problem.

In outbound marketing, the core value of custom number prefix generation is:

  • Precise lead generation: Target prefixes associated with specific cities or carriers to generate a candidate pool, then filter out valid numbers through screening (e.g., Telegram activity detection).
  • Batch operations: Import hundreds or thousands of prefixes at once; the system automatically completes the numbers, far more efficient than entering them one by one.
  • CRM integration: Your existing customer data is often a list of number prefixes; CSV import can directly convert that data into numbers ready for filtering without manual format conversion.

Preparation: Organize the CSV File to Import and Understand Prefix Rules

Before starting the generation task, you need to prepare a CSV file that meets the specifications. Below are the field requirements and examples.

CSV Field Description

Field NameTypeRequiredExampleDescription
country_codestringYesUSTwo-letter ISO country code, e.g., US/GB/JP
prefixnumberYes1555Local number prefix without country code, digits only, no spaces or plus signs
quantityintegerNo1000Number of numbers to generate per prefix; uses global default if empty
notesstringNoCalifornia regionOptional note, not processed by the system

Valid Prefix Rules

  • Prefix length is recommended to be 4-7 digits; too short may result in non-standard number formats.
  • The prefix must not include international access codes (e.g., 00 or +); only local number digits.
  • Ensure the country code matches the prefix’s region. For example, the US prefix 1555 should have country_code ‘US’, not ‘GB’.
  • Avoid importing duplicate prefixes; the system will filter them out.

Common Errors and Fixes

  • Missing country code: The system will prompt the row number; add the corresponding ISO code.
  • Prefix contains spaces: Remove all whitespace characters.
  • CSV encoding is not UTF-8: Use Notepad or Sublime Text to save as UTF-8 encoding.
  • Mixed field separators: Use commas; do not mix with tabs.

After exporting the error list, fix the issues and re-upload.

Note: CSV format errors cause generation failure

Ensure the CSV file is UTF-8 encoded, fields are comma or tab separated. Prefixes must not contain spaces, only digits. For a specific template, refer to the documentation at docs.kkdata.cc.

Step 1: Log in to the Console and Enter the “Global Number Generation” Module

  1. Visit the KK-DATA App Console, log in with your registered email or Telegram.
  2. Find the Global Number Generation module in the left navigation bar and click to enter.
  3. Check your account balance: Number generation is completely free and does not consume balance. However, if you plan to submit filtering tasks afterward, ensure sufficient balance. You can first check per-platform pricing on the Billing page.

Step 2: Upload the CSV File to Import Custom Prefixes

On the number generation page, click the Upload CSV button and select your local file.

Automatic Parsing and Validation

  • After upload, the system automatically reads the fields and validates each row for prefix format and country code correspondence.
  • Valid entries are displayed in a preview list showing country, prefix, and quantity for each.
  • Invalid entries are marked in red; click “View error details” to download the error list.

Customize the Number of Numbers to Generate per Prefix

The preview list uses the quantity field from the CSV by default. If the CSV does not specify a quantity, or you want to override the global default, you can set a “default generation quantity” (e.g., 1000) at the top of the page. All prefixes without an explicit quantity will use this value. Prefixes with an explicit quantity are unaffected.

Step 3: Configure Generation Parameters and Start the Task

On the preview interface, you can:

  • Adjust individually: Click the “quantity” column for each prefix and enter a new generation number directly.
  • Link filtering platform: Check “Automatically submit filtering after generation” and select the target platform (Telegram / WhatsApp / iMessage / RCS) and detection type. This step is optional; if not selected, only numbers are generated.
  • Click “Start Generation”: The system creates the generation task. Tasks typically complete within seconds to minutes, depending on the number of prefixes and total numbers.

Tip: Generation is free

Global number generation is completely free and does not consume balance. Charges apply only when submitting filtering tasks. You can safely generate any number of numbers, then filter for valid active ones.

Step 4: Export the Generated Results or Submit a Filtering Task Directly

After the generation task is complete, you will see two main action areas:

H3: Export Format Selection and Data Deduplication

  • Click “Export” and choose CSV or TXT format to download all generated numbers.
  • Strongly recommended: Use the deduplication repository before export. The system will automatically compare the current generation batch with all historical tasks and filter out numbers that have already been checked. This avoids duplicate charges when submitting filtering tasks later.

H3: Connecting to Filtering: From Generation to Valid Numbers in Two Steps

If you did not link filtering during generation, you can initiate filtering directly from the results page:

  1. Check the generation batch(es) you want to filter (multiple can be selected).
  2. Click the “Filter” button. In the dialog that appears, select the platform and detection type (e.g., Telegram activity detection); the system will automatically estimate the cost.
  3. Confirm and submit the filtering task. After completion, you will receive a notification via your bound Telegram account.

Efficient Pipeline: Generation + Filtering in One Go

After the generation task is complete, simply click “Filter” on the results page; the system automatically includes all numbers without needing to re-upload. Saves time and effort.

Best Practices: 5 Tips to Improve Custom Prefix Generation and Filtering Efficiency

  1. Use prefix ranges in batches (rather than one by one): In the CSV, you might use wildcards or range expressions? However, the current version recommends simply listing each prefix. For consecutive prefixes, manually list the first 10-20; the system will randomly complete the rest.
  2. Prioritize high-activity country prefixes: The activity levels of Telegram/WhatsApp users vary greatly between countries. Start with high-activity prefixes in your target markets (e.g., India +91, Indonesia +62, US +1 mainstream prefixes) to reduce wasted numbers.
  3. Leverage the deduplication repository: Before each generation, import historical filtering results into the deduplication repository. The system will automatically filter out duplicate numbers during generation, saving filtering costs.
  4. Control single batch size: A single task can handle up to ~1 million numbers. It is recommended not to exceed 500,000 per batch to avoid overly large export files. For larger scales, split into multiple tasks.
  5. Verify official customer service via anti-fraud queries: The platform provides official Telegram account verification to guard against fake customer service. The entire generation-filtering workflow is completed within the console; do not trust third-party tools.

Comparison of Custom Prefix Generation: Analysis of Tools like 007data, thdata

Comparison DimensionKK-DATA007data / thdata (based on public information)
Prefix import methodCSV batch import, supports 240+ countriesSome platforms only allow manual input or one-by-one addition
Generation limit~1 million per batch, no frequency limitSome limit to 50,000 per batch or daily total
Filtering integrationNative integration, one-click submission after generationMost require manual download and re-upload to filtering tools
Pricing modelNo subscription, generation free, filtering charged per checkSome have monthly plans, or generation also costs
Prefix flexibilitySupports any local prefix + country code combinationSome only support fixed country prefixes, not customizable

Why Are More Teams Switching to CSV Import Mode?

Because manual entry of prefixes is inefficient and error-prone. Outbound marketing teams often have CRM or third-party purchased prefix lists; CSV direct import can process hundreds or thousands of prefixes in batch and easily integrate with existing data. While older tools like 007data have a large user base, they generally lack in at least one of custom prefix import or filtering integration: either import format is limited, or manual bridging is required after generation.

Limitations of Custom Prefix Features in 007data and thdata

Based on public information:

  • 007data: Primarily provides random generation from fixed country prefixes; custom prefix capability is weak, usually only supporting selection from a list of country prefixes, not arbitrary prefixes from CSV.
  • thdata: Supports prefix import but has strict batch size limits (e.g., 50,000 max per batch) and weaker integration with filtering modules, requiring multiple uploads and downloads.

KK-DATA supports unlimited generation for 240+ countries (up to ~1 million per batch) and native integration with filtering modules, significantly reducing the time from generation to lead acquisition.

Frequently Asked Questions

Q: Are the numbers generated by custom prefix generation real?

A: The generated numbers are random virtual numbers based on international numbering rules; they may not exist or be active. They serve as a candidate pool for subsequent filtering. You can submit all generated numbers to filtering tasks (e.g., Telegram activity detection), and the system will truthfully determine which numbers are registered, active, and their gender.

Q: When importing custom prefixes via CSV, does the prefix need to include the country code?

A: It is recommended to specify the country code column (e.g., “US”) and the prefix (e.g., “1555”) separately in the CSV; the system will automatically concatenate them into international format. If your CSV already contains full numbers (e.g., +155555512), they can be used directly as prefixes, but make sure to remove extra spaces.

Q: Is custom prefix generation on KK-DATA free? How is filtering charged?

A: Number generation is completely free and does not consume balance. Charges apply only when submitting generated numbers to filtering tasks (e.g., Telegram valid detection, WhatsApp filtering). The specific unit price is based on real-time rates in the console; no subscription plans.

Q: How does KK-DATA’s custom prefix generation differ from 007data and thdata?

A: Based on public information, KK-DATA supports CSV batch import of custom prefixes, compatible with 240+ countries, up to ~1 million numbers per batch, and allows one-click submission to filtering tasks after generation without intermediate download/uploads. 007data and thdata each have limitations in import flexibility, generation limits, and filtering integration. If you value pipeline efficiency and customization, KK-DATA is a better choice.

Q: What if a generation task fails? How to read error messages?

A: Task failures are usually due to CSV format errors, duplicate prefixes, or country code mismatches. Check the failure details on the generation page; the system will highlight the erroneous rows and indicate specific reasons. Fix the CSV and re-upload. You can also export the error list for analysis. If the problem persists, contact official customer service @kkdata_cc for help.


Now that you’ve mastered the techniques for custom prefix generation and integration with filtering, you can gain an edge in lead generation efficiency. Log in to the KK-DATA Console to try CSV import, or refer to the complete User Documentation for more templates and best practices. If you have any questions, feel free to contact @kkdata_cc.

Related Articles

Premium Number Segment Generation Practical Guide: Batch Acquisition Strategies and Tool Comparison for Global Numbers with Specific Prefixes

In overseas marketing, premium number segment generation helps you quickly obtain localized numbers with specific prefixes, enhancing trust and bypassing platform risk controls. This article details the application of number generation in Telegram/WhatsApp customer acquisition, compares tools like 007data and thdata in terms of premium number generation and number screening, and helps you build an efficient 'generate → screen → utilize' pipeline to improve customer acquisition ROI.

Free Global Number Generation, Pay Per Number Screening: How KK-DATA Reduces Trial Costs for Overseas Customer Acquisition?

KK-DATA offers a model of 'free generation + pay per number screened': generate numbers for 240+ countries/regions for free, and only pay after screening. Say goodbye to subscription plans, validate overseas markets at low cost. Learn how to flexibly control your budget in Telegram/WhatsApp customer acquisition.

The Complete Guide to Global Number Generation: Area Code Strategies for 240+ Countries and Screening Integration

Master the core methods of global number generation, covering area codes for over 240 countries and random generation strategies. This article details three approaches: area code generation, random generation, and CSV import, seamlessly integrating with Telegram/WhatsApp number screening workflows to boost customer acquisition efficiency. Includes cost optimization, tool comparisons, and FAQs, ideal for overseas marketing and data operations teams.