Remote control consent dialog
By default, Cobrowse will show a remote control consent dialog when an agent requests remote control. You may modify and customize the remote control consent prompt as you wish, using the SDK hooks described below.
Admin users may also disable this remote control consent prompt from your account settings if you prefer to remove it entirely: https://cobrowse.io/dashboard/settings
Web
iOS
Android
React Native
CobrowseIO.confirmRemoteControl = function() {
return new Promise(function(resolve, reject) {
// show your own UI here
// call resolve(true) to allow
// call reject() to reject
resolve(true)
});
};
To override the the default remote control consent prompt, you should implement the cobrowseHandleRemoteControlRequest: method of CobrowseIODelegate.
-(void) cobrowseHandleSessionRequest:(CBIOSession*) session {
// show your own UI here
// call [session setRemoteControl:kCBIORemoteControlStateOn callback:nil] to allow
// or [session setRemoteControl:kCBIORemoteControlStateRejected callback:nil] to reject
[session setRemoteControl:kCBIORemoteControlStateOn callback:nil]
}
To override the the default remote control consent prompt, you should implement the CobrowseIO.RemoteControlRequestDelegate interface on your CobrowseIO.Delegate.
@Override
public void handleRemoteControlRequest(@NonNull Activity activity, @NonNull Session session) {
// show your own UI here
// call session.setRemoteControl(Session.RemoteControlState.On, null) to accept
// or session.setRemoteControl(Session.RemoteControlState.Rejected, null) to reject
session.setRemoteControl(Session.RemoteControlState.On, null)
}
CobrowseIO.handleRemoteControlRequest = function(session) {
// Show your own UI here
// call session.setRemoteControl('on') to allow
// or session.setRemoteControl('rejected') to reject
session.setRemoteControl('on')
}

Example UIs

