ceesend ceesend.

Docs & Guides

Comprehensive step-by-step walkthroughs, Ghana telecom compliance rules, spreadsheet mapping, and API integration.

Showing matching guides

Getting Started

Everything you need to create your account, claim 5 free credits, and complete basic verification.

How to Sign Up & Claim 5 Free SMS Credits

2 min read
1

Go to the Registration page and enter your name, email, phone number, and a secure password.

2

Verify your email address using the 6-digit confirmation code sent to your inbox.

3

Verify your Ghana mobile number via SMS OTP.

4

Your wallet will automatically be credited with 5 free test SMS credits right on your dashboard.

Dashboard Overview & Free Credits Balance
ceesend UI
Dashboard Overview & Free Credits Balance

Dashboard topbar displaying wallet balance (5 Credits) and Quick Send action button

Screenshot: Welcome dashboard with 5 free test credits credited upon account verification.
Tip: You can immediately test sending an SMS to your own phone using the default CEESEND Sender ID without any setup delays.

Managing Workspaces & Inviting Team Members

3 min read
1

Navigate to Settings → Workspace in your dashboard.

2

Update your organization name, upload your brand logo, and customize your timezone.

3

Click on "Members" tab and enter your teammate's email address with their assigned role (Admin or Member).

4

Your invited team member receives an email invitation link to join your workspace wallet and shared contact lists.

Workspace Team Management & Role Assignment
ceesend UI
Workspace Team Management & Role Assignment

Workspace members list showing invite modal, member emails, and role selectors

Screenshot: Workspace settings tab showing team member invitations and permission roles.
Tip: Workspace members share the same SMS credit pool and approved Sender IDs, making it easy to collaborate across marketing and customer support teams.

Sender ID Registration

NCA regulatory guidelines, requesting custom 11-character alphanumeric sender masks, and approval timelines.

How Sender IDs Work & NCA Compliance in Ghana

3 min read
1

Understand the 11-Character Limit: Custom Sender IDs can be up to 11 alphanumeric characters (e.g., MYBRAND, CHURCHNAME, STOREGH). Spaces and symbols count towards the 11 characters.

2

Instant Default Sender ID: You do not have to wait for telecom approval to send urgent messages—all accounts have immediate access to our pre-approved "CEESEND" default sender mask.

3

Apply in Settings: Go to Settings → Sender IDs tab and click "Request Sender ID".

4

Provide Organization Details: Enter your desired 11-character name and select the purpose (Business, Church, School, NGO, etc.).

5

Telecom Approval: In accordance with National Communications Authority (NCA) anti-spoofing policies across MTN, Telecel, and AT, approval takes 24 to 48 business hours.

Custom Sender ID Request Modal
ceesend UI
Custom Sender ID Request Modal

Sender ID modal with 11-character counter, organization type dropdown, and submission status

Screenshot: Requesting a custom 11-character alphanumeric Sender ID in Settings → Sender IDs.
Tip: Generic or deceptive names (such as "BANK", "PAYMENT", "URGENT") are strictly prohibited by telecom regulators. Always use your registered trade or organization name.

Why Can't Recipients Reply Directly to a Sender ID?

2 min read
1

Alphanumeric Sender IDs (names rather than numbers) are broadcast across carrier routes as one-way A2P (Application-to-Person) messages.

2

Handsets cannot send an SMS reply to a word/text mask.

3

To collect recipient replies or calls, always include a call-to-action in your message body (e.g., "Call us on 0273060002" or "Reply via WhatsApp: wa.me/233273060002").

Simulated Recipient Phone Message View
ceesend UI
Simulated Recipient Phone Message View

Handset SMS preview illustrating custom alphanumeric header and call-to-action link

Screenshot: Mobile handset rendering a one-way A2P message with branded Sender ID header.
Tip: Include your opt-out contact info in promotional campaigns to comply with Ghanaian consumer privacy regulations.

Sending SMS & Campaigns

Composing broadcasts, personalizing templates with tags, understanding SMS length/segments, and scheduling.

Quick Send vs. Full Bulk Campaigns

3 min read
1

Quick Send (Header Button): Perfect for single recipients or small groups up to 50 numbers. Type numbers directly or paste from clipboard and send in under 5 seconds.

2

Bulk Campaigns (Campaigns → New Campaign): Ideal for large customer lists, scheduled dispatches, AI-generated copy, and variable personalization.

3

Select Recipients: Choose between all contacts, specific Contact Lists, or upload a fresh CSV / Excel sheet.

4

Schedule Delivery: Choose "Send Now" for immediate routing or select a future date and time for scheduled event reminders.

