Live Kenya Events - User Guide

Table of Contents

1. Overview
2. Getting Started
3. Web Application User Guide
4. Quick Checkout Process
5. Event Organizer Guide
6. Telegram Chatbot
7. WhatsApp Chatbot
8. Group Tickets & Multi-Ticket Purchases
9. SMS Notifications
10. Agent Invitation & QR Scanning System
11. Payment Methods
12. Troubleshooting

---

Overview

Live Kenya Events is a comprehensive event ticketing platform that allows users to discover, purchase, and manage event tickets through multiple channels. The platform supports web-based ticket purchases, chatbot integrations (Telegram and WhatsApp), mobile payments (M-Pesa and cards), and includes advanced features like agent-based ticket scanning and group ticket management.

Key Features

• Multi-Channel Access: Web, Telegram, WhatsApp
• Flexible Payments: M-Pesa, Credit/Debit Cards, Bank Transfers
• Group Tickets: Purchase multiple tickets in one transaction
• SMS Notifications: Automatic confirmations for all purchases
• QR Code Scanning: Agent-based ticket validation at events
• Event Management: Complete organizer dashboard
• Free Events: Instant ticket delivery for zero-cost events

---

Getting Started

Creating an Account

Web Registration

1. Visit the Live Kenya Events website
2. Click Sign Up in the top navigation
3. Fill in your details:
   • Name: Your full name
   • Email: Valid email address
   • Phone: Kenyan phone number (07XX XXX XXX or +254 7XX XXX XXX)
   • Password: Secure password
4. Click Create Account
5. Check your email for confirmation link
6. Click the confirmation link to activate your account

Google Sign-In

1. Click Sign in with Google on the login page
2. Select your Google account
3. Grant necessary permissions
4. Your account will be created automatically

Account Types

• Regular User: Browse and purchase tickets
• Event Organizer: Create and manage events
• Agent: Scan tickets at events (by invitation only)

---

Web Application User Guide

Browsing Events

Event Discovery

1. Homepage: View featured and upcoming events
2. Search: Use the search bar to find specific events
3. Categories: Filter events by type or category
4. Date Filter: Find events by specific dates

Event Details

Each event page displays:

• Event Information: Title, description, date, time, location
• Venue Details: Address and capacity information
• Ticket Types: Available ticket categories and prices
• Event Image: Visual representation of the event
• Organizer Information: Event organizer details

Purchasing Tickets

Adding Tickets to Cart

1. Select the event you want to attend
2. Choose ticket type (VIP, General Admission, etc.)
3. Select quantity using the +/- buttons
4. Click Add to Cart
5. Continue shopping or proceed to checkout

Cart Management

• View Cart: Click the cart icon to see selected tickets
• Modify Quantities: Adjust ticket numbers in the cart
• Remove Items: Delete unwanted tickets
• Total Calculation: Automatic price calculation including any fees

Checkout Process

For Registered Users

1. Review your cart contents
2. Verify your contact information
3. Click Proceed to Payment
4. Choose payment method (M-Pesa, Card, Bank Transfer)
5. Complete payment through Paystack
6. Receive confirmation email and SMS

For Guest Users

1. Review cart contents
2. Fill in contact information:
   • Name: Full name for ticket
   • Email: For ticket delivery
   • Phone: For SMS notifications
3. Click Proceed to Payment
4. Complete payment process
5. Receive tickets via email and SMS confirmation

---

Quick Checkout Process

The quick checkout feature allows for streamlined ticket purchases with minimal steps.

How Quick Checkout Works

Accessing Quick Checkout

• Available for specific events with simplified purchasing
• Accessed through direct links or promotional campaigns
• Bypasses traditional cart system for faster transactions

Quick Checkout Steps

1. Event Selection: Choose from available quick checkout events
2. Ticket Selection: Select ticket type and quantity
3. Contact Information: Provide name, email, and phone
4. Instant Payment: Direct to payment gateway
5. Immediate Confirmation: Instant ticket delivery

