From 56b0f8f582218259f9502c57dce4c32a832ccfaa Mon Sep 17 00:00:00 2001 From: isra el Date: Mon, 14 Apr 2025 07:11:06 +0300 Subject: [PATCH] feat(web): add quick start and use-cases pages --- web/app/(landing-page)/quickstart/page.tsx | 581 +++++++++++++++++++ web/app/(landing-page)/use-cases/page.tsx | 630 +++++++++++++++++++++ web/app/layout.tsx | 4 +- 3 files changed, 1213 insertions(+), 2 deletions(-) create mode 100644 web/app/(landing-page)/quickstart/page.tsx create mode 100644 web/app/(landing-page)/use-cases/page.tsx diff --git a/web/app/(landing-page)/quickstart/page.tsx b/web/app/(landing-page)/quickstart/page.tsx new file mode 100644 index 0000000..31c26b7 --- /dev/null +++ b/web/app/(landing-page)/quickstart/page.tsx @@ -0,0 +1,581 @@ +import { Metadata } from 'next' +import Link from 'next/link' +import { + CheckCircle2, + Smartphone, + MessageSquare, + Settings, + ArrowRightCircle, + Zap, + ExternalLink, + BookOpen, + Star, + SparkleIcon, +} from 'lucide-react' + +export const metadata: Metadata = { + title: 'TextBee Quickstart - Send SMS from Your Android Phone | SMS Gateway', + description: + 'Get started with TextBee SMS Gateway in minutes. Learn how to send and receive SMS messages using your Android phone as an SMS gateway for your applications.', + keywords: + 'SMS gateway, Android SMS, API SMS, TextBee quickstart, SMS integration, two-way SMS', +} + +export default function QuickstartPage() { + return ( +
+
+
+ + 5-minute setup +
+ +

+ TextBee SMS Gateway Quickstart +

+ +

+ Transform your Android phone into a powerful SMS gateway in just 5 + minutes. Send and receive text messages programmatically through your + applications with TextBee. +

+ +

+ Our platform enables businesses and developers to implement SMS + functionality without expensive telecom infrastructure. Perfect for + notifications, authentication, alerts, and customer engagement. +

+ +
+ + + Download App + + + + View Pro Plan + +
+
+ +
+
+ +
+ {[1, 2, 3, 4, 5].map((step) => ( +
+ + {step} + + + Step {step} + +
+ ))} +
+
+ +
+

+ The Simplest Way to Add SMS to Your Applications +

+

+ TextBee turns any Android phone into a reliable SMS gateway, allowing + you to send and receive text messages programmatically. Whether you're + building a notification system, implementing two-factor + authentication, or creating marketing campaigns, TextBee provides a + cost-effective solution without the need for complex telecom + integrations. +

+

+ Follow this step-by-step guide to set up TextBee and start sending + your first SMS messages in minutes. Our straightforward process + requires minimal technical knowledge and works with any application or + service that can make HTTP requests. +

+
+ +
+
+
+
+ 1 +
+

Account Setup

+
+ +
+

+ Begin by creating your TextBee account and installing the Android + app. This setup process takes less than 2 minutes and only + requires basic permissions to send and receive SMS messages. +

+ +
+
+
+ 1 + +
+

Create account

+

+ Register at{' '} + + textbee.dev + {' '} + with your email and password +

+
+ +
+
+ 2 + +
+

Install app

+

+ Download from{' '} + + dl.textbee.dev + {' '} + or Google Play Store +

+
+ +
+
+ 3 + +
+

Grant permissions

+

+ Allow SMS access in the app to enable message sending and + receiving +

+
+
+
+
+ +
+
+
+ 2 +
+

Connect Your Device

+
+ +
+

+ Link your Android phone to your TextBee account to establish the + SMS gateway connection. This secure connection allows your + applications to send messages through your phone. +

+ +
+
+
+

QR Code Method

+ + Recommended + +
+
    +
  1. Go to TextBee Dashboard
    2. +
  2. Click "Register Device"
    3. +
  3. Scan QR with app
    4. +
+
+ +
+

Manual Method

+
    +
  1. Generate API key from dashboard
    2. +
  2. Open TextBee app
    3. +
  3. Enter the API key
    4. +
+
+
+
+
+ +
+
+
+ 3 +
+

Send Your First SMS

+
+ +
+

+ Start sending SMS messages through TextBee using either our + intuitive dashboard or direct API integration. Both methods + provide reliable message delivery with delivery status tracking. +

+ +
+
+

+ Dashboard Method +

+
+
    +
  1. Go to "Send SMS" section
    2. +
  2. Enter recipient(s)
    3. +
  3. Type your message
    4. +
  4. Click "Send"
    5. +
+
+
+ +
+

+ API Method +

+ 
+                  
+                    {`fetch("https://api.textbee.dev/api/v1/gateway/devices/{ID}/send-sms", {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'x-api-key': API_KEY,
+  },
+  body: JSON.stringify({
+    recipients: ['+1234567890'],
+    message: 'Hello!'
+  })
+})`}
+                  
+
+
+
+ +

+ With TextBee, your messages are sent directly through your Android + device, using your existing mobile plan. This keeps costs low + while maintaining high deliverability rates across all carriers. +

+
+
+ +
+
+
+ 4 +
+

Receive SMS Messages

+
+ +
+

+ Enable two-way communication by configuring TextBee to forward + incoming SMS messages to your application. This is essential for + interactive workflows, verification codes, and customer + engagement. +

+ +
+
+

Enable in App

+
+
    +
  1. Open the TextBee App
    2. +
  2. Go to Settings
    3. +
  3. Toggle "Receive SMS" on
    4. +
+
+
+ +
+

+ Retrieve via API +

+ 
+                  
+                    {`fetch("https://api.textbee.dev/api/v1/gateway/devices/{ID}/get-received-sms", {
+  headers: { 'x-api-key': API_KEY }
+})`}
+                  
+
+
+
+ +

+ Received messages are securely forwarded to TextBee's servers and + can be accessed via the dashboard, API, or automatically sent to + your webhook endpoints for real-time processing. +

+
+
+ +
+
+
+ 5 +
+

Advanced Features

+
+ +
+

+ Once you've mastered the basics, explore TextBee's advanced + capabilities to enhance your SMS integration. These features help + scale your messaging operations and automate complex workflows. +

+ +
+
+
+ • +
+
+

Bulk SMS

+

+ Send to multiple recipients with a single API call for + efficient message broadcasting +

+
+
+
+
+ • +
+
+

Webhooks

+

+ Configure event-driven notifications for real-time updates + on message status +

+
+
+
+
+ • +
+
+

Multiple Devices

+

+ Connect several phones to increase throughput and add + redundancy +

+
+
+
+
+ • +
+
+

Self-hosting

+

+ Deploy TextBee on your own infrastructure for complete + control +

+
+
+
+ +
+
+
+ + Ready to explore more? +
+ + Use Cases + + +
+
+
+
+
+ +
+
+
+
+ +

TextBee Pro

+
+ +

+ Upgrade to TextBee Pro for enhanced features and priority support. +

+ +
+
+
+ + Unlimited devices and higher sending limits +
+
+ + Advanced analytics and delivery reporting +
+
+ + Message scheduling and template management +
+
+ +
+
+ + Priority support with faster response times +
+
+ + Custom webhooks for advanced integrations +
+
+ + White-labeled SMS for business applications +
+
+
+ +
+
+
+ $29 + /month +
+

+ Cancel anytime. No long-term contracts. +

+
+ + Upgrade to Pro + +
+
+
+ +
+

+ Why Choose TextBee SMS Gateway? +

+
+
+

+ Cost-Effective SMS Solution +

+

+ TextBee eliminates the need for expensive SMS API services or + telecom contracts. By using your existing phone and mobile plan, + you can send SMS messages at standard rates without additional + per-message fees from third-party providers. +

+ +

+ Easy Integration +

+

+ Our RESTful API makes integration simple for developers using any + programming language. TextBee works seamlessly with web + applications, mobile apps, and backend services through standard + HTTP requests. +

+
+ +
+

+ Perfect For +

+
    +
  • + + + + Two-factor authentication (2FA) + {' '} + - Secure user accounts with SMS verification codes + +
    • +
  • + + + Appointment reminders - + Reduce no-shows with automated SMS notifications + +
    • +
  • + + + Order updates - Keep + customers informed about their purchases + +
    • +
  • + + + Marketing campaigns - + Engage customers with promotional messages + +
    • +
  • + + + Alerts and notifications{' '} + - Send time-sensitive information instantly + +
    • +
+
+
+
+ +
+
+
+

Need help?

+

+ Our support team is ready to assist you +

+
+
+ + + Email + + + + Docs + +
+
+
+
+ ) +} diff --git a/web/app/(landing-page)/use-cases/page.tsx b/web/app/(landing-page)/use-cases/page.tsx new file mode 100644 index 0000000..f3a7350 --- /dev/null +++ b/web/app/(landing-page)/use-cases/page.tsx @@ -0,0 +1,630 @@ +import { Metadata } from 'next' +import { Card, CardContent } from '@/components/ui/card' +import Link from 'next/link' +import { + ShieldCheck, + ShoppingBag, + Calendar, + AlertTriangle, + Megaphone, + HeadsetIcon, + ExternalLink, + ArrowRight, +} from 'lucide-react' + +export const metadata: Metadata = { + title: 'Use Cases | TextBee', + description: + 'Explore various use cases and applications for TextBee SMS Gateway Platform', +} + +export default function UseCasesPage() { + return ( + <> +
+
+

+ TextBee Use Cases +

+

+ Discover how businesses and developers leverage TextBee SMS Gateway + for a wide variety of applications. Get inspired by these common use + cases and implementations. +

+
+ + + +
+
+
+ +
+
+ +
+

+ Two-factor Authentication (2FA) +

+
+ +

+ Enhance your application's security by implementing SMS-based + two-factor authentication. Add an extra layer of verification + to protect user accounts. +

+ +
+

+ Implementation Steps: +

+
    +
  1. Generate a random verification code for the user
    2. +
  2. Send the code via SMS using TextBee API
    3. +
  3. Verify the code entered by the user
    4. +
+
+ +
+
+ + JavaScript + + Example: +
+ 
+                    
+                      {`// Send 2FA code
+const verificationCode = generateRandomCode();
+await axios.post(\`https://api.textbee.dev/api/v1/gateway/devices/\${DEVICE_ID}/send-sms\`, {
+  recipients: [ user.phoneNumber ],
+  message: \`Your verification code is: \${verificationCode}\`
+}, {
+  headers: { 'x-api-key': API_KEY }
+});`}
+                    
+
+ +
+
+
+
+ +
+
+ +
+

+ Order Notifications +

+
+ +

+ Keep customers informed about their orders with real-time SMS + updates. Improve customer experience with timely notifications + throughout the order lifecycle. +

+ +
+
+

+ Order Confirmation +

+

+ Send details after purchase +

+
+
+

+ Shipping Updates +

+

+ Notify when order ships +

+
+
+

+ Delivery Status +

+

+ Alert when delivered +

+
+
+

Order Changes

+

+ Inform of modifications +

+
+
+ +
+
+ + JavaScript + + Example: +
+ 
+                    
+                      {`// Send order confirmation
+await axios.post(\`https://api.textbee.dev/api/v1/gateway/devices/\${DEVICE_ID}/send-sms\`, {
+  recipients: [ customer.phoneNumber ],
+  message: \`Order #\${orderNumber} confirmed! Expected delivery: \${deliveryDate}. Track at: \${trackingUrl}\`
+}, {
+  headers: { 'x-api-key': API_KEY }
+});`}
+                    
+
+ +
+
+ +
+
+ +
+
+ +
+

+ Appointment Reminders +

+
+ +

+ Reduce no-shows by sending automated appointment reminders to + clients. Perfect for medical practices, salons, consultants, + and service businesses. +

+ +
+

Key Features:

+
    +
  • Scheduled reminders (24h, 1h before appointments)
    • +
  • Interactive responses (reply to reschedule/cancel)
    • +
  • Calendar integration
    • +
+
+ +
+
+ + JavaScript + + Example: +
+ 
+                    
+                      {`// Schedule reminder job
+scheduler.scheduleJob(reminderTime, async () => {
+  await axios.post(\`https://api.textbee.dev/api/v1/gateway/devices/\${DEVICE_ID}/send-sms\`, {
+    recipients: [ appointment.phoneNumber ],
+    message: \`Reminder: Your appointment is tomorrow at \${appointment.time}. Reply CONFIRM to confirm or RESCHEDULE to change.\`
+  }, {
+    headers: { 'x-api-key': API_KEY }
+  });
+});`}
+                    
+
+ +
+
+ +
+
+ +
+
+ +
+

+ Emergency Alerts +

+
+ +

+ Send critical notifications and emergency alerts to large + groups of people quickly. Perfect for natural disasters, + emergencies, and critical business communications. +

+ +
+

Applications:

+
    +
  • Weather emergencies
    • +
  • Campus/school alerts
    • +
  • IT system outages
    • +
  • Critical business communications
    • +
+
+ +
+
+ + JavaScript + + Example: +
+ 
+                    
+                      {`// Send bulk emergency alert
+const recipients = await getUserPhoneNumbers(affectedRegion);
+await axios.post(\`https://api.textbee.dev/api/v1/gateway/devices/\${DEVICE_ID}/send-bulk-sms\`, {
+  messageTemplate: \`ALERT: \${emergencyMessage}. Stay safe.\`,
+  messages: [{
+    recipients: recipients,
+  }]
+}, {
+  headers: { 'x-api-key': API_KEY }
+});`}
+                    
+
+ +
+
+ +
+
+ +
+
+ +
+

+ Marketing Campaigns +

+
+ +

+ Run targeted SMS marketing campaigns to engage customers and + drive sales. Perfect for promotions, event announcements, and + customer surveys. +

+ +
+

+ Campaign Types: +

+
    +
  • Promotional offers and discounts
    • +
  • New product announcements
    • +
  • Event invitations
    • +
  • Customer surveys
    • +
+
+ +
+

+ Note: Always ensure you have proper consent + and comply with SMS marketing regulations in your region. +

+
+
+ +
+
+ +
+
+ +
+

+ Customer Support +

+
+ +

+ Provide customer support through two-way SMS communication. + Perfect for handling customer inquiries and feedback. +

+ +
+

+ Implementation Steps: +

+
    +
  1. Configure webhook for incoming SMS
    2. +
  2. Process and route messages to support agents
    3. +
  3. Send automated responses for common queries
    4. +
  4. Track conversation history
    5. +
+
+ +
+
+ + JavaScript + + Example: +
+ 
+                    
+                      {`// Check for new messages
+const messages = await axios.get(
+  \`https://api.textbee.dev/api/v1/gateway/devices/\${DEVICE_ID}/get-received-sms\`,
+  { headers: { 'x-api-key': API_KEY } }
+);
+
+// Process and respond to messages
+for (const msg of messages.data) {
+  const response = await generateSupportResponse(msg.message);
+  await sendReply(msg.sender, response);
+}`}
+                    
+
+ +
+
+
+ +
+
+
+ +
+

+ Custom Integrations +

+
+ +

+ TextBee can be integrated with various platforms and services. + Our REST API allows you to create custom integrations for almost + any application, automating SMS sending and receiving based on + triggers in your existing systems. +

+ +
+
+
+ + + + + + +
+

CRM Systems

+

+ Connect SMS messaging with customer records +

+
+ +
+
+ + + + + + + + + + + + +
+

Booking Software

+

+ Automate appointment confirmations +

+
+ +
+
+ + + + + +
+

E-commerce

+

+ Send order & shipping updates +

+
+ +
+
+ + + + + + +
+

Automation Tools

+

+ Integrate with Zapier, IFTTT, etc. +

+
+
+ +
+
+

Webhooks Support

+

+ Configure webhooks to receive notifications when SMS events + occur. Perfect for event-driven architectures and real-time + applications. +

+
+ POST + https://your-server.com/webhook?event=sms_received&sender=+1234567890 +
+
+ +
+

+ API Documentation +

+

+ Our comprehensive API documentation provides all the details + you need to integrate TextBee with your applications and + services. +

+ + View API Documentation + + +
+
+
+ +
+
+
+

+ Ready to implement these use cases? +

+

+ Follow our step-by-step quickstart guide to set up TextBee + and start sending SMS messages in minutes. Whether you're + implementing 2FA, appointment reminders, or complex + integrations, we've got you covered. +

+
+
+ + Quickstart Guide + + + + Contact Support + +
+
+
+ + +
+ + ) +} diff --git a/web/app/layout.tsx b/web/app/layout.tsx index 70cf3d1..70b2423 100644 --- a/web/app/layout.tsx +++ b/web/app/layout.tsx @@ -13,7 +13,7 @@ import prismaClient from '@/lib/prismaClient' import { userAgent } from 'next/server' export const metadata: Metadata = { - title: 'textbee.dev - Free and Open-Source SMS Gateway', + title: 'textbee.dev - sms gateway', description: 'TextBee is an open-source solution that turns your Android device into a powerful SMS gateway. Send SMS effortlessly through your applications.', authors: [ @@ -51,7 +51,7 @@ export const metadata: Metadata = { canonical: 'https://textbee.dev', }, openGraph: { - title: 'textbee.dev - Free and Open-Source SMS Gateway', + title: 'textbee.dev - sms gateway', description: 'TextBee is an open-source solution that turns your Android device into a powerful SMS gateway. Send SMS effortlessly through your applications.', },