Discover in your app, chat in the SDK

🧭 The shape of it

You keep the discovery experience in your app and hand off to the SDK only for the actual conversation:

• Your app renders the enterprise list (your layout, your button, your search).
• The SDK owns auth, the chat screen, real-time messaging and push — unchanged.

There is no new API to build: the enterprise list is the same GET main/enterprises/?channel_id=<hashcode> the Discover tab already calls, surfaced as a clean SDK method that returns a flat VihEnterprise list.

🔩 How it works — three calls

🗂️ The VihEnterprise model

Each row you render is a VihEnterprise. Use enterpriseId as the id you pass to openChat; raw is the full underlying model if you need a field not surfaced here.

enterpriseId : String    // the id to pass to openChat (enterprise user_id)
name         : String    // resolved display name
logoUrl      : String?   // logo/avatar URL (may be null → show a placeholder)
category     : String
industry     : String
description  : String?   // short blurb, when the channel provides one
raw          : EnterPriseModel   // full underlying model (escape hatch)

Android Kotlin

Copy custom-sdk/android/VihDiscoverKit.kt into your app (rename its package), or call com.vihmessenger.vihchatbot.discover.VihDiscover directly. All callbacks arrive on the main thread.

import com.example.vihdiscover.VihDiscoverKit

VihDiscoverKit.prepareSession(
    context  = this,
    phone    = "919876543210",
    hashcode = "your-channel-hashcode",
    onReady  = { loadEnterprises() },
    onError  = { e -> showError(e.message) }
)

private fun loadEnterprises() {
    VihDiscoverKit.fetchAllEnterprises(
        hashcode = "your-channel-hashcode",
        onResult = { enterprises ->          // List<VihEnterprise>
            adapter.submitList(enterprises)   // your adapter, your layout
        },
        onError = { e -> showError(e.message) }
    )
}

// Prefer to page lazily instead? Use one page at a time:
// VihDiscoverKit.listEnterprises(hashcode, page = 1, search = "", industries = "", …)

holder.chatButton.setOnClickListener {
    VihDiscoverKit.openChat(
        context    = holder.itemView.context,
        hashcode   = "your-channel-hashcode",
        enterprise = item          // the VihEnterprise for this row
    )
}

iOS Swift

Copy custom-sdk/ios/VihDiscoverKit.swift into your target, or call VihDiscover directly. Both async and completion-handler forms are provided; here's the async flow.

import VihChatBotSDK

func loadDiscover() {
    Task {
        do {
            try await VihDiscoverKit.prepareSession(
                phone: "919876543210", hashcode: "your-channel-hashcode")

            let enterprises = try await VihDiscoverKit.fetchAllEnterprises(
                hashcode: "your-channel-hashcode")   // [VihEnterprise]

            await MainActor.run { self.render(enterprises) }  // your own UI
        } catch {
            await MainActor.run { self.showError(error) }
        }
    }
}

@objc func onChatTapped(_ enterprise: VihEnterprise) {
    VihDiscoverKit.openChat(
        from: self,
        hashcode: "your-channel-hashcode",
        enterprise: enterprise)   // pushed onto your nav controller
}

// Land on the SDK dashboard after backing out of the chat (opt-in on iOS):
// VihDiscover.openChat(from: self, hashcode: hashcode,
//                      enterprise: enterprise, landOnDashboard: true)

🛎️ The floating widget on your bottom nav

The SDK's FloatingButtonView sits centered on your app's bottom navigation bar as the always-visible launcher into the SDK — the standard entry point alongside your Discover list. Drop it into the middle slot of your bottom bar:

• Set your own artwork with setCenterImageResource(...) + imageOnly = true (full-bleed, no background circle).
• It pops (animates up) automatically when the SDK receives a message (popOnMessageEnabled / popUp()).
• Shows an unread-count badge via unreadCount — auto-increments per message and clears on tap; drive it yourself with countUnreadOnMessage = false.
• By default a tap opens the SDK; set launchesSdkOnClick = false + your own setOnClickListener to handle it.

val widget = FloatingButtonView(context).apply {
    setCenterImageResource(R.drawable.ic_vih_widget) // your widget artwork
    imageOnly = true            // full-bleed, no background circle
    launchesSdkOnClick = false
    setOnClickListener {
        FloatingButtonView.startSdk(context, "919876543210", "your-channel-hashcode")
    }
}
// place `widget` in the center slot of your bottom navigation bar;
// it pops + updates its unread badge automatically as messages arrive.

🔎 Search & pagination

The enterprise endpoint is paged and searchable server-side:

• Search: pass search = "acme" to filter by name.
• Industry filter: pass industries = "Banking,Retail" (comma-separated).
• Paging: fetchAllEnterprises auto-walks pages until one returns empty (capped at maxPages, default 20). To page lazily yourself, call listEnterprises(page = n, …) and stop when a page comes back empty.

VihDiscoverKit.fetchAllEnterprises(
    hashcode   = "your-channel-hashcode",
    search     = "bank",
    industries = "Banking,Fintech",
    onResult   = { list -> adapter.submitList(list) },
    onError    = { e -> showError(e.message) }
)

🔐 Auth & session — read this once

• Sign in first. The list and chat endpoints are authenticated. Call prepareSession (once) before fetchAllEnterprises or openChat, or those calls will fail with an auth error.
• Channel switch resets the session. Passing a different hashcode than last time clears the previous channel's stored token — intentionally, so you never send a stale token to the new channel.
• Session persists. Once prepareSession succeeds the token is stored (encrypted on Android, Keychain on iOS); you don't need to call it on every screen — only after a fresh install, logout, or channel change.
• Already using the full SDK? If the user has already signed in through the SDK's normal launch on this channel, the session exists and you can skip prepareSession and go straight to listing.

🩺 Troubleshooting

📮 Support

Questions on the custom Discover flow, a field you need on VihEnterprise, or session/auth behavior? Reach the VIH team with your channel hashcode, SDK version, and the call you're making.