# CustomTabs

The `userRedirectUrl` field is used to redirect the user. This field is received in the successful process creation response when making the Process Creation request. Here you will find the best way to manage the user experience, using CustomTabs, in your Android application:

### **Step 1:** Using CustomTabs for Integration <a href="#step-1-using-customtabs-for-integration" id="step-1-using-customtabs-for-integration"></a>

1 - Add the necessary dependency for using CustomTabs in your app/build.gradle:

```json
implementation("androidx.browser:browser:1.5.0")
```

### **Step 2:** Opening a CustomTab <a href="#step-2-opening-a-customtab" id="step-2-opening-a-customtab"></a>

```json
import android.net.Uri
import androidx.activity.ComponentActivity
import androidx.browser.customtabs.CustomTabsClient
import androidx.browser.customtabs.CustomTabsIntent

class CustomTabActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)

       openCustomTab(<URL_CBU>)
    }

    fun openCustomTab(url: String) {
        val builder = CustomTabsIntent.Builder()
        val customTabsIntent = builder.build()
        customTabsIntent.launchUrl(this, Uri.parse(url))
    }
}
```

### **Step 3:** Modifying AndroidManifest <a href="#step-3-modifying-androidmanifest" id="step-3-modifying-androidmanifest"></a>

Add the necessary permissions and intents in the AndroidManifest.xml for the Activity that you want to receive the callback\_uri. It is necessary to include the attribute `android:launchMode="singleTop"` as well as the `<data>` tag providing the URI data.

```
xml
```

```json
<uses-feature android:name="android.hardware.camera" android:required="false"/>
<uses-permission android:name="android.permission.CAMERA"/> 
// ermissions for camera and geolocation are required

<activity
    android:name=".CustomTabActivity"
    android:exported="true"
    android:label="@string/app_name"
    android:theme="@style/Theme.Customtabs"
    android:launchMode="singleTop">

    <intent-filter android:label="Custom Tab">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <!-- scheme e host são os dados fornecidos na criação de um processo no campo callback_uri
        callback_uri: "foobar://success?code=1234" -->
        <data android:scheme="foobar" android:host="success"/>
    </intent-filter>

</activity>
```

The following permissions are necessary for it to function correctly:

* Camera
* Geolocation

### **Step 4:** Getting Return Information <a href="#step-4-getting-return-information" id="step-4-getting-return-information"></a>

o retrieve redirect information with the provided data, you can use the following code in the `onNewIntent` method of your Activity:

```json
override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)

    val url = intent.data
    val scheme = url.scheme // "foobar"
    val host = url.host // "success"
    val code = url.getQueryParameter("code") // "1234"
}
```

{% hint style="success" %}
It is also possible to use the link generated by Unico in hybrid frameworks. To do this, you can create a bridge between the framework used and the native one and follow as we suggest in the documents or use a library that makes these integration options available.
{% endhint %}

{% hint style="warning" %}
Integrating WebView into your application is the customer's sole responsibility, as this functionality is not offered as part of Unico's libraries or SDKs. Because of this, we do not offer technical support for questions or problems related to implementing WebView in your application. For configuration guidance, we recommend consulting the official documentation for the technology used in your project (e.g. React Native, Flutter, etc.).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devcenter.unico.io/unico-idcloud/by-unico-integration/sdk-redirect/app/android/customtabs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.