Benefits

• Speed: Reduced checkout time
• Simplicity: Fewer steps to complete purchase
• Mobile Optimized: Perfect for mobile users
• Conversion: Higher completion rates

---

Event Organizer Guide

Getting Started as an Organizer

Account Setup

1. Register for a regular account
2. Contact support to upgrade to organizer status
3. Complete KYC verification (for paid events):
   • KRA PIN: Tax identification number
   • CR12 Document: Business registration certificate
4. Set up payment information for revenue collection

Creating Events

Event Creation Process

1. Access Dashboard: Go to My Events in your account
2. Create New Event: Click Create Event button

3. Basic Information:

   • Event Title: Clear, descriptive name
   • Description: Detailed event information
   • Category: Select appropriate event type
   • Tags: Keywords for searchability

4. Date & Time:

   • Start Date: Event date
   • Start Time: Event start time
   • End Date/Time: Optional event end time
   • Timezone: Automatic Kenya timezone

5. Location Details:

   • Venue Name: Event location name
   • Address: Complete venue address
   • City: Event city
   • Capacity: Maximum attendees (optional)

6. Ticket Configuration:

   • Ticket Types: Create multiple ticket categories
   • Pricing: Set prices (can be free)
   • Quantity: Available tickets per type
   • Sales Period: When tickets go on sale

7. Event Image: Upload promotional image

8. Additional Settings:

   • Public/Private: Event visibility
   • Registration Required: Attendee information collection

Event Management

Dashboard Overview

• Event Statistics: Ticket sales, revenue, attendance
• Recent Activity: Latest ticket purchases and registrations
• Quick Actions: Edit event, view tickets, manage agents

Ticket Management

• Sales Tracking: Real-time sales monitoring
• Attendee Lists: Download attendee information
• Ticket Types: Modify pricing and availability
• Sales Reports: Detailed sales analytics

Revenue Management

• Payment Tracking: Monitor incoming payments
• Paystack Integration: Automatic payment processing
• Revenue Reports: Financial summaries and exports
• Payout Information: Payment settlement details

Agent Management

Inviting Agents

1. Access Agent Management: From event dashboard
2. Invite New Agent: Click Invite Agent
3. Agent Information:
   • Email: Agent's email address
   • Role: Scanning permissions
4. Send Invitation: Agent receives email invitation
5. Track Status: Monitor invitation acceptance

Agent Permissions

• Ticket Scanning: QR code validation
• Admission Control: Check-in attendees
• Event Access: Limited to assigned events only
• Statistics: View scanning performance

---

Telegram Chatbot

Getting Started with Telegram Bot

Finding the Bot

1. Open Telegram app
2. Search for Live Kenya Events Bot or use the bot username
3. Start a conversation by clicking Start
4. The bot will greet you and show available commands

Bot Commands

Basic Commands

• /start - Initialize bot and show welcome message
• /help - Display all available commands
• /events - Browse upcoming events
• /mytickets - View your purchased tickets
• /account - Manage account settings

Event Discovery

• /search [keyword] - Search for specific events
• /category [type] - Filter events by category
• /today - Show events happening today
• /weekend - Display weekend events

Purchasing Tickets via Telegram

Step-by-Step Process

1. Browse Events: Use /events to see available events
2. Select Event: Click on event button or use event ID
3. Choose Tickets: Select ticket type and quantity
4. Provide Information:
   • Name for ticket
   • Phone number for SMS
   • Email for ticket delivery
5. Payment: Receive Paystack payment link
6. Confirmation: Get ticket confirmation in chat

Payment Integration

• Secure Links: Paystack-generated payment URLs
• Multiple Methods: M-Pesa, cards, bank transfers
• Real-time Updates: Payment status in chat
• Ticket Delivery: PDF tickets sent to email and Telegram

Advanced Features

Account Linking

• Link Telegram account to web account for seamless experience
• Access purchase history across platforms
• Sync preferences and saved information

Notifications

