The File Upload SMS (Mobile Nos with Messages) feature in SMSGatewayCenter allows you to send customized text messages to multiple recipients by uploading a file containing mobile numbers and their respective messages. This step-by-step tutorial will guide you through using this feature, explaining each field and functionality to ensure you send messages successfully while avoiding common pitfalls.
Step-by-Step Guide #
1. Access the Send File Upload SMS Interface #
- What to Do: Log in to your SMSGatewayCenter account and navigate to the Send SMS or Compose Message section, where you’ll find the File Upload option for Mobile Nos with Messages. Select this method to send different messages to recipients listed in a file.
- What Not to Do: Don’t attempt to send messages without logging in, as unauthorized access will result in errors or blocked requests. Avoid using this method if you need to send a single uniform message to all recipients—use the Quick Send or File Upload (Mobile Only) methods instead.
2. Add an Identifier for Your Campaign #
- What to Do: In the Identifier field, enter a title or name for your campaign (e.g., “Personalized Offers,” “Event Reminders”). This helps you identify and organize your SMS campaigns easily in reports or logs.
- What Not to Do: Don’t leave the Identifier field blank, as this could make it harder to track your campaign later. Avoid using vague or duplicate titles (e.g., “Campaign 1,” “Test”), which could confuse your records.
3. Verify the Send Type Field #
- What to Do: Note that the Send Type field is preselected as “File Upload” and cannot be changed. This confirms you’re using the File Upload method to send messages based on a file containing mobile numbers and custom messages, not individual entries or groups.
- What Not to Do: Don’t try to modify or override the “File Upload” setting, as it’s fixed for this method. Avoid confusion by ensuring your file is prepared with both mobile numbers and messages before proceeding.
4. Select a Sender ID #
- What to Do: In the Sender ID field, select an approved sender ID from the dropdown list. This alphanumeric name or number will appear on recipients’ phones, identifying you as the sender. Choose an appropriate sender ID based on your campaign needs. You can set a default sender ID in the Sender ID section of your account, which will automatically load on the compose page for convenience.
- What Not to Do: Don’t use an unapproved or unrecognized sender ID, as this can lead to message rejections by operators. Avoid leaving this field blank or selecting a sender ID not registered for your account.
5. Download and Prepare Your File #
- What to Do: To prepare your file for uploading, click the “Download Sample File” link in the interface. This will download a sample file (e.g.,
.csv,.xls,.xlsx, or.txt) that you can use as a template. Ensure your file includes two columns with headers “Phone” and “Message,” listing mobile numbers and their respective messages in the correct format. Supported file extensions include.csv,.xls,.xlsx, and.txt, and you can zip these files for upload if needed. - Example format in the file:
Phone Message
91xxxxxxxxx1 Hello world
91xxxxxxxxx2 New message
91xxxxxxxxx3 Different message
- Replace the sample mobile numbers (e.g.,
91xxxxxxxxx1) with actual recipient numbers, including country codes, and add unique messages for each in the “Message” column. - What Not to Do: Don’t use unsupported file formats (e.g.,
.doc,.pdf) or files without both “Phone” and “Message” column headers, as this will cause upload failures. Avoid including junk characters (e.g., special symbols, unreadable text) in the “Message” column, as these can cause message delivery failures—check the “File Uploads Summary” report for details if issues arise.
6. Upload Your File #
- What to Do: In the Upload File field, browse your computer’s files and select the prepared file (e.g.,
.csv,.xls,.xlsx,.txt, or a zipped version). Ensure the file follows the sample format: the first column is “Phone” with valid mobile numbers (including country codes), and the second column is “Message” with the custom text for each number. Click the upload button to submit the file, and wait for the system to process it. - What Not to Do: Don’t upload files with incorrect formats, missing headers, or invalid data (e.g., letters in phone numbers), as this will result in errors or failed uploads. Avoid uploading extremely large files without testing a smaller batch first, as this could exceed system limits or cause performance issues.
7. Enable Smart Link (Optional) #
- What to Do: If you want to append a smart link to all messages in your file, toggle the Enable Smart Link switch to “On.” A Smart Link Title field will appear—enter a title for the link. In the interface (noting that the Text Message field is disabled here), click the “Smart Link” or “Media Link” options to open a modal, where you can add a new link or select from previously saved links. The link will be appended to each message in your file automatically.
- What Not to Do: Don’t enable Smart Link unless your campaign requires interactive links, as unnecessary links can confuse recipients or disrupt your custom messages. Avoid using invalid or broken URLs, which could lead to delivery issues or user frustration.
8. Remove Duplicates (Optional) #
- What to Do: By default, the Remove Duplicates option is enabled, removing any duplicate mobile numbers from your uploaded file to prevent redundant sends. If you intentionally want to send messages to duplicate numbers, uncheck this option—but proceed with caution, as some operators may block duplicate deliveries, leading to failures.
- What Not to Do: Don’t uncheck this option without a specific reason, as sending to duplicate numbers can waste credits, increase costs, and result in delivery failures. Avoid uploading files with known duplicates without reviewing operator policies.
9. Send as Flash SMS (Optional) #
- What to Do: If you want the SMS messages to appear as pop-ups on recipients’ devices, enable the Send as Flash SMS toggle. This applies to all messages in your file and is useful for urgent notifications but should be used sparingly.
- What Not to Do: Don’t overuse Flash SMS, as recipients may find it intrusive, and some operators or devices may restrict or block it. Avoid using Flash SMS for non-urgent or promotional messages unless specified in your campaign.
10. Verify the Disabled Text Message Field #
- What to Do: Note that the Text Message field is disabled in this feature because messages are sourced directly from the “Message” column in your uploaded file, not entered manually. Ensure your file contains the correct messages for each mobile number, as this field cannot be used to override or add content.
- What Not to Do: Don’t attempt to enter text in the Text Message field or expect it to override your file’s messages, as it’s intentionally disabled. Avoid relying on this field for content—use your file preparation (Step 5) instead.
11. Select or Add a DLT Template (Optional) #
- What to Do: If your campaign requires DLT compliance (e.g., in India), use the DLT Templates List field to choose a pre-approved template based on your selected sender ID. The template will serve as a fallback or additional check, appending its associated DLT Template ID to the DLT Template ID field automatically. If your file’s messages match a manual template, enter the correct template ID in the DLT Template ID field.
- What Not to Do: Don’t use an unapproved or mismatched DLT template, as this can result in message rejection due to regulatory non-compliance (e.g., DLT in India). Avoid leaving the DLT Template ID field blank if manually referencing a template not in your file.
12. Save as Draft (Optional) #
- What to Do: If you want to save your configuration (e.g., Identifier, Sender ID, file) for later use, enable the Save Message Content as Draft toggle. This saves the setup, allowing you to retrieve and resume it later, which is helpful for recurring campaigns or unfinished setups.
- What Not to Do: Don’t rely on drafts for sensitive or time-sensitive campaigns without securing them, as drafts are tied to your account and could be accidentally modified or deleted. Avoid overwriting existing drafts without confirming the content.
13. Schedule Your Message (Optional) #
- What to Do: If you want to send the messages at a future date and time, use the Schedule field to enter the desired schedule (e.g., “2025-03-08 10:00:00”). The messages will be delivered at the specified time. You can later update or cancel the schedule via the Manage Schedule menu in your account.
- What Not to Do: Don’t schedule messages without verifying the time zone (use your account’s default time zone or specify UTC/GMT explicitly). Avoid scheduling messages too far in advance without monitoring operator policies, as some may limit scheduling periods.
14. Enable Campaign Manager (Optional, with Scheduling) #
- What to Do: If you’ve enabled the Schedule field, you can toggle the Enable Campaign Manager switch to “On” to send your campaign in chunks or batches. This is useful for large file uploads to manage delivery rates and avoid operator throttling. Two additional fields will appear:
- Campaign Limit: Enter the number of messages to send per batch (e.g., 10,000 out of 100,000 total contacts).
- Time Interval: Select an interval from the dropdown (e.g., 1 hour) to space out batches, ensuring smooth delivery.
- What Not to Do: Don’t set an unrealistically low or high Campaign Limit without testing, as this can overwhelm operators or delay delivery. Avoid choosing a Time Interval that’s too short, which could trigger rate limits or delivery failures.
15. Add WhatsApp Integration (Optional) #
- What to Do: If you want to append a WhatsApp link to all messages in your file, enable the Send WhatsApp Link toggle. Enter your personal WhatsApp number (with the country code) in the WhatsApp Number field and optional default text in the WhatsApp Text field (e.g., “Hi ABC, please contact me”). This generates a short link that, when clicked by recipients, opens WhatsApp to send a message to your number with the default text.
- What Not to Do: Don’t enable this feature unless your campaign targets WhatsApp users, as it may confuse SMS recipients or conflict with your file’s custom messages. Avoid using invalid WhatsApp numbers or spam-like default text, which could violate WhatsApp policies or lead to rejections.
16. Review and Send #
- What to Do: Before sending, review the live preview in the right column to ensure the sender ID, timestamp, and sample message (from your file) appear as expected on a mobile device. Once satisfied, click the Send Text button to initiate sending the SMS to the recipients listed in your uploaded file with your configured options.
- What Not to Do: Don’t send messages without reviewing the preview, as formatting or content errors in your file could lead to delivery failures or user confusion. Avoid sending bulk messages from large files without testing a small batch first to verify delivery and compliance.
Best Practices and Tips #
- File Preparation: Before uploading, ensure your file is clean, free of duplicates, and formatted correctly (e.g., “Phone” and “Message” columns with country codes and no junk characters). Use our Download Sample File to verify the structure.
- Monitor Costs: Be aware of cost differences based on message length and content (e.g., Unicode, Smart Links, Flash SMS), as these can increase charges for file-based campaigns.
- Secure Data: Use HTTPS for all API calls and protect file data (e.g., mobile numbers, messages) to prevent unauthorized access.
- Regular Updates: Check for updates to Sender IDs, DLT templates, and operator policies to ensure compliance and avoid delivery issues.
Troubleshooting #
- File Upload Failure: If your file upload fails, verify the file format (
.csv,.xls,.xlsx,.txt, or zipped versions) and structure (e.g., “Phone” and “Message” columns). Check for errors in the upload log and adjust accordingly. - Message Not Delivered: Verify file contacts, Sender IDs, and DLT compliance. Check the “File Uploads Summary” report for failed messages due to junk characters or other errors, and refer to our Delivery Error Codes Reference.
- Duplicate Numbers Fail: Ensure the Remove Duplicates option is enabled unless intentional duplicates are required, and review operator policies.
- Campaign Manager Issues: If batches fail or delivery is delayed, adjust the Campaign Limit and Time Interval, then test with a smaller file. Contact our team if problems persist.
For further assistance, contact our team at contact @ smsgatewaycenter.com or refer to our API Documentation.