Campaign Composer & Live Character Counter
ceesend UI
Campaign Composer & Live Character Counter

Campaign creation interface showing message editor, dynamic tag pills, and instant cost summary

Screenshot: Campaign creation wizard with contact group selector, dynamic tags, and scheduler.
Tip: Scheduled campaigns run automatically on our cloud servers even if you log out or your device goes offline.

SMS Character Limits & Segment Billing Explained

4 min read
1

Standard English SMS (GSM-7): 1 SMS credit = up to 160 characters. If your message is 161–306 characters, telecom carriers concatenate it into 2 SMS segments (153 characters per segment due to routing headers).

2

Unicode Characters (Emojis / Special Glyphs): If your message contains emojis (😊, 🔥) or special unicode symbols, the limit drops to 70 characters for the 1st segment and 67 characters for subsequent segments.

3

Real-Time Live Counter: The ceesend message editor displays the exact character count, total segments, and required credits in real time as you type.

Live SMS Character & Segment Counter
ceesend UI
Live SMS Character & Segment Counter

Real-time message counter bar showing character count (e.g. 142/160), segments (1 SMS), and credit cost

Screenshot: Live character counter indicating GSM-7 vs Unicode detection and segment breakdown.
Tip: To maximize your budget, stick to standard GSM characters and avoid unnecessary emojis in large-scale marketing blasts.

How to Personalize Bulk Messages (e.g. "Hello Kwame")

3 min read
1

When composing a campaign, click on the dynamic variable tags buttons above the message box.

2

Insert {{ name }} to insert the recipient's first name or company name from your contact list.

3

Use {{ custom1 }}, {{ custom2 }}, or dynamic spreadsheet column headers (e.g., {{ amount_due }}, {{ ticket_id }}) for billing notices, fee reminders, or custom alerts.

4

Review the live preview on the right to see how individual messages will render before hitting dispatch.

Dynamic Placeholder Tags & Live Handset Preview
ceesend UI
Dynamic Placeholder Tags & Live Handset Preview

Editor with dynamic variable tags toolbar and live rendered smartphone preview side-by-side

Screenshot: Inserting dynamic tags like {{ name }} and previewing recipient personalization.
Tip: Messages personalized with the recipient's first name achieve up to 4x higher customer response rates in Ghana.

Contacts & Smart AI Import

Importing from Excel & CSV, automatic Ghana number formatting (+233/02x/05x), and AI smart extraction.

Importing Contacts from Excel (.xlsx), CSV, and VCF files

3 min read
1

Go to Contacts → Import Contacts in your dashboard.

2

Drag and drop your .xlsx, .csv, or .vcf phonebook file.

3

Map your spreadsheet columns to Name, Phone Number, and custom tags.

4

Assign contacts directly into a new or existing Contact List (e.g., "VIP Customers", "Sunday Congregation", "Staff").

5

Automatic Sanitization: ceesend automatically strips out invalid spaces, fixes missing leading zeroes, and converts numbers to Ghana international format (e.g., 0244123456 → 233244123456).

Excel & CSV Contact Column Mapping
ceesend UI
Excel & CSV Contact Column Mapping

Import modal with file dropzone, column matching selectors (Name, Phone, Tag), and list picker

Screenshot: Drag-and-drop spreadsheet import with automatic column detection and number sanitizer.
Tip: Duplicate numbers in the same import file are automatically merged so you never pay twice for the same contact.

Using the AI Smart Extractor for Messy Text & WhatsApp Lists

2 min read
1

Have an unformatted WhatsApp group chat log, messy email list, or handwritten notes with names and numbers jumbled together?

2

Go to Contacts → AI Smart Extractor.

3

Paste the entire raw text into the extractor window or upload a document.

4

Our AI automatically detects names, phone numbers, and company affiliations, cleaning them into a structured contact list ready for 1-click import.

AI Smart Text & Contact Extractor
ceesend UI
AI Smart Text & Contact Extractor

AI extractor input box on left with parsed clean table with names and sanitized numbers on right

Screenshot: AI parser transforming unformatted WhatsApp chat text into sanitized contacts.
Tip: The AI extractor can parse thousands of messy contact entries in seconds without requiring manual spreadsheet formatting.

Handling Opt-Outs & Do-Not-Disturb (Blacklist)

2 min read
1

If a customer requests to unsubscribe from promotional broadcasts, search for their record under Contacts.

2

Click the Blacklist toggle next to their name.

3

Blacklisted contacts are immediately blocked by the system from receiving future promotional campaigns, protecting your sender reputation.

Contact Blacklist & Opt-Out Status Toggle
ceesend UI
Contact Blacklist & Opt-Out Status Toggle

