OneSender by ViViD App Studio
OneSenderby ViViD App Studio
Knowledge Base

Help Center & Knowledge Base

Everything you need to know about setting up and scaling with OneSender.

Getting Started

Set up your workspace, manage your team, and navigate the dashboard.

Welcome to OneSender! Follow these simple steps to set up your account and get started.

  1. Click on the "App Dashboard" button at the top right of the website.
  2. Choose Sign in with Google for instant access, or use your Email address.
  3. Once logged in, you will be prompted to create your first Workspace. Give it your business name.
  4. You will now land on the main Dashboard. You are ready to explore! 🎉

Sending messages to thousands of customers is easy when you import them via a CSV Excel file.

  1. Go to the Audience / Contacts section from the left menu.
  2. Click on the "Import CSV" button.
  3. Download our Sample CSV to ensure your columns (like Name, Phone) are correctly formatted.
  4. Upload your saved CSV file. The system will automatically detect phone numbers.
  5. Click Save. All your contacts are now ready for your next campaign! 📊

Ready to reach your audience? Here's how to send a bulk message.

  1. Navigate to the Campaigns tab and click "Create New Campaign".
  2. Give your campaign a name (e.g., Diwali Offer).
  3. Select the Contact List you imported earlier.
  4. Choose a Pre-Approved Message Template from the dropdown.
  5. Review the cost and click "Launch Campaign". Your messages will start delivering instantly! 🚀

Meta Cloud API Setup

Connect your number, verify your business, and get templates approved.

Connecting your number to the official Meta Cloud API is a quick 5-minute process.

  1. Go to Settings > Meta API Integration in the OneSender dashboard.
  2. Click the "Connect with Facebook" button. A secure Facebook popup will appear.
  3. Log in to your Facebook account and select your Meta Business Portfolio.
  4. Create a new WhatsApp Business profile and enter the phone number you want to use.
  5. Verify the number using the 6-digit OTP sent via SMS/Call.
  6. Once verified, your number is linked and ready to use! 📱

Note: We support Coexistence Mode! You do NOT need to delete your normal WhatsApp or WhatsApp Business mobile app. You can use both the API and your mobile app simultaneously.

Meta requires all outbound business-initiated messages to be pre-approved.

  1. Go to the Templates section from the left menu.
  2. Click "Create Template".
  3. Select a category: Marketing (offers/promos), Utility (updates/receipts), or Authentication (OTPs).
  4. Write your message. Use variables like {{1}} for dynamic content like names.
  5. Click Submit for Approval. Meta usually approves templates within 2 to 5 minutes. ⏱️

Billing & Payments

Manage your prepaid wallet, plan upgrades, and Meta conversation charges.

OneSender operates on a simple prepaid wallet system. You only pay for what you use.

  1. Go to Billing & Wallet from the bottom-left menu.
  2. You will see your Current Balance. Click "Add Funds".
  3. Enter the amount you wish to recharge.
  4. Complete the payment via UPI, Credit Card, or Netbanking securely.
  5. The balance will reflect in your wallet instantly! 💳

Unlike normal WhatsApp, the Cloud API charges per "Conversation" which lasts for 24 hours.

  • Marketing Conversations: Used for promotions and offers. (Highest cost)
  • Utility Conversations: Used for post-purchase updates, billing, etc. (Medium cost)
  • Service Conversations: When a user messages you first, and you reply. (Lowest cost)

Once a conversation is opened, you can send unlimited messages of that same category within the 24-hour window at no extra cost.

Troubleshooting & Safety

Message delivery failures, anti-ban guidelines, and API error codes.

To keep your number safe and maintain a High Quality rating (Green), follow these rules strictly:

  • Always get consent (Opt-in): Only message users who have permitted you to contact them.
  • Include a STOP button: Add an Opt-out/Stop Quick Reply button in your templates so uninterested users can stop receiving messages instead of reporting you.
  • Avoid Spam: Do not send too many promotional messages in a single week to the same user.
  • Monitor Quality: Check your Meta Quality rating regularly in the dashboard. If it drops to Red, pause your campaigns immediately. 🛑

Sometimes a message fails to deliver. Here are the most common reasons:

  • Number not on WhatsApp: The recipient does not have a registered WhatsApp account on that number.
  • User blocked you: The customer has blocked your business number.
  • Insufficient Wallet Balance: Your prepaid wallet ran out of funds during a campaign.
  • Invalid Template: You tried sending a template that was paused or rejected by Meta.

You can see the exact Error Code by hovering over the Failed status in your Campaign Analytics report.

Still need help?

Our support engineering team is available to assist you. Chat with us directly on WhatsApp.

Contact Support