• Event Reminders: Automatic event notifications
• Payment Confirmations: Instant payment updates
• Ticket Updates: Changes to event details
• Promotional Messages: Special offers and new events

---

WhatsApp Chatbot

Accessing WhatsApp Bot

Getting Started

1. Find Bot Number: Get WhatsApp bot number from website
2. Add Contact: Save the bot number to your contacts
3. Start Conversation: Send Hi or Start to begin
4. Menu Navigation: Use number options or keywords

WhatsApp Bot Features

Interactive Menu System

• Main Menu: Numbered options for easy navigation
• Event Browsing: Scroll through available events
• Quick Actions: Fast access to common tasks
• Help System: Built-in assistance and FAQs

Ticket Purchasing

Purchase Flow

1. Event Selection: Choose from event list
2. Ticket Configuration: Select type and quantity
3. Contact Details: Provide required information
4. Payment Link: Receive secure payment URL
5. Confirmation: Get purchase confirmation via WhatsApp

WhatsApp-Specific Features

• Image Sharing: Event images and QR codes
• Document Delivery: PDF tickets via WhatsApp
• Voice Messages: Audio confirmations and updates
• Status Updates: Real-time purchase progress

Message Types

Text Commands

• Events - Show upcoming events
• My Tickets - Display purchased tickets
• Help - Get assistance
• Account - Account management options

Interactive Buttons

• Quick reply buttons for common actions
• Event selection buttons
• Payment confirmation buttons
• Menu navigation buttons

---

Group Tickets & Multi-Ticket Purchases

Understanding Group Tickets

What are Group Tickets?

Group tickets allow you to purchase multiple tickets in a single transaction, perfect for:

• Family Outings: Parents buying for children
• Friend Groups: Coordinating group attendance
• Corporate Events: Company team building
• Bulk Purchases: Large quantity discounts

Purchasing Multiple Tickets

Web Application Process

1. Select Event: Choose your desired event
2. Multiple Ticket Types: Add different ticket categories
3. Quantity Selection: Use +/- buttons for each type
4. Group Information: Provide details for each attendee (optional)
5. Single Payment: One transaction for all tickets
6. Consolidated Delivery: All tickets in one email

Chatbot Group Purchases

1. Event Selection: Choose event via bot
2. Quantity Specification: Specify total number of tickets
3. Ticket Distribution: Indicate different ticket types if needed
4. Contact Information: Primary contact for the group
5. Payment: Single payment link for entire group
6. Distribution: Tickets delivered to group organizer

Group Ticket Benefits

Consolidated Experience

• Single Transaction: One payment for multiple tickets
• Unified Confirmation: One email with all tickets
• Group SMS: Single SMS notification for purchase
• Easier Management: All tickets in one place

Cost Efficiency

• Reduced Fees: Lower transaction costs per ticket
• Group Discounts: Potential bulk pricing (event-dependent)
• Simplified Accounting: One receipt for multiple tickets

Managing Group Tickets

Ticket Distribution

• PDF Attachments: Individual tickets in single email
• QR Codes: Unique codes for each ticket
• Attendee Information: Names on individual tickets
• Transfer Options: Forward individual tickets to group members

Event Day Coordination

• Group Check-in: Streamlined entry process
• Agent Scanning: Each ticket scanned individually
• Attendance Tracking: Individual ticket validation
• Group Seating: Coordinated seating arrangements (if applicable)

---

SMS Notifications

SMS Notification System

Automatic SMS Delivery

Live Kenya Events automatically sends SMS notifications for all successful ticket purchases, ensuring customers receive immediate confirmation regardless of their purchase channel.

SMS Providers

The platform uses a dual-provider system for reliable delivery:

• Primary: Africa's Talking SMS
• Fallback: Advanta SMS (automatic retry if primary fails)

SMS Content & Format

Single Ticket Purchase

Your ticket for 'Event Name' has been confirmed. 
Total: KES 1,500
Ref: #ABC123DEF
Check your email for tickets.
Event: Aug 15, 2025 at 7:00 PM
Venue: Carnivore Grounds

