​
Step 1: Add the Webview to your Layout

Go to your app’s layout file (e.g., activity_main.xml) in the res/layout folder. Then, add the WebView Widget. For example:

<WebView
    android:id="@+id/webview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

​
Step 2: Configure your Activity

Open the Java/Kotlin Activity File: For example, MainActivity.java or MainActivity.kt Then, initialize WebView:

  • Java:
java codeWebView myWebView = (WebView) findViewById(R.id.webview);
  • In Kotlin:
kotlin codeval myWebView: WebView = findViewById(R.id.webview)

Finally, point the Webview to your unique URL that contains your mobile chat AI

myWebView.loadUrl("https://decagon.ai/mobile/");

​
Step 3: Pass in Metadata

You may pass in arbitrary, unique information about the user as metadata by adding URL params to the URL. This metadata will be saved along with each conversation. User ID is what unique identifies a user and allows conversation history to be saved across sessions. For example:

myWebView.loadUrl("https://decagon.ai/mobile/?userId=...&email=...");

That’s it! You may find more in-depth guides on adding WebViews in Android on the internet if you need further assistance.

​
Step 4: (Optional) Pass in user token

If a token needs to used by the AI to uniquely and securely identify a user (e.g. to use for API calls), we recommend passing it in via the X-DECAGON-USER-TOKEN URL header in your WebView, and not as an URL param. This token will be passed to the Decagon backend on every chat message to be used in AI workflows.

Create a Map<String, String> (i.e. a headers map) that will hold your custom headers. For example:

Map<string, string=""> extraHeaders = new HashMap<string, string="">();

extraHeaders.put("X-DECAGON-USER-TOKEN", "");</string,></string,>

Then, include the headers map when loading your WebView.

myWebView.loadUrl(

    "https://decagon.ai/mobile/?userId=...&email=...",

    extraHeaders
);

See here for more info.

​
Step 5: (Optional) Enable file uploads

If file uploads are not enabled in your Android interface and you want to allow used to upload files, let your Decagon representation know. Once the interface is enabled, you’ll need to enable file uploads for your Android webview. This is a simple process.

Here is a great resource on how.

Adding Decagon to your Swift appAdding Decagon to your React Native app