LogoLogo
WebsiteGuide & TutorialBlogBook a Demo
1.0.0
1.0.0
  • Acquire Developers Hub
  • Acquire
    • Acquire Build Requirement
      • Requirement For Acquire
      • Acquire Speedtest
  • JS API
    • JS Live Chat API
      • Description
      • Installation
      • Visitor
      • Thread
      • Conversation
      • User Verification
    • Quick Link Support
      • One Click Button
      • Social Media Share
    • Backend JS SDK
      • Setup Backend JS SDK
      • Demo Backend SDK
    • Advanced
      • Widget UI
      • Reference
  • Co Browse APIs
    • Acquire Co Browse
      • Co Browse API
  • Acquire API Events
    • WebRTC Related Events
  • iOS
    • SDK Setup Guide
      • Getting Started
      • Integration Guide (Core)
      • Integration Guide (Lite)
      • Manual Setup iOS
      • Acquire Account ID
    • SDK Configuration Example
    • iOS Cobrowse
    • Theme Setting
    • iOS Push Notifications
    • Verify your users
  • Android
    • Getting Started
      • Integration Guide (Core)
      • Integration Guide (Lite)
      • Start using Acquire
    • Acquire APIs
    • Acquire Delegates
    • Custom UI/widget
    • Cross Platform Integrations
  • Webhook API
    • Webhooks Basic
      • Introduction
      • Webhook Integrate Steps
      • Webhook Format
    • Webhook Events
      • On Chat Start
      • On Chat Accept
      • On Chat Message
      • On Chat Close
  • REST APIs
    • OAuth
      • Authorization
      • Tracklog
    • Profiles API
      • Profile List
      • Thread
      • Feedback
      • Profile Details
      • Message
      • Tags
      • Profile Agents
      • Campaigns
      • Profile Add Update
      • Profile Delete
      • Profile Visit History
      • Sender Emails
    • Chat
      • Chat Notes
    • Analytics
      • Chat Statistics
      • Team Analytics
      • Conversion Rate
      • Chat Tag
      • Co browsing
    • Agent
      • Agents List
      • Agent add
      • Edit / Get-agent
      • Update
    • Trigger
      • Triggers List
      • Triggers Detail
    • Operating Hours
      • Save Operating Hours
      • Get Operating Hours
    • Cobrowse
  • Chatbot API
    • Chat Bot
      • Integrate Your Chatbot
      • Dialog Flow V1 Chat-Bot
      • Dialog Flow V2 Chat-Bot
      • Dialog Flow Fulfillment & Custom Response
      • IBM Watson Integration
      • Amazon Lex Bot
      • Azure's QnA Maker
      • Webhook Calling & User Verification
      • Webhook For Reset Password
  • Knowledge Base APIs
    • Help Docs Setup
      • Get FAQ Categories
      • Get Setup Details
      • Get Side List
      • Get Article
      • Get Recent Article
      • Get Categorized Articles
      • Get Suggestion
  • Errors
    • API Error Handling
      • HTTP Responses
Powered by GitBook
On this page
  • Chat APIs:
  • Verify your users:
  • Secret Key
  • Logout visitor
  • User APIs:
  • Show Floating Video (PIP mode):
  • setMainVideoFrameSize(width, height):
  • setSecondaryVideoFrameSize(width, height)
  1. Android

Acquire APIs

Chat APIs:

Start chat module directly by calling startSupportChat()

AcquireApp.startSupportChat()

This method is used to open chat. To use this method AcquireApp instance is needed. So use this method after successful initialization.

Alternate Method : startDirectSupportChat(callType: CallType)

AcquireApp.startDirectSupportChat(CallType.VIDEO)
  • @param callType - TEXT, AUDIO, VIDEO

Use this method to start direct Audio/Video call request to agent. By this method , Audio/Video chat request will be visible to the agent and on answer to that chat will start Audio/Video call as soon as chat is connected.

Verify your users:

Make sure your users are who they claim to be with identity verification. Enforce identity verification to prevent other from pretend to be (third party) for entertainment or fraud logged-in users.

Generate an HMAC with SHA256 whenever a user logs into your app. Most web frameworks will have a method or library to help you do this. You'll need your app’s secret key and the email of the currently logged-in user.

Secret Key

<YOUR_SECRET_KEY>

For example, in Ruby on Rails we can generate our HMAC using a method called OpenSSL::HMAC.hexdigest, where the first parameter is the name of a hash function (we use SHA256), the second is your secret key, and the third is your user’s email.

OpenSSL::HMAC.hexdigest(
  'sha256', # hash function
  '<YOUR_SECRET_KEY>', # secret key (keep safe!)
  current_user.email # user's email address
)

Keep your secret key safe! Never commit it directly to your repository, client-side code, or anywhere a third party can find it.

To set up identity verification, you'll need to generate an HMAC on your server for each logged-in user and set in acquireIO SDK.

setVisitorHash must be called before init() takes place and must pass same email in setVisitorDetail().

AcquireApp.setVisitorHash([STRING_YOUR_HMAC_EMAIL])

First, you need to add email id in setVisitorDetail() method in SDK for uniquely identify your users. Note that if you set only visitor hash and email is not set then acquire can't identify visitor. So you need both method to verify visitor hash.

AcquireApp.setVisitorDetail([STRING_NAME], [STRING_EMAIL], [STRING_PHONE_NUMBER], [STRING_DEPARTMENT])

Get Visitor ID using method:

AcquireApp.getVisitorId()

Logout visitor

If you have set visitor hash (HMAC digest) and visitor just logged out from account and need to manage user integrity with agent, call method logOut(MutableLiveData loggedOut) to remove all acquire data from your app related to visitorHash use method :

AcquireApp.logOut(MutableLiveData loggedOut);

Pass null instead of MutableLiveData if you do not required a callback.

This method will reset visitor’s all data and stops all connections to the agent including ongoing call.

Caution: Please take a note that all methods of the sdk will stop working after logout so resulting in crash on some method calls. You need to re-initialize the sdk to start again.

User APIs:

Set user details

Set your user details as per your need

You can customize visitor’s identification by calling our sdk’s method setVisitorDetail.

Method Description : setVisitorDetail(name: String, email: String, phone: String, fields: JSONObject)

  • @param name - the name you want to display for the visitor

  • @param email - the email you want to display for the visitor

  • @param phone - the phone you want to display for the visitor

  • @param fields - pass the extra fields within a JSONObject e.g.

 val jsonObject = JSONObject()
        try {
            jsonObject.put([name] : "sample", [value] :"sucess")
        } catch (e: JSONException) {
            e.printStackTrace()
        }

Alternate visitor detail methods are:

setVisitorDetail(name: String, email: String, phone: String, department: String, fields: JSONObject)

Note: Use this method before initialization of sdk otherwise wont work.

To set visitor remarks use below method:

AcquireApp.setVisitorRemarks(visitorRemarks: String)

Show Floating Video (PIP mode):

Show Floating Video (PIP mode) everywhere in your app when audio/video call is active.

setMainVideoFrameSize(width, height):

Use this method to change the default size of the main video window size.

setSecondaryVideoFrameSize(width, height)

Use this method to change the default size of the secondary video window size.

PreviousStart using AcquireNextAcquire Delegates

Last updated 4 years ago

Use the field_key to pass in the JSONObject.