# Connect Your Mobile App (Android / iOS)

{% hint style="info" %}
You need to —&#x20;

1. An Admin on MyAlice.
2. Have a mobile application.
   {% endhint %}

## Use Cases of Mobile App Plugin

Integrating your Mobile App with MyAlice will allow you to:

* Add a chat widget in your mobile app.
* Engage your app users with live conversations.
* Push custom notifications on different app interfaces.
* Collect app feedback from users automatically.
* Use chatbots to create custom user journeys and automate repetitive queries
* Manage messages, comments, and e-commerce orders from other platforms in the same inbox.

## Add a Chat Plugin on your Mobile App

### Step 1: Create a Mobile App Plugin Channel

![](https://1800541801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgzCdF2XNgHNO9_KQDe%2Fuploads%2FYydKq15F6uyYjh7tgvt6%2FIntegrations%20tab.png?alt=media\&token=c58a6da2-c2bb-45ba-94ab-9afcc0f1504f)

1. Go to **Integration** from the left navigation bar.
2. Under **Available Integrations**, select **Mobile App Plugin**.
3. A connection window will appear from the right. Click on **Next**.
4. Upload a 256\*256 px circle chat avatar, preferably your brand logo. This will appear on your mobile app chat preview.
5. Add a title for your chat e.g., MyAlice Mobile Support. Note that the name will appear in public.
6. Paste your website domain URL in the next field.
7. Select a color for your chat, preferably your brand color.
8. You can also [add an NLP app](https://docs.myalice.ai/chatbot-automation/create-rules-to-trigger-a-sequence/user-intent-by-nlp-wise-automation/connect-wit-nlp) to your live chat channel.

You should get something like this. Now, click **Next**. Here you'll find a few information, such as a  Token, a Primary ID and platform ID. Save these.

![](https://1800541801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgzCdF2XNgHNO9_KQDe%2Fuploads%2FbPpcCAs5e14XvCYEDixt%2Fconnect%20mobile%20app.png?alt=media\&token=800cba56-c97a-4705-94b7-9119c1343dec)

{% hint style="info" %}
Publishing the channel means that the channel is live, along with the automation rules you have set for the channel. Some users prefer to publish their channel after they complete the automation flow. If you are one of them, please turn off the toggle for now. You can always turn it back on.
{% endhint %}

### Step 2: Get the App URL

## Get App URL

<mark style="color:green;">`POST`</mark> <https://prod-api.myalice.ai/api/bots/get_app_url>

This API will provide the URL that you need to open in your in-app browser.

#### Headers

| Name  | Type   | Description                            |
| ----- | ------ | -------------------------------------- |
| token | string | You will get this from Alice Dashboard |

#### Request Body

| Name         | Type        | Description                                                |
| ------------ | ----------- | ---------------------------------------------------------- |
| user\_meta   | JSON object | This is to pass any parameter that can be used from Alice. |
| user\_phone  | string      | Phone to verify logged-in user.                            |
| user\_email  | string      | Email to verify logged-in user.                            |
| user\_name   | string      | User Name to be stored in customer.                        |
| primary\_id  | integer     | You will get this from your dashboard.                     |
| platform\_id | integer     | You will get this from your dashboard.                     |

{% tabs %}
{% tab title="200 " %}

```
{
  url: "https://inconnect-inapp-webview.netlify.app?customer_id=<int>&platform_id=<int>&primary_id=<string>&token=<string>"
}

```

{% endtab %}
{% endtabs %}

## Step 3: Load the URL in your App Browser

The URL that you just received, load this your App Browser. This will add a widget on your app to initiate a conversation.

#### User Management

* There will be two types of users. Guest user and signed-up user. Signed-in users will be recognized by either email or phone number and the conversation history will be synced accordingly.
* Keep several optional fields for customer attributes, and a **user\_meta** field to provide extra information about customers to save in customer\_meta.

## Edit Mobile Chat Plugin Settings

From the Integration menu, select the **Integrated** tab. Here, you can view and manage your already connected channels.

![](https://1800541801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgzCdF2XNgHNO9_KQDe%2Fuploads%2Fz9IiSvnoFXMfdVvS8heu%2FAll%20Integrated%20Channels%20Final.png?alt=media\&token=fe15f2ad-6950-48c8-b72d-14b91b980cad)

{% hint style="info" %}
Click on the triple dot (...) icon on each channel to edit channel settings, get the API key, disconnect or delete your channel.
{% endhint %}

From the edit menu, you can edit the following.

* Chat avatar
* Title or Preview Name
* Domain
* Chat color

You can also connect [an NLP app](https://docs.myalice.ai/chatbot-automation/create-rules-to-trigger-a-sequence/user-intent-by-nlp-wise-automation/connect-wit-nlp) to your mobile chat plugin.

Please refer to the following page to connect your NLP and train your chatbots to process, analyze and understand large amounts of natural language data.

{% content-ref url="broken-reference" %}
[Broken link](https://docs.myalice.ai/connect-social-channels/connect-web-app/broken-reference)
{% endcontent-ref %}
