FAQs

Sogo App - FAQ & How-To Guide
๐Ÿš€

Getting Started

Follow these steps to create your Sogo account:

  1. Open the app and tap "Agree and Continue"
  2. Select your country from the dropdown (auto-detected by IP)
  3. Enter your phone number with country code
  4. Check the box to agree to Terms & Conditions
  5. Tap Continue to receive your OTP
๐Ÿ’ก Tip: The app defaults to Nigeria (+234) if automatic detection fails. You can manually select your country by tapping the flag dropdown.
Platform Requirement
Android SDK 24+ (Android 7.0+)
iOS iOS 12+
Permissions Camera, Microphone, Storage, Notifications
๐Ÿ”

Authentication & OTP

  1. Enter the 6-digit OTP sent to your phone
  2. For testing purposes, you can use code: 123456
  3. Tap Continue to proceed
Scenario Next Step
Existing User Automatically logged in and taken to Home screen
New User Taken to Sign Up screen to create profile
๐Ÿ‘ค

Profile Setup

  1. Upload Photo (optional): Tap the camera icon on the avatar
    • Select image from gallery
    • Supported formats: Standard image formats
  2. Enter First Name (required)
  3. Enter Last Name (required)
  4. Enter Email (optional but recommended)
    • Must be valid format: name@domain.com
  5. Tap Complete Signup
โœ“ Note: The profile photo is optional. A default avatar will be shown if you skip this step.
  1. Go to Settings tab
  2. Tap your current profile picture
  3. Select "Change Photo"
  4. Choose from Gallery or Camera
  5. Crop and confirm

The photo will upload automatically with a progress indicator.

๐Ÿ’ฌ

Chat & Messaging

  1. Go to Chats tab
  2. Tap the floating message button (bottom right)
  3. Select a contact from your list
Feature Description
Text Messages Send instant text messages with typing indicators
Media Sharing Images, Videos, Files, Voice Messages
Reactions React with emojis (๐Ÿ˜‚ โค๏ธ ๐Ÿ‘ ๐Ÿ”ฅ ๐Ÿ˜ข)
Reply Reply to specific messages
Edit Edit sent messages within 5 minutes
Delete Delete messages for everyone
Read Receipts See when messages are delivered and read

Long-press any conversation to access:

  • Delete Conversation - Remove entire chat history
  • Clear Messages - Keep chat but remove all messages
  • Search - Find specific messages
โš ๏ธ Warning: Deleting a conversation cannot be undone. All messages will be permanently removed.
๐Ÿ“ž

Voice & Video Calls

The app supports 1-to-1 calls and group calls via:

  • FCM Push Notifications - Background/terminated state
  • Pusher - Real-time events when app is open
  • CallKit - Native call UI integration

When you receive a call:

  1. Native call screen appears with caller name
  2. Accept: Routes to appropriate call screen
  3. Decline: Dismisses the call
  4. Timeout: Call automatically ends after 30 seconds
Type Description Icon
audio Voice-only call ๐ŸŽ™๏ธ
video Video call with camera ๐Ÿ“น
group_call Multi-participant group call ๐Ÿ‘ฅ

During a call, you can:

  • Mute/Unmute - Toggle microphone
  • Camera On/Off - Toggle video (video calls)
  • Flip Camera - Switch front/rear camera
  • Speaker - Toggle speakerphone
  • Screenshot - Capture call moment (if enabled)
  • Screen Protection - Block/allow screen capture
  • Grid View - Toggle between speaker and grid layout
  • Participants - View all call participants
๐Ÿ’ก Tip: Tap the video area to show/hide controls. Controls auto-hide after 4 seconds of inactivity.
๐Ÿ‘ฅ

Groups

  1. Go to Chats or Groups tab
  2. Tap the โ‹ฎ menu (three dots)
  3. Select "New Group" or "Create New Group"
  4. Enter group name and description
  5. Set privacy (Public/Private)
  6. Add members from your contacts

As an Admin, you can:

  • Add Members - Tap "Add" button in group settings
  • Remove Members - Tap member โ†’ Remove
  • Make Admin - Promote members to admin role
  • Remove Admin - Demote admins to regular members

Member Roles:

Role Permissions
Admin Add/remove members, delete group, manage settings
Member Send messages, view media, leave group
  1. Open the group chat
  2. Tap the โ‹ฎ menu (three dots)
  3. Select "Group Voice Call" or "Group Video Call"
  4. Confirm to start the call
  5. All members will receive a CallKit notification
โœ“ Note: Group calls use LiveKit for high-quality video/audio with up to 50+ participants.
  1. Open group chat
  2. Tap group name to open Group Settings
  3. Tap "Media" quick action button
  4. Browse through tabs: All, Photos, Videos, Files

Media is organized by type and includes sender information and timestamps.

๐Ÿ“ธ

Status Updates

The StatusUploader class handles status uploads with support for both images and videos:

  1. Tap "My Status" on the Status tab
  2. Select "Add Status"
  3. Choose media type:
    • Image - Select from gallery or take photo
    • Video - Select from gallery (opens trimmer)
  4. For videos, trim to desired length first
  5. Choose if status should be Promoted (highlighted in orange)
  6. Upload automatically begins
๐Ÿ’ก Technical Details:
// StatusUploader handles:
- Image Picker (gallery/camera)
- MIME type detection (image/video)
- Video trimming flow
- Multipart form-data upload
- Progress tracking

Supported Formats:

Type Formats Max Duration
Image JPEG, PNG, GIF, WebP N/A
Video MP4, MOV, MKV, WebM, AVI 30 seconds
  1. Go to Status tab
  2. Tap on any contact's status ring
  3. Statuses auto-advance every 5 seconds (images)
  4. Videos play full duration
  5. Tap left/right to navigate between statuses
  6. Long-press to pause
  7. Swipe up to see viewers (your own statuses)
  8. Swipe down to close
๐Ÿ’ก Color Coding:
  • โ— Green - New status
  • โ— Orange - Promoted status
  • โ— Grey - Already viewed

Tap "View My Status" to access your status management screen:

  • View Count - See how many people viewed each status
  • Delete Single - Long-press a status โ†’ Delete
  • Delete All - Long-press first status โ†’ "Delete ALL"
  • Select Multiple - Tap to select, then delete batch

Statuses automatically expire after 24 hours.

โš™๏ธ

Settings & Privacy

  1. Go to Settings
  2. Tap "Chat Wallpaper"
  3. Select from available wallpapers:
    • Solid Colors
    • Gradients
    • Patterns
    • Custom Image
  4. Preview and confirm

Go to Settings โ†’ Notifications to configure:

Type Options
Message Notifications Sound, Vibration, Popup
Group Notifications Separate settings for groups
Call Notifications Ringtone, Vibration pattern
Status Updates Toggle on/off

To Logout:

  1. Go to Settings
  2. Tap "Logout" at bottom
  3. Confirm in dialog
  4. You'll return to Registration screen

Account Options:

  • Change Number - Update phone number
  • Delete Account - Permanently remove all data
  • Privacy Settings - Control visibility
โš ๏ธ Warning: Deleting your account is permanent. All messages, groups, and media will be lost.
๐Ÿ”ง

Technical Information

Service Purpose
Firebase Cloud Messaging (FCM) Push notifications for calls/messages
Pusher Channels Real-time call signaling
CallKit (iOS) / ConnectionService (Android) Native call UI
LiveKit Video/audio calling infrastructure
SharedPreferences Local data storage
  • OTP-based verification - Phone number verification
  • Token-based authentication - Secure API access
  • FCM token registration - Secure push delivery
  • Screen protection - Block screenshots in calls (optional)
  • End-to-end encryption - For messages and calls
Issue Solution
"Please enter a valid code" Ensure correct 6-digit OTP, check phone number
"Please agree to Terms" Check the agreement checkbox before continuing
Call not connecting Check internet, microphone/camera permissions, FCM token
App crashes on startup Check Firebase initialization, permissions, device compatibility
Status upload fails Check file size (max 50MB), format support, network connection
Video trimmer not working Ensure video is under 30 seconds, supported format

ยฉ 2026 Sogo App. All rights reserved.

This guide is based on the Sogo App codebase structure.