We've created a set of sample UIs that you may drop directly into your app or website as a starting point to customize the consent prompt.
Web
iOS
Android
React Native
// A generic consent dialog class
function Consent() {
var container = document.createElement('div');
function content(title, description){
return '\
<div style="background: rgba(50, 50, 50, 0.4); position: fixed; z-index: 2147483647; bottom: 0; top: 0; left: 0; right: 0">\
<div style="color: #333; font-family:sans-serif; line-height:140%; position:fixed; padding:25px; background:white; border-radius:15px; z-index:2147483647; top:50px; left:50%; width:75%; max-width:350px; transform:translateX(-50%); box-shadow:0px 0px 15px #33333322;">\
<div style="text-align:center; margin-top:10px; margin-bottom:20px"><b>'+title+'</b></div>\
<div>'+description+'</div>\
<div style="float:right; margin-top:40px; color:rgb(0, 122, 255);">\
<a class="cobrowse-deny" style="cursor:pointer; padding:10px;">Deny</a>\
<a class="cobrowse-allow" style="cursor:pointer; padding:10px; font-weight: bold;">Allow</a>\
</div>\
</div>\
</div>\
';
}
this.show = function(title, description) {
return new Promise(function(resolve) {
container.innerHTML = content(title, description);
container.querySelector('.cobrowse-allow').addEventListener('click', function(){ resolve(true); this.hide() }.bind(this));
container.querySelector('.cobrowse-deny').addEventListener('click', function(){ resolve(false); this.hide() }.bind(this));
if (document.body) document.body.appendChild(container);
}.bind(this));
}.bind(this);
this.hide = function() {
if (container.parentNode) {
container.parentNode.removeChild(container);
}
}.bind(this);
}
// Integration with Cobrowse
CobrowseIO.confirmRemoteControl = function() {
return new Consent().show('Remote Control Request', 'Do you want to allow remote control by ' + CobrowseIO.currentSession.agent().name + '?');
}
@interface CBAppDelegate : UIResponder <UIApplicationDelegate, CobrowseIODelegate>
@end
@implementation CBAppDelegate
// Custom consent dialog UI
UIAlertController *remoteControlPrompt;
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
CobrowseIO.instance.delegate = self;
// insert your license key here
CobrowseIO.instance.license = @"trial";
[CobrowseIO.instance start];
...
}
// Implement cobrowseHandleRemoteControlRequest:(CBIOSession*) to show a custom prompt
- (void) cobrowseHandleRemoteControlRequest:(CBIOSession *)session {
// replace the code below with your own confirmation prompt
remoteControlPrompt = [UIAlertController alertControllerWithTitle:@"Allow remote control?"
message:@"A support agent would like to control this app. Do you accept?"
preferredStyle:UIAlertControllerStyleAlert];
[remoteControlPrompt addAction: [UIAlertAction actionWithTitle:@"Accept"
style:UIAlertActionStyleDefault
handler:^(UIAlertAction * _Nonnull action) {
[session setRemoteControl:kCBIORemoteControlStateOn callback:nil];
remoteControlPrompt = nil;
}]];
[remoteControlPrompt addAction: [UIAlertAction actionWithTitle:@"Decline"
style:UIAlertActionStyleCancel
handler:^(UIAlertAction * _Nonnull action) {
[session setRemoteControl:kCBIORemoteControlStateRejected callback:nil];
remoteControlPrompt = nil;
}]];
UIViewController* appViewController = [self findPresentedViewController];
[appViewController presentViewController:remoteControlPrompt animated:YES completion:nil];
}
- (void)cobrowseSessionDidEnd:(CBIOSession *)session {
if (remoteControlPrompt) {
[remoteControlPrompt dismissViewControllerAnimated:NO completion:^{
remoteControlPrompt = nil;
}];
}
}
@end
public class MainApplication extends Application
implements CobrowseIO.Delegate, CobrowseIO.RemoteControlRequestDelegate {
// Custom consent dialog UI
private CustomRemoteControlConsentDialogFragment customRemoteControlConsent;
@Override
public void onCreate() {
super.onCreate();
CobrowseIO.instance().setDelegate(this);
...
}
/*
* Implement handleRemoteControlRequest(Activity, Session) from CobrowseIO.RemoteControlRequestDelegate
* to show a custom prompt
*/
@Override
public void handleRemoteControlRequest(@NonNull Activity activity, @NonNull Session session) {
// replace the code below with your own confirmation prompt
String tag = "RemoteControlConsentDialog";
FragmentManager fragments = activity.getFragmentManager();
FragmentTransaction transaction = fragments.beginTransaction();
Fragment previous = fragments.findFragmentByTag(tag);
if (previous != null) transaction.remove(previous);
customRemoteControlConsent = new CustomRemoteControlConsentDialogFragment();
customRemoteControlConsent.show(transaction, tag);
}
@Override
public void sessionDidEnd(@NonNull Session session) {
if (customRemoteControlConsent != null && customRemoteControlConsent.isAdded()) {
customRemoteControlConsent.dismiss();
customRemoteControlConsent = null;
}
}
}
And an example Fragment for showing the UI:
public class CustomRemoteControlConsentDialogFragment extends DialogFragment {
public CustomRemoteControlConsentDialogFragment() {
super();
}
@Override
public void onCreate(@NonNull Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setRetainInstance(true);
}
@Override
public void onDestroyView() {
if (getDialog() != null && getRetainInstance()) {
getDialog().setDismissMessage(null);
}
super.onDestroyView();
}
@NonNull
@Override
public Dialog onCreateDialog(@NonNull Bundle savedInstanceState) {
this.setCancelable(false);
return new AlertDialog.Builder(getActivity())
.setTitle("Allow remote control?")
.setMessage("A support agent would like to control this app. Do you accept?")
.setPositiveButton("Allow", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int w) {
Session session = CobrowseIO.instance().currentSession();
if (session != null) session.setRemoteControl(Session.RemoteControlState.On, null);
}})
.setNegativeButton("Reject", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int w) {
Session session = CobrowseIO.instance().currentSession();
if (session != null) session.setRemoteControl(Session.RemoteControlState.Rejected, null);
}
})
.create();
}
}
CobrowseIO.handleRemoteControlRequest = function(session) {
// Replace this with your own logic
Alert.alert(
'Remote Control Request',
'A support agent would like to take remote control of this app. Do you accept?',
[{
text: 'Reject',
onPress: () => session.setRemoteControl('rejected'),
style: 'cancel'
}, {
text: 'Accept',
onPress: () => session.setRemoteControl('on')
}], { cancelable: false })
}
}
Copy link