Contact table with DND / Blacklist status pill, search filter, and individual blacklist toggle switch

Screenshot: Contacts table showing active vs blacklisted status indicators and bulk actions.
Tip: Blacklisting keeps the contact record in your database for audit history while guaranteeing no further automated marketing SMS are dispatched to that phone.

Billing & Mobile Money

Lifetime non-expiring credits vs commitment bundles, MoMo payment steps, and loyalty points.

How to Top Up Credits with MTN MoMo, Telecel Cash & AT Money

2 min read
1

Go to Billing in your dashboard navigation.

2

Select your preferred package: Lifetime Non-Expiring bundle (never expires) or high-volume Discounted Commitment plan.

3

Click "Purchase Credits" to open the secure Paystack checkout.

4

Select Mobile Money, enter your Ghana phone number, and choose your network (MTN, Telecel, or AT).

5

Approve the authorization prompt (USSD push prompt) on your mobile phone and enter your MoMo PIN.

6

Your ceesend SMS credits are added to your wallet balance instantly within 3 seconds of approval.

Credit Package Selection & Paystack MoMo Checkout
ceesend UI
Credit Package Selection & Paystack MoMo Checkout

Billing pricing grid with bundle cards, price per SMS indicator, and Paystack MoMo dialog

Screenshot: Credit package selection cards and instant Mobile Money USSD payment popup.
Tip: Need a custom volume exceeding 100,000 SMS? Use the Custom Package builder or contact our enterprise desk for tailored pricing.

Earning and Redeeming Reward Points for Free Credits

2 min read
1

Earn Points Automatically: Earn reward points on every credit purchase, onboarding milestone, and active campaign broadcast.

2

View Balance: Check your current point balance under Points in your dashboard.

3

Redeem Instantly: Click "Redeem Points" to convert accumulated points into free SMS credits deposited directly to your wallet.

Loyalty Points Hub & 1-Click Credit Redemption
ceesend UI
Loyalty Points Hub & 1-Click Credit Redemption

Loyalty points overview card with points balance, conversion rate, and 1-click redeem button

Screenshot: Points dashboard showing accumulated reward balance and instant SMS redemption.
Tip: Points do not expire and can be redeemed whenever you need extra message credits.

Reports & Troubleshooting

Real-time handset delivery logs, error code breakdowns, and resolving common carrier delivery issues.

Understanding Delivery Statuses (Delivered, Sent, Undelivered, Failed)

3 min read
1

Delivered (Green): The telecom carrier confirmed receipt and the message successfully landed on the recipient's handset screen/inbox.

2

Sent / Buffered (Blue): The message was accepted by the telecom operator gateway and is currently in transit to the handset.

3

Undelivered (Orange): The recipient's phone was switched off, out of network coverage, or the inbox was full for an extended duration.

4

Failed (Red): The phone number does not exist, has been permanently deactivated by the carrier, or was rejected due to network barrings.

Real-Time Delivery Logs & Network Error Codes
ceesend UI
Real-Time Delivery Logs & Network Error Codes

Detailed logs table with recipient numbers, telecom network (MTN, Telecel, AT), status badges, and timestamp

Screenshot: Reports & Delivery Logs table showing carrier delivery receipts and CSV export.
Tip: Navigate to Reports → Delivery Logs to inspect handset timestamps, operator error codes, and download CSV export receipts.

Why Did a Message Fail or Show as Undelivered?

3 min read
1

Invalid Phone Number Format: Ensure numbers are valid 10-digit Ghana numbers (e.g., 0244123456) or international format (233244123456). ceesend automatically sanitizes uploaded contacts.

2

Recipient Handset Switched Off: Mobile carriers hold messages in queue for a retry window (usually 24 to 48 hours). If the handset is not turned on before the window expires, the status changes to Undelivered.

3

Spam Keyword Triggers: Avoid misleading financial terms or prohibited words that telecom carrier firewalls may filter.

Campaign Analytics Summary & Carrier Breakdown
ceesend UI
Campaign Analytics Summary & Carrier Breakdown

Performance analytics pie chart and bar graph breaking down delivery percentages across MTN, Telecel, and AT

Screenshot: Delivery performance chart highlighting successful delivery rates by network.
Tip: If you experience abnormal delivery rates to a specific network, reach out to our 24/7 support line on WhatsApp for real-time route diagnostics.

Developer REST API

Send SMS programmatically via REST API, generate Bearer tokens, and handle Webhook DLR callbacks.

API Authentication & Quickstart

4 min read
1

