You need to install iAdvize chat on your mobile app? This article will guide you step by step through the implementation of the mobile SDK V2.
1. Upstream work
- Before you begin implementation on your end, make sure with your CSM that the Mobile SDK v2 functionality is enabled for branding
- Also, make sure to review the Mobile SDK v2 technical documentation with your development team before you start your exchanges: https://developers.iadvize.com/documentation/mobile-sdk
- As well as all the SDK articles available here in this knowledge base
- We are at your disposal in case of questions during this preparation phase
Once these steps are validated, you are ready to start the implementation!
2. Prerequisites
- Profile: administrator and developer
- The version of your app:
- iOS: minimum iOS 12
- Android: minimum API 21
3. Engage your visitors from the Mobile SDK
Go to the "Engagement" section > Campaigns
- To create your campaign and mobile engagement rule


Save the targeting rule ID (highlighted here in blue) as the developer will need it to integrate these rules of engagement within the Mobile SDK v2.
From the version 2.5 and onward the SDK supports video conversations, the targeting rule creation process is the same but you will also need to note for which type of conversation channel the rule will be used (chat or video) as it will be needed for the integrator to trigger it.
In the case of a video targeting rule, you will need to ensure that the correponding respondents are setup to answer video conversations.

4. Activate the Mobile SDK push notifications
In order to receive notifications relative to the iAdvize Messenger SDK conversations in your mobile application, you should configure some push notifications information on the iAdvize administration website.
Go to Engagement > Settings and select Mobile App channel in the dropdown list
Go to Engagement > Settings and select Mobile App channel in the dropdown list

You can then provide push notifications information for iOS and/or Android.
iOS |
On iOS you will have to provide a certificate and private key pair. Starting with a .p12 file you can run this terminal command:
openssl pkcs12 -in AppProductionPushCertificate.p12 -out Cert.pem -nodes -clcerts then you can run: cat Cert.pem Copy/paste certificate and private key (including their separators -----BEGIN----- / -----END-----) in the form as printed in the terminal. |
Android |
For Android, you will have to provide the Firebase Cloud Messaging (FCM) server key.
From your FCM console click on the Settings button (right of Project Overview) then Project Settings:
![]() The server key is visible in the Cloud Messaging tab: ![]() Copy/paste this server key in the iAdvize form. |
⚠️ It won't be possible to start a conversation is this setting is not fulfilled.
5. Activate the satisfaction survey at the end of the conversation
You can measure your customers' satisfaction (CSAT: Customer Satisfaction), their capacity to recommend you to their friends (NPS: Net Promoter Score) and give them the possibility to leave a comment at the end of the conversation.
Go to the admin in the Engagement > Settings > Chat > Satisfaction Survey section and check the box "Send the customer a satisfaction survey".
6. Find your project identifier
As an iAdvize customer you will be assigned to one or more projects on the iAdvize Administration website. A project contain specific configurations for a website and/or your mobile application. Each project is identified by a unique ID that you can find on the iAdvize Administration website.
First select your project using the dropdown list:

Then the project identifier can be found in the URL, it is the integer named siteId:

Save that project id, the developer will need it for the SDK integration.
7. Start integrating the Mobile SDK into your apps
Once you have completed these steps, the developer can start integrating the iAdvize Messenger SDK into your apps. Don’t forget to provide him/her with:
- the project identifier
- all the relevant targeting rule identifiers
- the integration guide: https://developers.iadvize.com/documentation/mobile-sdk