Multiple Tickets (Same Event)

Your 3 tickets for 'Music Festival 2025' have been confirmed.
Total: KES 4,500
Ref: #XYZ789ABC
Check your email for all tickets.
Event: Aug 20, 2025 at 6:00 PM
Venue: Uhuru Gardens

Multiple Tickets (Different Events)

Your 5 tickets for 2 events have been confirmed.
Total: KES 7,200
Ref: #DEF456GHI
Check your email for all tickets.
Events include: Concert Night, Comedy Show

Free Event Tickets

Your free tickets for 'Community Workshop' have been confirmed.
Ref: #FREE123ABC
Check your email for tickets.
Event: Aug 25, 2025 at 2:00 PM
Venue: Community Center

SMS Delivery Features

Intelligent Retry System

• Blacklist Detection: Automatically detects if number is blacklisted on primary provider
• Provider Switching: Seamlessly switches to backup provider
• Delivery Confirmation: Tracks successful delivery across providers
• Error Handling: Comprehensive error logging and reporting

Phone Number Support

• Kenyan Numbers: Optimized for Kenyan phone formats
• Format Flexibility: Accepts various input formats:
  • 0722000000 (10 digits)
  • 722000000 (9 digits)
  • +254722000000 (international)
  • 254722000000 (country code)

Delivery Timing

• Immediate: SMS sent within seconds of payment confirmation
• Consolidated: For multi-ticket purchases, one SMS per payment reference
• Reliable: Multiple delivery attempts with fallback providers

SMS Notification Channels

Web Purchases

• SMS sent after successful Paystack payment
• Includes payment reference and ticket details
• Links to email for full ticket download

Chatbot Purchases

• Telegram: SMS + in-app notification
• WhatsApp: SMS + WhatsApp message confirmation
• Consistent messaging across all channels

Quick Checkout

• Immediate SMS for streamlined purchases
• Simplified message format for quick transactions
• Same reliability as full checkout process

Troubleshooting SMS Issues

Common Issues

• Number Format: Ensure correct Kenyan phone number format
• Network Delays: SMS may take up to 5 minutes during peak times
• Spam Filters: Check spam/junk folders for SMS notifications
• Provider Issues: Automatic fallback handles provider outages

SMS Not Received?

1. Check Phone Number: Verify correct number was provided
2. Wait Time: Allow up to 10 minutes for delivery
3. Check Email: Tickets are always delivered via email
4. Contact Support: Report persistent SMS issues

---

Agent Invitation & QR Scanning System

Overview of Agent System

The agent system allows event organizers to invite trusted individuals to help with ticket validation and attendee check-in at events. Agents use QR code scanning to verify tickets and manage event entry.

For Event Organizers

Inviting Agents

Step-by-Step Process

1. Access Event Dashboard: Go to your event management page
2. Agent Management: Click Manage Agents button
3. Invite New Agent: Click Invite Agent
4. Agent Information:
   • Email Address: Agent's email for invitation
   • Role Confirmation: Verify scanning permissions
5. Send Invitation: Agent receives email with instructions
6. Track Status: Monitor invitation acceptance in dashboard

Agent Invitation Email

Agents receive a professional email containing:

• Event Details: Date, time, location, venue information
• Responsibilities: QR scanning and admission duties
• Getting Started: Step-by-step instructions
• Mobile Instructions: How to use QR scanner on mobile
• Dashboard Link: Direct access to agent dashboard
• Contact Information: Support details

Managing Agents

Agent Dashboard Overview

• Invited Agents: List of all agent invitations
• Invitation Status: Pending, Accepted, Declined
• Agent Activity: Scanning statistics per agent
• Event Assignment: Which agents are assigned to which events

Agent Permissions

• Event-Specific: Agents can only scan tickets for assigned events
• QR Scanning: Validate ticket authenticity
• Admission Control: Check-in attendees
• Statistics Access: View their own scanning performance

For Agents

Getting Started as an Agent

Accepting Invitations

1. Check Email: Look for agent invitation email
2. Review Event Details: Understand event requirements
3. Create Account: Register if you don't have an account
4. Accept Invitation: Click acceptance link in email
5. Access Dashboard: Navigate to agent dashboard

Agent Dashboard Features

• Assigned Events: List of events you can scan for
• Scanning Statistics: Your performance metrics
• Recent Activity: Latest scans and admissions
• Event Details: Quick access to event information

QR Code Scanning Process

Accessing the Scanner

1. Login: Sign in to your agent account
2. Agent Dashboard: View assigned events
3. Select Event: Choose event to scan for
4. Open Scanner: Click Scan Tickets button
5. Camera Access: Allow camera permissions

Scanning Interface Features

• Camera View: Live camera feed for QR scanning
• Manual Input: Type ticket codes if camera fails
• Scan History: Recent scans and results
• Admission Modal: Review ticket details before admission

Ticket Validation Process

Successful Scan Flow

1. QR Detection: Camera detects and reads QR code
2. Ticket Verification: System validates ticket authenticity
3. Attendee Information: Display ticket holder details
4. Admission Review: Confirm attendee identity
5. Check-in: Mark ticket as used/admitted
6. Success Confirmation: Green confirmation message

Error Handling

• Invalid QR Code: Clear error message with retry option
• Wrong Event: Notification if ticket is for different event
• Already Scanned: Warning for previously used tickets
• Expired Ticket: Alert for outdated or invalid tickets

Mobile Scanning Best Practices

Camera Setup

• Good Lighting: Ensure adequate lighting for scanning
• Steady Hands: Hold device steady for clear QR reading
• Proper Distance: Maintain 6-12 inches from QR code
• Clean Lens: Keep camera lens clean for optimal scanning

Scanning Tips

• QR Code Positioning: Center QR code in camera viewfinder
• Multiple Attempts: Try different angles if first scan fails
• Manual Backup: Use manual input for damaged QR codes
• Battery Management: Keep device charged during events

Agent Statistics & Reporting

Performance Metrics

• Today's Activity: Scans and admissions for current day
• Total Statistics: Lifetime scanning performance
• Event Breakdown: Performance per assigned event
• Recent Activity: Last 10 scans with details

Scanning Analytics

• Scan Success Rate: Percentage of successful validations
• Admission Rate: Tickets scanned vs. attendees admitted
• Peak Activity: Busiest scanning periods
• Error Tracking: Common scanning issues and resolutions

Security & Access Control

Agent Authorization

• Role-Based Access: Only agents can access scanning features
• Event-Specific Permissions: Agents limited to assigned events
• Invitation Verification: Must accept invitation to gain access
• Account Verification: Email confirmation required

Ticket Security

• Unique QR Codes: Each ticket has unique validation code
• One-Time Use: Tickets can only be scanned once
• Event Validation: Tickets only valid for specific events
• Timestamp Tracking: All scans logged with timestamps

Data Protection

• Attendee Privacy: Limited access to personal information
• Secure Transmission: All data encrypted in transit
• Access Logging: All agent activities logged for security
• Permission Revocation: Organizers can revoke agent access

---

Payment Methods

Supported Payment Options

Live Kenya Events supports multiple payment methods through Paystack integration, providing flexibility for all users.

Mobile Money (M-Pesa)

• Primary Method: Most popular payment option in Kenya
• STK Push: Automatic payment prompts on mobile
• Real-time Processing: Instant payment confirmation
• Phone Integration: Uses registered M-Pesa phone number

Credit & Debit Cards

• Visa: All Visa card types accepted
• Mastercard: Full Mastercard support
• American Express: Amex cards supported
• Local Cards: Kenyan bank-issued cards

Bank Transfers

• Direct Bank Transfer: Transfer from any Kenyan bank
• Real-time Verification: Instant payment confirmation
• Secure Processing: Bank-grade security standards

USSD Payments

• Feature Phone Support: Works on basic mobile phones
• Network Integration: All major Kenyan networks
• Simple Process: Easy USSD code-based payments

Payment Process

Paystack Integration

1. Secure Checkout: Paystack-hosted payment page
2. Method Selection: Choose preferred payment option
3. Payment Processing: Secure transaction handling
4. Instant Confirmation: Real-time payment verification
5. Automatic Ticketing: Immediate ticket generation

Payment Security

• PCI Compliance: Industry-standard security
• Encrypted Transactions: All payments encrypted
• Fraud Protection: Advanced fraud detection
• Secure Storage: No payment details stored locally

Free Events

Zero-Cost Tickets

• Instant Delivery: Immediate ticket generation
• No Payment Required: Skip payment process entirely
• Email Delivery: Tickets sent directly to email
• SMS Confirmation: Confirmation message sent

Free Event Process

1. Event Selection: Choose free event
2. Ticket Selection: Select quantity and type
3. Contact Information: Provide email and phone
4. Instant Confirmation: Immediate ticket delivery
5. Email & SMS: Confirmation via both channels

---

Troubleshooting

Common Issues & Solutions

Account Issues

Can't Log In

• Check Credentials: Verify email and password
• Account Confirmation: Check email for confirmation link
• Password Reset: Use Forgot Password feature
• Account Lockout: Contact support if account is locked

Email Not Received

• Check Spam: Look in spam/junk folders
• Email Address: Verify correct email was provided
• Delivery Delay: Allow up to 30 minutes for delivery
• Resend Option: Use resend confirmation feature

Payment Issues

Payment Failed

• Insufficient Funds: Check account balance
• Card Issues: Verify card details and expiry
• Network Problems: Try again with stable connection
• Payment Method: Try alternative payment option

Payment Successful but No Tickets

• Email Delivery: Check email (including spam)
• Processing Time: Allow up to 15 minutes
• SMS Confirmation: Check for SMS notification
• Contact Support: Report missing tickets

Ticket Issues

QR Code Not Scanning

• Image Quality: Ensure clear, high-resolution QR code
• Lighting: Scan in good lighting conditions
• Camera Focus: Keep camera steady and focused
• Manual Entry: Use backup code if QR fails

Ticket Shows as Invalid

• Event Match: Verify ticket is for correct event
• Date Validity: Check event date and time
• Already Used: Ticket may have been previously scanned
• Contact Organizer: Report invalid ticket issues

Chatbot Issues

Bot Not Responding

• Command Format: Check correct command syntax
• Bot Status: Verify bot is online and active
• Network Connection: Ensure stable internet connection
• Restart Conversation: Try sending /start command

Payment Links Not Working

• Link Expiry: Payment links expire after 24 hours
• Browser Issues: Try different browser or device
• Network Problems: Check internet connection
• Request New Link: Ask bot for fresh payment link

Getting Help

Support Channels

• Email Support: Contact via support email
• Live Chat: Available during business hours
• FAQ Section: Check frequently asked questions
• Community Forum: User community discussions

Reporting Issues

When reporting problems, include:

• Account Information: Email address (not password)
• Event Details: Event name and date
• Error Messages: Exact error text received
• Steps Taken: What you were trying to do
• Device Information: Phone/computer and browser used

Response Times

• Critical Issues: Within 2 hours
• General Support: Within 24 hours
• Feature Requests: Within 1 week
• Bug Reports: Within 48 hours

---

Contact & Support

Support Information

• Email: support@livekenya.co.ke
• Phone: +254 XXX XXX XXX
• Hours: Monday - Friday, 8:00 AM - 6:00 PM EAT
• Emergency: 24/7 support for critical event day issues

Additional Resources

• Website: https://livekenya.co.ke
• API Documentation: For developers and integrations
• Video Tutorials: Step-by-step guides
• Community Guidelines: Platform usage policies

---

This user guide covers all major features and processes of the Live Kenya Events platform. For the most up-to-date information and additional features, please visit our website or contact our support team.