Generate an API Token: In your dashboard, navigate to Settings → API Tokens. Click "Create Token", give it a recognizable label, and copy the Bearer token.

2

Endpoint URL: Send HTTP POST requests to https://ceesend.com/api/v1/sms/send with Header "Authorization: Bearer YOUR_API_TOKEN".

3

Payload Format: Provide JSON with "sender_id", "recipients" (array of phone numbers), and "message".

4

Instant JSON Response: The gateway responds with message IDs, cost breakdown, and status in under 200ms.

API Token Generator & Key Management
ceesend UI
API Token Generator & Key Management

API tokens manager showing created keys, token creation modal, and webhook secret endpoint settings

Screenshot: Generating secure API Bearer tokens in Settings → API Tokens.
Tip: Never expose your secret API token in client-side mobile or web code. Always dispatch API calls from your secure backend server.

Configuring Webhooks for Real-Time Delivery Receipts (DLR)

3 min read
1

Go to Settings → Workspace in your dashboard.

2

Enter your secure HTTPS webhook endpoint URL in the "Webhook URL" field.

3

Whenever carrier delivery statuses change (e.g. from Sent to Delivered or Failed), ceesend posts a signed JSON payload with the message_id, recipient, and handset status to your server.

Webhook URL & Secret Key Configuration
ceesend UI
Webhook URL & Secret Key Configuration

Webhook endpoint configuration input box with secret verification key and event dispatch logs

Screenshot: Configuring real-time webhook callback endpoints in Workspace Settings.
Tip: Verify incoming webhook signatures using your workspace secret key to guarantee payload integrity.

Developer REST API

Integrate high-throughput SMS dispatch into your PHP, Node.js, Python, or Laravel application with Bearer authentication.

Send SMS (POST /api/v1/sms/send)

Get API Key →
curl -X POST https://ceesend.com/api/v1/sms/send \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": "CEESEND",
    "recipients": ["233244123456", "233201987654"],
    "message": "Hello! Your verification code is 849201. Valid for 10 minutes."
  }'
<?php
$ch = curl_init('https://ceesend.com/api/v1/sms/send');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'sender_id' => 'CEESEND',
    'recipients' => ['233244123456'],
    'message' => 'Hello! Your order #5920 has been dispatched.'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);
import axios from 'axios';

const response = await axios.post('https://ceesend.com/api/v1/sms/send', {
  sender_id: 'CEESEND',
  recipients: ['233244123456'],
  message: 'Hello! Your payment of GHS 150.00 was received.'
}, {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.data);
import requests

url = "https://ceesend.com/api/v1/sms/send"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
payload = {
    "sender_id": "CEESEND",
    "recipients": ["233244123456"],
    "message": "Your booking is confirmed for Saturday at 2:00 PM."
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Frequently Asked Questions

Common answers about sender ID approval, MoMo payment delays, and credit limits.

Instantly! You do not need to wait for sender ID or document approvals to test the platform. Every new account receives 5 free test credits and instant access to our pre-approved default Sender ID (CEESEND). You can send a live SMS to any Ghana mobile number right away.

Custom 11-character alphanumeric Sender IDs (e.g., your business name, church, or school) are approved within 24 to 48 business hours in accordance with National Communications Authority (NCA) regulations across MTN, Telecel, and AT networks. While waiting for approval, you can continue sending messages with the default CEESEND mask.

No! Standard Lifetime SMS bundles never expire. You can purchase credits today and use them whenever you need. We also offer discounted commitment plans (Monthly, Quarterly, Annual) for high-volume senders looking for wholesale rates.

Simply go to Billing, select your desired credit bundle, and choose Mobile Money. Enter your phone number and confirm the USSD prompt that appears on your phone. Credits are added to your wallet automatically in 2 to 3 seconds.

ceesend provides direct high-throughput SMS routing to all mobile networks in Ghana including MTN Ghana, Telecel Ghana (formerly Vodafone), and AT (AirtelTigo), with 99.4%+ handset delivery rates.

When composing a campaign, you can insert tags such as {{ name }} or {{ custom1 }}. When sending, our system dynamically replaces the tag with each recipient's specific data from your contact list or uploaded Excel sheet.

Yes. On the campaign creation page, switch the dispatch mode from "Send Now" to "Schedule for Later", pick your target date and time, and our cloud infrastructure will handle the automated dispatch at that exact minute.

Yes! ceesend offers a developer-friendly REST API for single SMS, bulk dispatch, balance inquiries, and real-time webhook delivery notifications. You can generate API keys directly in Settings → API Tokens.

Still need help?

Our support engineers in Accra are available to assist with high-volume accounts, custom telecom routing, and spreadsheet formatting.