Integrating Custom Live Chat

Last updated last month

First step is to go to Settings -> Contact Options -> Live Chat and select Custom Application. Click Activate to save the configuration.

Airim provides a simple API for integration of your custom live chat solution.

One of the possible flow for integration is given below:

  1. User sees airim widget

  2. User interacts with airim widget and clicks the live chat icon

  3. Third party live chat software is opened

  4. User closes the live chat, hiding the live chat and showing airim

You can integrate your own live chat application using the code below :

window.airim('on','liveChatClick',function(){
openLiveChatApplication();
// hide the airim widget so it does not overlap with the live chat
window.airim('widgetHide');
})

Optionally you can also show the airim widget icon when the user closes the live chat application using a callback that the third party application provides.

function liveChatCloseCallback(){
// this line of code shows the airim widget icon
window.airim('widgetShow');
}

Examples

Chaport Integration

First step is to go to Settings -> Contact Options -> Live Chat and select Custom Application.

Click Activate to save the configuration.

You can directly copy paste the code below to integrate with Chaport.

<script type="text/javascript">
// hide the launcher on load so that only airim is visible
window.chaport.on('ready', function () {
window.chaport.hideLauncher();
})
// open chaport when live chat button is clicked
// hide the airim widget after opening
window.airim('on','liveChatClick',function(){
window.chaport.open();
window.airim('widgetHide');
})
// show the airim widget when the chaport widget is closed
window.chaport.on('widget.stateChange', function(state){
if(state.toState == 'collapsed'){
window.chaport.hideLauncher();
window.airim('widgetShow')
}
})
</script>

Intercom Integration

First step is to go to Settings -> Contact Options -> Live Chat and select Custom Application.

Click Activate to save the configuration.

You can directly copy paste the code below to integrate with Intercom.

Please make sure you have added the Intercom JS and Airim JS

<script type="text/javascript">
// copy paste below both airim and intercom js scripts
// hide the launcher on load so that only airim is visible
Intercom('update', {
"hide_default_launcher": true
});
// open Intercom when live chat button is clicked
// hide the airim widget after opening
window.airim('on','liveChatClick',function(){
Intercom('show');
window.airim('widgetHide');
})
// show the airim widget when the Intercom widget is closed
Intercom('onHide', function() {
window.airim('widgetShow')
});
</script>

ConvertFox / Gist Integration

First step is to go to Settings -> Contact Options -> Live Chat and select Custom Application.

Click Activate to save the configuration.

You can directly copy paste the code below to integrate with ConvertFox.

Please make sure you have added the ConvertFox JS and Airim JS

<script type="text/javascript">
// copy paste below both airim and convertfox js scripts
// hide the launcher on load so that only airim is visible
convertfox.chat('hide')
// open ConvertFox widget when live chat button is clicked
// hide the airim widget after opening
window.airim('on','liveChatClick',function(){
convertfox.chat('openNewConversation');
window.airim('widgetHide');
})
</script>