> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Android integration
> Integrate the Molin AI chatbot into your Android app using WebView.
The recommended way to integrate Molin AI in your Android app is by rendering our widget inside a `WebView` component.
See the full working example on GitHub: [molin-ai/molin-ai-android-example](https://github.com/molin-ai/molin-ai-android-example).
## Basic setup
Create an HTML file that loads the widget and displays the chat component fullscreen. Place it at `app/src/main/assets/widget.html`:
```html theme={null}
```
Replace `YOUR_WIDGET_ID` with your actual widget ID from the Molin dashboard.
The `show-close` attribute is optional. It renders a close button (✕) in the chat header, which is useful when the widget is displayed fullscreen in a webview. You can omit it if your app has its own navigation to dismiss the chat.
## Loading the WebView
Create a layout with a fullscreen `WebView` (`res/layout/activity_main.xml`):
```xml theme={null}
```
Then load the HTML file in your activity:
```kotlin theme={null}
import android.annotation.SuppressLint
import android.os.Bundle
import android.webkit.WebView
import android.webkit.WebViewClient
import android.webkit.WebSettings
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
@SuppressLint("SetJavaScriptEnabled")
override fun onCreate(savedInstanceState: Bundle?) {
supportActionBar?.hide()
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val webView: WebView = findViewById(R.id.webView)
webView.settings.javaScriptEnabled = true
webView.settings.domStorageEnabled = true
webView.settings.mixedContentMode = WebSettings.MIXED_CONTENT_ALWAYS_ALLOW
@SuppressLint("AllowUniversalAccessFromFileURLs")
webView.settings.allowUniversalAccessFromFileURLs = true
webView.webViewClient = WebViewClient()
webView.loadUrl("file:///android_asset/widget.html")
}
}
```
## Handling the close button
When the user taps the close button, the `` element fires a `molin-shop-ai-chat:close-click` event. Navigate to a custom `molin://` URL to tell the native side to go back:
```html theme={null}
```
On the Kotlin side, intercept the `molin://` scheme in a `WebViewClient`:
```kotlin theme={null}
import android.webkit.WebResourceRequest
import android.webkit.WebView
import android.webkit.WebViewClient
webView.webViewClient = object : WebViewClient() {
override fun shouldOverrideUrlLoading(
view: WebView?,
request: WebResourceRequest?
): Boolean {
val url = request?.url ?: return false
if (url.scheme == "molin") {
if (url.host == "close") {
finish()
}
return true
}
return false
}
}
```