CategoriesView All

Event

Instabot is a conversion chatbot for mobile apps. Easily create, launch, and edit your bot on the fly, as well as see rich analytics in real-time. Instabot understands users’ needs, and increases conversion and retention rates.

Enable the Instabot Integration

  1. Add the mParticle SDKs to your iOS and/or Android apps. See the docs for your platform here.

  2. Connect your iOS and/or Android workspaces to Instabot. You will need to provide your Instabot API key, which you can access from your Instabot App Settings Page. For more information on setting up a new mParticle connection, see the Platform Guide.

    Configuration Settings

    Setting Name Data Type Default Value Description
    API Key string API Key found in the Instabot Portal Application Settings Page

User Identity

Instabot recommends that you identify your users with a unique identifier when they sign in to your app. mParticle will automatically map the Email and Customer ID identity-types onto Instabot’s setUser() APIs. However, when enabling the integration you must pick which of the two identity types that you’d like to use. Navigate to the data filters configuration for your workspace and disable either Customer ID, Email, or both if you would prefer not to send any ID to Instabot, keeping all users anonymous.

Kit Integration

mParticle’s Instabot integration requires that you add the Instabot Kit to your iOS or Android app. Just by adding the binary to your app:

  • The mParticle SDK will initialize Instabot SDK per their documentation, using the API Key provided above, and will also forward all required UIApplication (iOS) and Activity (Android) lifecycle events to the Instabot SDK.
  • mParticle will automatically forward FCM and GCM tokens and sender IDs (Android), as well as APNS tokens (iOS).
  • Events that you log via mParticle’s API will be automatically mapped onto Instabot’s analogous event tracking APIs.
  • Customer ID and Email identifiers will be passed to the Instabot Kit (see above regarding User Identity configuration).

Add the Kit to your app

mParticle publishes the Instabot Kit as separate iOS and Android libraries which have a transitive dependency on the mParticle core libraries. You can add them to your app via Carthage, Cocoapods, or Gradle:

# Sample Podfile

source 'https://github.com/CocoaPods/Specs.git'

use_frameworks!

target '<Your Target>' do
    pod 'mParticle-Instabot'
end
// Sample build.gradle

dependencies {
    // Ensure the Kit version matches that of the mParticle Core SDK that you're using
    compile 'com.mparticle:android-instabot-kit:4.16.4' 
}

Reference the Apple SDK and Android SDK guides to read more about kits.

Track Events

The Instabot Kit will forward app events and eCommerce events to Instabot. Refer to the iOS and Android SDK docs for details on instrumenting your app for event tracking:

Accessing Instabot APIs

For some use cases and APIs you may need to perform direct API calls to the Instabot SDK. The Instabot Kits both surface references to core Instabot SDK objects.

[[MParticle sharedInstance] kitInstance:@(MPKitInstanceInstabot) completionHandler:^(id  _Nullable instabotInstance) {
     if (instabotInstance) {

     }
}];
Instabot instabot = (Instabot) MParticle
                .getInstance()
                .getKitInstance(MParticle.ServiceProviders.INSTABOT);
if (instabot) {

}

Kit Source and Sample Applications

The source code for each kit, as well as sample apps, are available on Github: