### Step 4: Invite Member form
#### Enter your team member's email address
{% hint style="info" %}
Make sure the email address is accessible by you or the invited person
{% endhint %}
#### Select a Role & Access
Select a role for the invited member (you can change this later).
#### **Assign Topics (optional)**
Assign your team member to a topic or topics by selecting at least one topic (you can update this later).
{% hint style="info" %}
If you haven't created a topic before, you'll have one default topic named **General**
{% endhint %}
#### Send Invitation
Once everything is filled click on the button 
### Step 5: Accept Invitation
Please check for an email from the sender *OneTalk by TapTalk.io* and click 
{% hint style="info" %}
Please **check your spam folders** for this email if you can't find it in your inbox.
{% endhint %}
### Sign up for OneTalk by TapTalk.io
Once the invited member has clicked on Join Now, a new tab will open prompting the member to sign up. Continue with the sign up process and they will be good to go!
# Add Topic
A step by step guide on how to add a topic in OneTalk by TapTalk.io.
## Topics to better organize your messages
Having the right topics for the right channels can help you efficiently match the right type of questions to expect to the right agents.
{% hint style="info" %}
Adding topics can only be done if your role is **Owner** or **Admin**
{% endhint %}
{% hint style="info" %}
We recommend you to have at least one other invited and verified member other than you (the owner) in the organization. [**Invite members**](/onetalk-omnichannel-documentation/getting-started/team-members#step-4-invite-member-form) if you haven't already done so.
{% endhint %}
### Step 1: Go to Organization
To get started, on the very left side menu click on **Organization.**
### Step **2**: Go to Topics
A submenu should appear with different options, go ahead and select **Topics.**
### Step 3: Add a topic
On the right-hand side, click on the button 
### Step 4: Type a topic name
Type in a topic name inside the text box (e.g Billing)
### Step 5: Confirm topic name
To confirm the topic name, click the button 
### Congratulations! You have just created a topic!
You will be redirected to the topic's detail, where you can edit the topic name and assign an agent.
### What to do next?
We recommend you to assign at least one agent (member) to the topic you have just created. If you wish to assign an agent right after creating a topic, go ahead and click on the button 
and follow the next guide [**Assign Agent to Topic**](/onetalk-omnichannel-documentation/getting-started/assign-agent-to-topic#step-4-assign-an-agent) (skip to step 4).
# Assign Agent to Topic
A step by step guide on how to integrate assign an agent to a topic in OneTalk by TapTalk.io.
## Get your cases handled by the right people
Make sure the right agents are handling the right cases. With OneTalk you can achieve this by assigning specific agents to a specific topic.
{% hint style="info" %}
Assigning agents to topics can only be done if your role is **Owner** or **Admin**
{% endhint %}
{% hint style="info" %}
If you have just added a new topic and still on the topic detail page, [**skip to step 4**](/onetalk-omnichannel-documentation/getting-started/assign-agent-to-topic#step-4-assign-an-agent)
{% endhint %}
### Step 1: Go to Organization
To get started, on the very left side menu click on **Organization**
### Step **2**: Go to Topics
A submenu should appear with different options, go ahead and select **Topics.**
### Step 3: Open topic details
Select a topic and click on the button 
### Step 4: Assign an agent
Once you have opened topic details, click on the button 
to confirm
### Congratulations! You now have an assigned agent to this topic!
Once confirmed, your newly assigned agent will show up under the section **Assigned Agents**
# Paid Proactive Chat
A step by step guide on how to create a proactive chat by TapTalk.io
## Introduction
By using our Paid Proactive Chat, you can simply reach out to your customer first without waiting for your customer to chat with you in the first place, so you can reach more customers using our feature by sending them a broadcast, a new message, or automatic message using our API.
### Types of Proactive Chat
There are three types of proactive chat that you can use, as explained below :
* [**Broadcast Message**](/onetalk-omnichannel-documentation/getting-started/paid-proactive-chat#broadcast-message)
* [**Start New Conversation**](/onetalk-omnichannel-documentation/getting-started/paid-proactive-chat#start-new-conversation)
* [**Send Message API**](/onetalk-omnichannel-documentation/getting-started/paid-proactive-chat#send-message-api)
#### Broadcast Message
With Broadcast Message, you can send a bulk message to 100 customers at one time so you don't need to send it manually.
#### Start New Conversation
If you want to send a specific message to a specific number of recipients, just simply use our Start New Conversation feature that accessible in our OneTalk Inbox.
#### Send Message API
Another alternative is by using our Send Message API feature. By using our API, you can simply integrate it with your system, and send the message via WhatsApp by calling our API. You can use it to send an automated message like OTP and transactional notification to your customer using our message API.
### **Pricing per Message**
You can check this table below for the detailed pricing of the outbound message of proactive chat that we implement on both WhatsApp SME and WhatsApp Business API.
**WhatsApp SME - Outbound Message**
| **Item** | **Text** | **Image** | **Video** | **Document** |
| :-------------------------------------------------------------: | :------: | :-------: | :-------: | :----------: |
| 
Fill out the **Account Name** form.
{% hint style="info" %}
**Pro tip:** Fill out your *Account Name* as your selected WhatsApp account phone number.
{% endhint %}
After you have filled out your form, go ahead and select a topic for this channel (you can change this later). This topic list will correspond to the topics you have created in the **Topics** page.
{% hint style="info" %}
If you don't find the desired topic to choose from, you can always [**add a topic**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MOaJ-Dp29xLiLb1W9b9/onetalk-omnichannel-documentation/getting-started/add-topic/@drafts).
{% endhint %}
Once you have filled both form, click on the button 
A pop-up displaying the **Terms and Condition** of using WhatsApp SME will appear with the following terms:
* I acknowledge there is a possiblity of this WhatsApp SME number being banned by WhatsApp SME for sending marketing, promotion, spam messages to one or more recipients at once.* I understand that exceeding the recommended usage can also result in ban by WhatsApp SME.
* I take full responsibilty for any repercussions resulted. If you agree with the above terms and wish to continue with the setup, click on
, if you wish to learn more about this please don't hesitate to [**contact us**](mailto:hello@taptalk.io).
After accepting the terms and conditions above, you will be directed to the page **Review Payment**. Below you'll see:
1. **Your WhatsApp SME plan** (this plan varies depending on the tier you have chosen for OneTalk, you can see more in detail on [**our pricing page**](https://taptalk.io/onetalk/pricing?utm_source=display-ads\&utm_medium=cpc\&utm_campaign=general\&utm_term=a1))**.**2. **Your current Payment Method** (the default will be set to manual if you have not updated it).  If you wish to change to annual payments, simply activate the toggle
where your WhatsApp SME plan is located.
{% hint style="info" %}
**The total amount due will change** depending if you choose to pay monthly or annually for your WhatsApp SME channel
{% endhint %}
If you wish to change how you pay, click on the button 
where your current payment method is located and **follow this guide on Payment Settings**.
{% hint style="warning" %}
**Caution:** If you decide to change payment method, keep in mind that you will lose all the progress you have made so you will have to **repeat step 1**.
{% endhint %}
Once you're happy with the current options, go ahead and click 
{% hint style="info" %}
**Manual Payments:** Please allow up to 24 hours for our team to setup your channel after your payment has been verified. You will need to complete the payment before it reaches the due date once the invoice is generated.
{% endhint %}
{% hint style="info" %}
**Annual Payments:** Please allow up to 24 hours for our team to setup your channel after your payment has been verified. Your next payment will be auto deducted from the card above once it reaches the due date.
{% endhint %}
### Step 2: Confirm and Make Payment
Once you have clicked **Confirm and Make Payment** an alert should appear on the bottom left of the screen:
{% hint style="info" %}
Your next screen will depend on which payment method you have chosen to create this channel.
{% endhint %}
Select one of the steps below according to your payment method:
* [**Click here for Manual Payment method**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MP2LlXtxCbjbc0eK-AC/onetalk-omnichannel-documentation/onetalk-channel-integration/whatsapp-sme-integration/@drafts#manual-payment-method-instructions)* [**Click here for Automatic Payment method**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MOaJ-Dp29xLiLb1W9b9/onetalk-omnichannel-documentation/onetalk-channel-integration/whatsapp-sme-integration/@drafts#automatic-payment-method-instructions) ### **Manual Payment method instructions** If you have selected manual payment, you will be redirected to **Invoice Detail.**  Please make payment before the *due date* as stated under the invoice title. To make payment follow the instruction that is beside the total due:  {% hint style="warning" %} **Important Note:** Before transferring, please make sure you pay exactly as the total states in the invoice {% endhint %}  Once you have transferred, please email the payment proof as an image or PDF to [**sales@taptalk.io**](mailto:sales@taptalk.io), don't forget to include your business name and invoice number in the body message.  {% hint style="info" %} Please allow up to 24 hours for you payment to be verified. {% endhint %} To find out whether your payment has been verified, select **WhatsApp SME** on the left side menu and [**jump to step 3**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MOaJ-Dp29xLiLb1W9b9/onetalk-omnichannel-documentation/onetalk-channel-integration/whatsapp-sme-integration/@drafts#step-3-setting-up-your-whatsapp-sme).  ### **Automatic Payment method instructions** If you have selected automatic payment, you will be redirected to **Verify Payment.** {% hint style="info" %} Keep in mind that this view may vary depending on what type of card you have chosen {% endhint %}  Follow the instructions that will appear in the above view. Once success you be redirected to your newly created **channel details**. ### **Step 3: Setting up your WhatsApp SME** There are quite a few statuses that will be displayed for your newly created channel depending on your payment method. Assuming you have just completed Step 2 (regardless of Manual or Automatic Payment) here are the statuses you may see: * **Not paid** - Your payment may have not been verified by our team or you have an overdue payment.
* **Waiting for setup** - Your payment has been verified by our team and it is in the process of setting up your WhatsApp account.
* **Got QR code** - Your WhatsApp account has been setup and is ready for you to integrate with OneTalk inbox.  {% hint style="info" %} **For Automatic Payment Method**: You will be directed to the page below after verifying your payment. {% endhint %}  Proceed to channel details by clicking on the created channel once your status is showing **Got QR code**. {% hint style="info" %} If it has been more than 24 hours and your status is still either **Not paid** or **Waiting for setup** please don't hesitate to [**contact us**](mailto:dev@taptalk.io). {% endhint %}  In the channel details page, click on
A pop up alert will appear asking whether the phone number used has been active for more than 30 days, prompting you to choose from two options:
* No, Under 30 Days
* Yes, More Than 30 Days
{% hint style="warning" %}
If you are unsure, go with [**No, Under 30 Days**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MOaJ-Dp29xLiLb1W9b9/onetalk-omnichannel-documentation/onetalk-channel-integration/whatsapp-sme-integration/@drafts#no-under-30-days-secure-authentication) which will lead you to Secure Authentication page.
{% endhint %}
Jump to one of these sections depending which one you have chosen:
* [**No, Under 30 Days (Secure Authentication)**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MOaJ-Dp29xLiLb1W9b9/onetalk-omnichannel-documentation/onetalk-channel-integration/whatsapp-sme-integration/@drafts#no-under-30-days-secure-authentication)* [**Yes, More Than 30 Days (Authenticate Now)**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MOaJ-Dp29xLiLb1W9b9/onetalk-omnichannel-documentation/onetalk-channel-integration/whatsapp-sme-integration/@drafts#yes-more-than-30-days-authenticate-now) ### **No, Under 30 Days (Secure Authentication)** If you decided to click on **No, Under 30 Days**, you will be directed to Secure Authentication page. {% hint style="warning" %} Make sure you are using **Google Chrome** {% endhint %} Firstly click on **Secure Authorization**.  Click on **Install extension**  {% hint style="warning" %} **Important Note:** Once you have installed the chrome extension make sure you **refresh the page**, do not click OK. {% endhint %} You will be taken back to the same view as you started at Secure Authentication. Go ahead and click on **Secure Authorization** again.  Open WhatsApp mobile app on your phone, go to **Settings > WhatsApp Web/Desktop > Scan QR Code.** Once done, you will be taken back to your channel details page. Jump to section [**Authentication done**](https://app.gitbook.com/@taptalk/s/omnichannel/~/drafts/-MP2LlXtxCbjbc0eK-AC/onetalk-omnichannel-documentation/onetalk-channel-integration/whatsapp-sme-integration/@drafts#authentication-done). ### **Yes, More than 30 Days (Authenticate Now)** If you decided to click on **Yes, More than 30 Days**, you will be directed to Authenticate Now page. Follow the instruction that are on the page or simply open WhatsApp mobile app on your phone, go to **Settings > WhatsApp Web/Desktop > Scan QR Code**.  Once done, you will be taken back to your channel details page. ### Authentication done! Congratulations, you have successfully integrated your WhatsApp account with OneTalk. There are some key points that needs to be kept in mind: * **There will be a syncing process time up to 48 hours**, this entirely depends on the volume of messages you have on your WhatsApp account and also your internet connection. This may cause up to a 10 minute delay in receiving messages.
* **You must monitor the mobile phone connected with WhatsApp SME**. We recommend you keep charge of the mobile phone at all times and make sure it has a stable internet connection.
* **You cannot use WhatsApp Web/Desktop on the same account of WhatsApp SME**. You can still reply messages through WhatsApp mobile app but we highly recommend you download OneTalk's Mobile agent app on [**Google Play Store**](https://play.google.com/store/apps/details?id=io.taptalk.onetalk) instead.  # Instagram Comment & DM Integration A comprehensive step by step guide on how to integrate Instagram DM as a channel into OneTalk by TapTalk.io. Integrating OneTalk with Instagram DM will allow you to receive and reply incoming messages from Instagram in your inbox. Integrating OneTalk with Instagram Comment will allow you to receive and reply incoming comments on your Instagram posts from Instagram users. {% hint style="warning" %} **Before you get started:** You will need an **Instagram** **Business** **Account** or **Instagram** **Creator** **Account**, not a personal Instagram Account, and you will also need a **Facebook Page** connected to your Instagram account. Please follow this link for more information: [Instagram Business Account](https://help.instagram.com/502981923235522) or [Instagram Creator Account](https://help.instagram.com/2358103564437429)\ [Facebook Page Connected to Instagram Account](https://help.instagram.com/399237934150902) {% endhint %} {% hint style="info" %} Integrating Instagram DM can only be done if your role is **Owner** or **Admin.** {% endhint %} ### Step 1: Create an Instagram DM channel Start by clicking **Integration** on the side menu**.** A submenu should appear with different channel options, go ahead and select **Instagram DM**.  Once selected, go ahead and click on the button   **Next,** you will have to login with your Facebook account, please click the **Continue with Facebook** button.  {% hint style="warning" %} **Note:** Make sure you login with the Facebook account which has the access to the Facebook Page {% endhint %} ### Step 2: Login to Facebook account Start by clicking **Continue with Facebook** button, you will be prompt to input your email or password for the first time, or after you've done login, it will show a popup like this.  ### Step 3: Choose Instagram account Next, it will prompt a pop-up to select an Instagram account, select all the accounts that you wish to integrate to OneTalk.  ### Step 4: Choose connected Facebook Page Next, choose the Facebook Page that connected to that account {% hint style="warning" %} **Note:** Please note that you have to connect your **Instagram** Account to **Facebook Page** For more information please refer to this page below :\ [Facebook Page Connected to Instagram Account](https://help.instagram.com/399237934150902) {% endhint %}  After you choose the **Instagram** **account** and **Facebook** **Page**, you will be prompt to choose the permission, please select all the permission and click continue.   Once you've seen the popup above, means your account is now connected to OneTalk. ### Step 5: Choose connected Facebook Page After you successfully logged in into your Facebook account, you will be shown screen as below:  Choose the FB Page you wish to integrate. Also, choose the related OneTalk topic for that channel  After you choose the FB Page and Topic, click **Create Channel Button** on the top right of the screen.   ### Step 6: Enable Message Control on Instagram One more step! After you've successfully connected your Instagram account to OneTalk, please make sure you activate **Allow Access to Messages** on your **Instagram** account. To activate that, please follow this step:\ Open **Instagram,** go to **Settings** > **Privacy** > **Messages,** then turn on **Allow Access to Messages**  Congrats! You've successfully connected your Instagram account to OneTalk. For more information feel free to contact us via **
### Step 2: Select platform
Depending on what platform you choose, the steps may vary. Jump to the section:
* [**Setup Live Chat for iOS**](/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat#setup-live-chat-for-ios)* [**Setup Live Chat for Android**
](/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat#setup-live-chat-for-android) * [**Setup Live Chat for Web**](/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat#setup-live-chat-for-web) ### **Setup Live Chat for iOS** Enter your iOS app **Bundle ID**  Once filled, click on
Once created, you will be redirected to the channel's details, where you can copy its secret key and paste it in your app.
{% hint style="info" %}
Please refer to [**OneTalk Live Chat for iOS**](https://docs.taptalk.io/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat/onetalk-ios/get-started-ios) once you have created this channel.
{% endhint %}
### **Setup Live Chat for Android**
Enter your Android app **Package Name**
Once filled, click on
Once created, you will be redirected to the channel's details, where you can copy its secret key and paste it in your app.
{% hint style="info" %}
Please refer to [**OneTalk Live Chat for Android**](https://docs.taptalk.io/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat/onetalk-android/get-started-android) once you have created this channel
{% endhint %}
### **Setup Live Chat for Web**
Enter your Web **CORS**. [**Learn more about CORS**](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS).
Once filled, click on
Once created, you will be redirected to the channel's details, where you can copy the script generated and paste it this snippet code on your web page inside the \ tag.
This will enable OneTalk's live chat to be displayed on your web.
You can change the widgets color according to your brand color. Simply scroll down and enter your desired hex code or simply choose with the gradient slider.
Once done, don't forget to click 
{% hint style="info" %}
Please refer to [**OneTalk Live Chat for Web**](https://docs.taptalk.io/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat/onetalk-web/get-started) once you have created this channel
{% endhint %}
# OneTalk Live Chat for Android
To start implementing OneTalk Live Chat for Android, please click the Get Started section
# Get Started
{% hint style="warning" %}
**Before you get started:** Make sure you have [**created a channel in OneTalk dashboard**](/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat#setup-live-chat-for-android) and obtain the **`APP_KEY_SECRET.`**
{% endhint %}
### Configure and Initialize TapTalk.io Omnichannel Android SDK
#### Step 1: Install TapTalk.io SDK
To start, open your Android project and add the following repositories to your **top-level** build.gradle file.
{% code title="build.gradle (project)" %}
```groovy
allprojects {
repositories {
google()
mavenCentral()
maven {
url = "https://jitpack.io"
}
maven {
url = "https://s3.amazonaws.com/repo.commonsware.com"
}
}
}
```
{% endcode %}
Then add the following dependency to your **app-level** build.gradle:
{% code title="build.gradle (:app)" %}
```groovy
dependencies {
implementation("com.github.taptalk-io:taptalk.io-omnichannel-android:3.0.0")
}
```
{% endcode %}
{% hint style="info" %}
You can check a more updated version release notes of the SDK [here](https://github.com/taptalk-io/taptalk.io-omnichannel-android/releases).
{% endhint %}
{% hint style="warning" %}
**Note**: In the app **build.gradle** file, make sure that your project is using supported Java 8 language features under the `android` tag like below
{% endhint %}
{% code title="build.gradle (:app)" %}
```groovy
android {
...
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
}
```
{% endcode %}
#### Step 2: Initialize TapTalkLive
In order to use TapTalkLive SDK, you must first initialize a TapTalkLive instance by passing the **`CONTEXT`**, **`APP_KEY_SECRET`**, **`CLIENT_APP_ICON`**, and **`CLIENT_APP_NAME`** assigned to your application to the **`init`** method as a parameter. Generally, initialization is implemented in the **Application** class in your project.
{% tabs %}
{% tab title="Java" %}
{% code title="Application.java" %}
```java
import io.taptalk.taptalklive.TapTalkLive;
import io.taptalk.taptalklive.Listener.TapTalkLiveListener;
import io.taptalk.taptalklive.API.Model.ResponseModel.TTLErrorModel;
...
TapTalkLive.init(
CONTEXT,
APP_KEY_SECRET,
CLIENT_APP_ICON,
CLIENT_APP_NAME,
new TapTalkLiveListener() {
@Override
public void onInitializationCompleted() {
// Handle initialization success here
}
@Override
public void onInitializationFailed(TTLErrorModel error) {
// Handle initialization failure here
}
}
);
```
{% endcode %}
{% endtab %}
{% tab title="Kotlin" %}
{% code title="Application.kt" %}
```kotlin
import io.taptalk.taptalklive.TapTalkLive
import io.taptalk.taptalklive.Listener.TapTalkLiveListener
import io.taptalk.taptalklive.API.Model.ResponseModel.TTLErrorModel
...
TapTalkLive.init(
CONTEXT,
APP_KEY_SECRET,
CLIENT_APP_ICON,
CLIENT_APP_NAME,
object : TapTalkLiveListener() {
override fun onInitializationCompleted() {
// Handle initialization success here
}
override fun onInitializationFailed(error: TTLErrorModel?) {
// Handle initialization failure here
}
}
)
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% hint style="info" %}
#### Parameters
**`CONTEXT`** (Context) application context\
**`APP_KEY_SECRET`**: (String) application key Secret\
**`CLIENT_APP_ICON`**: (int) drawable resource ID of your application's icon\
**`CLIENT_APP_NAME`**: (String) your application name\
**`tapTalkLiveListener`**: (TapTalkLiveListener) an interface to detect TapTalkLive Android SDK's delegates and callbacks
{% endhint %}
{% hint style="info" %}
Note: A more complete implementation of TapTalkLiveListener callbacks can be seen in the [Event Listeners page](/onetalk-omnichannel-documentation/onetalk-channel-integration/live-chat/onetalk-android/event-listener).
{% endhint %}
#### Step 3: Enable Chat Features
Please follow the steps in [Enable Chat Features](/powertalk-chat-sdk-documentation/powertalk-android/enable-chat-features) page to enable TapTalk.io's chat features, such as contact sync and sending media, document, and location messages.
### Open TapTalk Omnichannel View
To open TapTalkLive's view UI for your application, you can use the **`openTapTalkLiveView`** method from the **TapTalkLive** class. This will open a homepage activity containing a list of available channels, the user's latest case, and QnA path.
{% tabs %}
{% tab title="Java" %}
{% code title="YourActivity.java" %}
```java
import io.taptalk.taptalklive.TapTalkLive;
TapTalkLive.openTapTalkLiveView(YourActivity.this);
```
{% endcode %}
{% endtab %}
{% tab title="Kotlin" %}
{% code title="YourActivity.kt" %}
```kotlin
import io.taptalk.taptalklive.TapTalkLive
TapTalkLive.openTapTalkLiveView(this@YourActivity)
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% hint style="info" %}
**`openTapTalkLiveView`** will return **`true`** if opening the view is successful, and will return `false` if it fails due to incomplete initialization. TapTalkLive initialization might not be completed if the device is not connected to internet or an incorrect **`APP_KEY_SECRET`** parameter was provided.
{% endhint %}
# Event Listener
The Android SDK provides event listener to listen to various events on the client app. Through these event delegates, TapTalk.io notifies the client app of events that happen on your app.
You can listen through general events from the Live Chat SDK through the **TapTalkLiveListener** class. An instance of TapTalkLiveListener will be required to initialize the Live Chat SDK. A more complete implementation will be explained in this page.
{% tabs %}
{% tab title="Java" %}
{% code title="Application.java" %}
```java
import io.taptalk.taptalklive.TapTalkLive;
import io.taptalk.taptalklive.Listener.TapTalkLiveListener;
import io.taptalk.taptalklive.API.Model.ResponseModel.TTLErrorModel;
import io.taptalk.taptalklive.API.Model.TTLScfPathModel;
import io.taptalk.TapTalk.Model.TAPMessageModel;
...
TapTalkLive.init(
CONTEXT,
APP_KEY_SECRET,
CLIENT_APP_ICON,
CLIENT_APP_NAME,
new TapTalkLiveListener() {
@Override
public void onInitializationCompleted() {
// Initialization success
}
@Override
public void onInitializationFailed(TTLErrorModel error) {
// Initialization failed
}
@Override
public void onNotificationReceived(TAPMessageModel message) {
// TapTalk.io SDK receives a message notification
// Calling super will show TapTalk.io's default notification for the app
super.onNotificationReceived(message);
}
@Override
public void onCloseButtonInHomePageTapped(Activity activity) {
// User closes the home page
}
@Override
public void onCloseButtonInCreateCaseFormTapped(Activity activity) {
// User closes the create case form
}
@Override
public void onCloseButtonInCaseListTapped(Activity activity) {
// User closes the case list page
}
@Override
public void onTaskRootChatRoomClosed(Activity activity) {
// A chat room activity was closed by user when no other activity in the application is present
// You may start another activity to keep the app open, otherwise the app will stay closed
}
@Override
public void onSeeAllMessagesButtonTapped(Activity activity) {
// User taps the See All Messages button in home page
// Calling super will open the case list page
super.onSeeAllMessagesButtonTapped(activity);
}
@Override
public void onCreateNewMessageButtonTapped(Activity activity) {
// User taps the New Messages button in home or case list page
// Calling super will open the create new case form
super.onCreateNewMessageButtonTapped(activity);
}
@Override
public void onCaseListItemTapped(Activity activity, TAPMessageModel lastMessage) {
// User taps a case from a list in home or case list page
// Calling super will open the selected chat room
super.onCaseListItemTapped(activity, lastMessage);
}
@Override
public void onFaqChildTapped(Activity activity, TTLScfPathModel scfPath) {
// User taps a FAQ from a list in home or FAQ details page
// Calling super will open the selected FAQ details page
super.onFaqChildTapped(activity, scfPath);
}
@Override
public void onCloseButtonInFaqDetailsTapped(Activity activity, TTLScfPathModel scfPath) {
// User closes the FAQ details page
}
@Override
public void onTalkToAgentButtonTapped(Activity activity, TTLScfPathModel scfPath) {
// User taps the Talk to Agent button in home or FAQ details page
// Calling super will open the create new case form
super.onTalkToAgentButtonTapped(activity, scfPath);
}
@Override
public void onFaqContentUrlTapped(Activity activity, TTLScfPathModel scfPath, String url) {
// User taps a url in FAQ content
// Calling super will open the selected url using TapTalk.io's in-app browser
super.onFaqContentUrlTapped(activity, scfPath, url);
}
@Override
public void onFaqContentUrlLongPressed(Activity activity, TTLScfPathModel scfPath, String url) {
// User long presses a url in FAQ content
// Calling super will copy the selected url to the device's clipboard
super.onFaqContentUrlLongPressed(activity, scfPath, url);
}
@Override
public void onFaqContentEmailAddressTapped(Activity activity, TTLScfPathModel scfPath, String email) {
// User taps an email address in FAQ content
// Calling super will open the device's email composer for the selected email address
super.onFaqContentEmailAddressTapped(activity, scfPath, email)
}
@Override
public void onFaqContentEmailAddressLongPressed(Activity activity, TTLScfPathModel scfPath, String email) {
// User long presses an email address in FAQ content
// Calling super will copy the selected email address to the device's clipboard
super.onFaqContentEmailAddressLongPressed(activity, scfPath, email)
}
@Override
public void onFaqContentPhoneNumberTapped(Activity activity, TTLScfPathModel scfPath, String phone) {
// User taps a phone number in FAQ content
// Calling super will open the device's phone app to dial the selected phone number
super.onFaqContentPhoneNumberTapped(activity, scfPath, phone)
}
@Override
public void onFaqContentPhoneNumberLongPressed(Activity activity, TTLScfPathModel scfPath, String phone) {
// User long presses a phone number in FAQ content
// Calling super will copy the selected phone number to the device's clipboard
super.onFaqContentPhoneNumberLongPressed(activity, scfPath, phone)
}
}
);
```
{% endcode %}
{% endtab %}
{% tab title="Kotlin" %}
{% code title="Application.kt" %}
```kotlin
import io.taptalk.taptalklive.TapTalkLive
import io.taptalk.taptalklive.Listener.TapTalkLiveListener
import io.taptalk.taptalklive.API.Model.ResponseModel.TTLErrorModel
import io.taptalk.taptalklive.API.Model.TTLScfPathModel
import io.taptalk.TapTalk.Model.TAPMessageModel
...
TapTalkLive.init(
CONTEXT,
APP_KEY_SECRET,
CLIENT_APP_ICON,
CLIENT_APP_NAME,
object : TapTalkLiveListener() {
override fun onInitializationCompleted() {
// Initialization success
}
override fun onInitializationFailed(error: TTLErrorModel?) {
// Initialization failed
}
override fun onNotificationReceived(message: TAPMessageModel?) {
// TapTalk.io SDK receives a message notification
// Calling super will show TapTalk.io's default notification for the app
super.onNotificationReceived(message)
}
override fun onCloseButtonInHomePageTapped(activity: Activity?) {
// User closes the home page
}
override fun onCloseButtonInCreateCaseFormTapped(activity: Activity?) {
// User closes the create case form
}
override fun onCloseButtonInCaseListTapped(activity: Activity?) {
// User closes the case list page
}
override fun onTaskRootChatRoomClosed(activity: Activity?) {
// A chat room activity was closed by user when no other activity in the application is present
// You may start another activity to keep the app open, otherwise the app will stay closed
}
override fun onSeeAllMessagesButtonTapped(activity: Activity?) {
// User taps the See All Messages button in home page
// Calling super will open the Case List page
super.onSeeAllMessagesButtonTapped(activity)
}
override fun onCreateNewMessageButtonTapped(activity: Activity?) {
// User taps the New Messages button in home or case list page
// Calling super will open the Create New Case form
super.onCreateNewMessageButtonTapped(activity)
}
override fun onCaseListItemTapped(activity: Activity?, lastMessage: TAPMessageModel?) {
// User taps a case from a list in home or case list page
// Calling super will open the selected chat room
super.onCaseListItemTapped(activity, lastMessage)
}
override fun onFaqChildTapped(activity: Activity?, scfPath: TTLScfPathModel?) {
// User taps a FAQ from a list in home or FAQ details page
// Calling super will open the selected FAQ details page
super.onFaqChildTapped(activity, scfPath)
}
override fun onCloseButtonInFaqDetailsTapped(activity: Activity?, scfPath: TTLScfPathModel?) {
// User closes the FAQ details page
}
override fun onTalkToAgentButtonTapped(activity: Activity?, scfPath: TTLScfPathModel?) {
// User taps the Talk to Agent button in home or FAQ details page
// Calling super will open the Create New Case form
super.onTalkToAgentButtonTapped(activity, scfPath)
}
override fun onFaqContentUrlTapped(activity: Activity?, scfPath: TTLScfPathModel?, url: String?) {
// User taps a url in FAQ content
// Calling super will open the selected url using TapTalk.io's in-app browser
super.onFaqContentUrlTapped(activity, scfPath, url)
}
override fun onFaqContentUrlLongPressed(activity: Activity?, scfPath: TTLScfPathModel?, url: String?) {
// User long presses a url in FAQ content
// Calling super will copy the selected url to the device's clipboard
super.onFaqContentUrlLongPressed(activity, scfPath, url)
}
override fun onFaqContentEmailAddressTapped(activity: Activity?, scfPath: TTLScfPathModel?, email: String?) {
// User taps an email address in FAQ content
// Calling super will open the device's email composer for the selected email address
super.onFaqContentEmailAddressTapped(activity, scfPath, email)
}
override fun onFaqContentEmailAddressLongPressed(activity: Activity?, scfPath: TTLScfPathModel?, email: String?) {
// User long presses an email address in FAQ content
// Calling super will copy the selected email address to the device's clipboard
super.onFaqContentEmailAddressLongPressed(activity, scfPath, email)
}
override fun onFaqContentPhoneNumberTapped(activity: Activity?, scfPath: TTLScfPathModel?, phone: String?) {
// User taps a phone number in FAQ content
// Calling super will open the device's phone app to dial the selected phone number
super.onFaqContentPhoneNumberTapped(activity, scfPath, phone)
}
override fun onFaqContentPhoneNumberLongPressed(activity: Activity?, scfPath: TTLScfPathModel?, phone: String?) {
// User long presses a phone number in FAQ content
// Calling super will copy the selected phone number to the device's clipboard
super.onFaqContentPhoneNumberLongPressed(activity, scfPath, phone)
}
}
)
```
{% endcode %}
{% endtab %}
{% endtabs %}
TapTalkLiveListener listens to changes in the following methods:
| Method Name | Invoked When |
|---|---|
| Method Name | Invoked When |
onInitializationCompleted() | TapTalkLive instance has finished initialization process. |
onInitializationFailed() | TapTalkLive instance initialization failed with an error. |
onNotificationReceived() | User receives new message from TapTalk.io through notification. Returns the newly received message. |
onCloseButtonInHomePageTapped() | User closes the home page. Returns the home activity instance. |
onCloseButtonInCreateCaseFormTapped() | User closes the create case form page. Returns the create case form activity instance. |
onCloseButtonInCaseListTapped() | User closes the case list page. Returns the case list activity instance. |
onTaskRootChatRoomClosed() | A chat room activity was closed by user when no other activity in the application is present (application will close). |
onSeeAllMessagesButtonTapped() | User taps the See All Messages button in home page. Returns the current activity instance. |
onCreateNewMessageButtonTapped() | User taps the New Messages button in home or case list page. Returns the current activity instance. |
onCaseListItemTapped() | User taps a case from a list in home or case list page. Returns the current activity instance and selected case's last message. |
onFaqChildTapped() | User taps a FAQ from a list in home or FAQ details page. Returns the current activity instance and selected SCF Path. |
onCloseButtonInFaqDetailsTapped() | User closes the FAQ details page. Returns the current activity instance and selected SCF Path. |
onTalkToAgentButtonTapped() | User taps the Talk to Agent button in home or FAQ details page. Returns the current activity instance and selected SCF Path. |
onFaqContentUrlTapped() | User taps a url in FAQ content. Returns the current activity instance, selected SCF Path, and the selected url. |
onFaqContentUrlLongPressed() | User long presses a url in FAQ content. Returns the current activity instance, selected SCF Path, and the selected url. |
onFaqContentEmailAddressTapped() | User taps an email address in FAQ content. Returns the current activity instance, selected SCF Path, and the selected email address. |
onFaqContentEmailAddressLongPressed() | User long presses an email address in FAQ content. Returns the current activity instance, selected SCF Path, and the selected email address. |
onFaqContentPhoneNumberTapped() | User taps a phone number in FAQ content. Returns the current activity instance, selected SCF Path, and the selected phone number. |
onFaqContentPhoneNumberLongPressed() | User long presses a phone number in FAQ content. Returns the current activity instance, selected SCF Path, and the selected phone number. |
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Register Uncaught Exception Handler
NSSetUncaughtExceptionHandler(&handleExceptions);
}
// Add delegate function to handle exceptions
- (void)handleExceptions:(NSException *exception) {
// Implement TapTalk Omnichannel handleException method
[[TapTalkLive sharedInstance] handleException:exception];
}
#import <TapTalkLive/TapTalkLive.h>
[[TapTalkLive sharedInstance] authenticateUserWithFullName:NAME
email:EMAIL
success:^(NSString *message) {
// Successfully authenticated user
}
failure:^(NSError *error) {
}];
// Called when there is a case created
tapliveCallback.tapliveOnCreateCase = (caseModel, fullname, email, url) => {
// action here
}
// Called when user send a message
tapliveCallback.tapliveOnSendMessage = (message, fullname, email, url) => {
// action here
}
// Called when LiveChat launcher is opened
tapliveCallback.tapliveOnOpen = () => {
// action here
}
// Called when LiveChat launcher is closed
tapliveCallback.tapliveOnClose = () => {
// action here
}