Maintenance Notice - PDF Generation
Dynamic PDF generation for web-based content is temporarily unavailable. This maintenance affects dynamic PDF files that are generated from either the HTML-based page or manual that you are viewing. Links that normally allow this functionality have been hidden, and will reappear as soon as the feature is restored.


Note: Access to static files, including PDF files that are not dynamically generated from our web-based content, is unaffected.

Jump to: navigation, search

RemoveParticipantFromConference

This operation is part of the Chat API section of the Web Services API.

Overview

This allows an agent to remove another agent from a conference or consultation. Only agents who are visible to all can do this.

Request URL /api/v2/me/chats/{id}
HTTP Method POST
Required Features api-multimedia

Parameters

Parameter Value
operationName RemoveParticipantFromConference
targetUri User URI to remove. Mandatory, if targetPath is not specified.
targetPath User path to remove. Mandatory, if targetUri is not specified.
text Optional. Text to send to customer.
messageType Optional. Must be provided together with text parameter. Defines the message type. Default value: Text
treatAs Optional. Must be provided together with text parameter. Specifies how message should be treated: Normal or System. Default value: Normal

Sample

Request

POST api/v2/me/chats/00010a9FSGFP001F
{
  "operationName": "RemoveParticipantFromConference",
  "targetUri": "http://10.10.15.212:9090/api/v2/users/c30d06daa1ea43b8be79f9b071f30d70"
}

Response

{
  "statusCode": 0
}

Notification

Successful

Agent1 First Notification

  {
      'chat': {
          'userData': {
              'IdentifyCreateContact': '3',
              'FirstName': 'test_consult_client',
              'LastName': 'Lastname',
              'RTargetObjectSelected': 'Chatdistributionforprocessing',
              'RVQID': '',
              'ChatServerAppName': 'ChatServer',
              'PegAGChatdistributionforprocessing': 1,
              'ChatServerHost': 'htcc-gf81',
              'RTargetObjSelDBID': '157',
              'CBR-IT-path_DBIDs': '',
              'ChatServerPort': '7030',
              'CBR-Interaction_cost': '',
              'CBR-contract_DBIDs': '',
              'ContactId': '00010a9FSGFP000M',
              'RTargetAgentSelected': 'htcc1',
              'RTargetTypeSelected': '2',
              'RTargetAgentGroup': 'Chatdistributionforprocessing',
              'RTargetRuleSelected': '',
              'RTargetPlaceSelected': 'htcc1',
              'CBR-actual_volume': '',
              'RTenant': 'Environment',
              'ChatServerDBID': '175',
              'RRequestedSkills': None,
              'ChatServerModeHA': 'true',
              'RRequestedSkillCombination': '',
              'RVQDBID': '',
              'RStrategyDBID': '894',
              'CustomerSegment': 'default',
              'ServiceType': 'default',
              'ServiceObjective': 0,
              'RTargetRequested': 'Chatdistributionforprocessing',
              'EmailAddress': 'Email@abc.com',
              'RStrategyName': 'Chatinboundstrategy',
              'Subject': 'Customersupport'
          },
          'state': 'Chatting',
          'capabilities': [
              'Transfer',
              'Leave',
              'Invite',
              'Consult',
              'SetInFocus',
              'SetDisposition',
              'AttachUserData',
              'DeleteUserData',
              'UpdateUserData',
              'Complete',
              'SendMessage',
              'SendStartTypingNotification',
              'SendStopTypingNotification'
          ],
          'uri': 'http: //10.10.15.212:9090/api/v2/chats/00010a9FSGFP001F',
          'participants': [
              {
                  'nickname': 'test_consult',
                  'type': 'Agent',
                  'uri': 'http: //10.10.15.212:9090/api/v2/users/914165a5841348aa94ccfccd56917443',
                  'visibility': 'All',
                  'participantId': '00AF52FCF0C0002F'
              },
              {
                  'nickname': 'test_consult_clientL',
                  'type': 'Customer',
                  'participantId': '00AF52FCF09E002D',
                  'visibility': 'All'
              }
          ],
          'id': '00010a9FSGFP001F'
      },
      'notificationType': 'ParticipantsUpdated',
      'messageType': 'ChatStateChangeMessage'
  }

Agent1 Second Notification

  {
      'messages': [
          {
              'index': 7,
              'from': {
                  'nickname': 'chat_consult',
                  'type': 'Agent',
                  'uri': 'http://10.10.15.212:9090/api/v2/users/c30d06daa1ea43b8be79f9b071f30d70',
                  'visibility': 'All',
                  'participantId': '00AF52FCF0C10030'
              },
              'timestamp': '2014-02-1308: 20: 59.000-0800',
              'visibility': 'All',
              'type': 'ParticipantLeft',
              'timestampSeconds': 1392308459000L
          }
      ],
      'notificationType': 'NewMessages',
      'messageType': 'MessageLogUpdated',
      'chatUri': 'http://10.10.15.212:9090/api/v2/chats/00010a9FSGFP001F'
  }

Agent2 First Notification

  {
      'chat': {
          'userData': {
              'IdentifyCreateContact': '3',
              'FirstName': 'test_consult_client',
              'LastName': 'Lastname',
              'RTargetObjectSelected': 'Chatdistributionforprocessing',
              'RVQID': '',
              'ChatServerAppName': 'ChatServer',
              'PegAGChatdistributionforprocessing': 1,
              'ChatServerHost': 'htcc-gf81',
              'RTargetObjSelDBID': '157',
              'CBR-IT-path_DBIDs': '',
              'ChatServerPort': '7030',
              'CBR-Interaction_cost': '',
              'CBR-contract_DBIDs': '',
              'ContactId': '00010a9FSGFP000M',
              'RTargetAgentSelected': 'htcc1',
              'RTargetTypeSelected': '2',
              'RTargetAgentGroup': 'Chatdistributionforprocessing',
              'RTargetRuleSelected': '',
              'RTargetPlaceSelected': 'htcc1',
              'CBR-actual_volume': '',
              'RTenant': 'Environment',
              'ChatServerDBID': '175',
              'RRequestedSkills': None,
              'ChatServerModeHA': 'true',
              'RRequestedSkillCombination': '',
              'RVQDBID': '',
              'RStrategyDBID': '894',
              'CustomerSegment': 'default',
              'ServiceType': 'default',
              'ServiceObjective': 0,
              'RTargetRequested': 'Chatdistributionforprocessing',
              'EmailAddress': 'Email@abc.com',
              'RStrategyName': 'Chatinboundstrategy',
              'Subject': 'Customersupport'
          },
          'state': 'LeftChat',
          'capabilities': [
              'SetInFocus',
              'Complete',
              'SetDisposition',
              'AttachUserData',
              'DeleteUserData',
              'UpdateUserData'
          ],
          'uri': 'http: //10.10.15.212: 9090/api/v2/chats/00010a9FSGFP001F',
          'participants': [
              {
                  'nickname': 'test_consult',
                  'type': 'Agent',
                  'uri': 'http: //10.10.15.212: 9090/api/v2/users/914165a5841348aa94ccfccd56917443',
                  'visibility': 'All',
                  'participantId': '00AF52FCF0C0002F'
              },
              {
                  'nickname': 'test_consult_clientL',
                  'type': 'Customer',
                  'participantId': '00AF52FCF09E002D',
                  'visibility': 'All'
              }
          ],
          'id': '00010a9FSGFP001F'
      },
      'notificationType': 'ParticipantsUpdated',
      'messageType': 'ChatStateChangeMessage'
  }

Agent2 Second Notification

  {
      'messages': [
          {
              'index': 7,
              'from': {
                  'nickname': 'chat_consult',
                  'type': 'Agent',
                  'uri': 'http: //10.10.15.212: 9090/api/v2/users/c30d06daa1ea43b8be79f9b071f30d70',
                  'visibility': 'All',
                  'participantId': '00AF52FCF0C10030'
              },
              'timestamp': '2014-02-1308: 20: 59.000-0800',
              'visibility': 'All',
              'type': 'ParticipantLeft',
              'timestampSeconds': 1392308459000L
          }
      ],
      'notificationType': 'NewMessages',
      'messageType': 'MessageLogUpdated',
      'chatUri': 'http: //10.10.15.212: 9090/api/v2/chats/00010a9FSGFP001F'
  }

Agent2 Third Notification

  {
      'chat': {
          'userData': {
              'IdentifyCreateContact': '3',
              'FirstName': 'test_consult_client',
              'LastName': 'Lastname',
              'RTargetObjectSelected': 'Chatdistributionforprocessing',
              'RVQID': '',
              'ChatServerAppName': 'ChatServer',
              'PegAGChatdistributionforprocessing': 1,
              'ChatServerHost': 'htcc-gf81',
              'RTargetObjSelDBID': '157',
              'CBR-IT-path_DBIDs': '',
              'ChatServerPort': '7030',
              'CBR-Interaction_cost': '',
              'CBR-contract_DBIDs': '',
              'ContactId': '00010a9FSGFP000M',
              'RTargetAgentSelected': 'htcc1',
              'RTargetTypeSelected': '2',
              'RTargetAgentGroup': 'Chatdistributionforprocessing',
              'RTargetRuleSelected': '',
              'RTargetPlaceSelected': 'htcc1',
              'CBR-actual_volume': '',
              'RTenant': 'Environment',
              'ChatServerDBID': '175',
              'RRequestedSkills': None,
              'ChatServerModeHA': 'true',
              'RRequestedSkillCombination': '',
              'RVQDBID': '',
              'RStrategyDBID': '894',
              'CustomerSegment': 'default',
              'ServiceType': 'default',
              'ServiceObjective': 0,
              'RTargetRequested': 'Chatdistributionforprocessing',
              'EmailAddress': 'Email@abc.com',
              'RStrategyName': 'Chatinboundstrategy',
              'Subject': 'Customersupport'
          },
          'state': 'LeftChat',
          'capabilities': [
              'SetInFocus',
              'Complete',
              'SetDisposition',
              'AttachUserData',
              'DeleteUserData',
              'UpdateUserData'
          ],
          'uri': 'http: //10.10.15.212: 9090/api/v2/chats/00010a9FSGFP001F',
          'participants': [
              {
                  'nickname': 'test_consult',
                  'type': 'Agent',
                  'uri': 'http: //10.10.15.212: 9090/api/v2/users/914165a5841348aa94ccfccd56917443',
                  'visibility': 'All',
                  'participantId': '00AF52FCF0C0002F'
              },
              {
                  'nickname': 'test_consult_clientL',
                  'type': 'Customer',
                  'participantId': '00AF52FCF09E002D',
                  'visibility': 'All'
              }
          ],
          'id': '00010a9FSGFP001F'
      },
      'notificationType': 'StatusChange',
      'messageType': 'ChatStateChangeMessage'
  }

Agent2 Fourth Notification

  {
      'referenceId': 20,
      'chat': {
          'userData': {
              'IdentifyCreateContact': '3',
              'FirstName': 'test_consult_client',
              'LastName': 'Lastname',
              'RTargetObjectSelected': 'Chatdistributionforprocessing',
              'RVQID': '',
              'ChatServerAppName': 'ChatServer',
              'PegAGChatdistributionforprocessing': 1,
              'ChatServerHost': 'htcc-gf81',
              'RTargetObjSelDBID': '157',
              'CBR-IT-path_DBIDs': '',
              'ChatServerPort': '7030',
              'CBR-Interaction_cost': '',
              'CBR-contract_DBIDs': '',
              'ContactId': '00010a9FSGFP000M',
              'RTargetAgentSelected': 'htcc1',
              'RTargetTypeSelected': '2',
              'RTargetAgentGroup': 'Chatdistributionforprocessing',
              'RTargetRuleSelected': '',
              'RTargetPlaceSelected': 'htcc1',
              'CBR-actual_volume': '',
              'RTenant': 'Environment',
              'ChatServerDBID': '175',
              'RRequestedSkills': None,
              'ChatServerModeHA': 'true',
              'RRequestedSkillCombination': '',
              'RVQDBID': '',
              'RStrategyDBID': '894',
              'CustomerSegment': 'default',
              'ServiceType': 'default',
              'ServiceObjective': 0,
              'RTargetRequested': 'Chatdistributionforprocessing',
              'EmailAddress': 'Email@abc.com',
              'RStrategyName': 'Chatinboundstrategy',
              'Subject': 'Customersupport'
          },
          'state': 'Completed',
          'capabilities': [
              
          ],
          'uri': 'http: //10.10.15.212: 9090/api/v2/chats/00010a9FSGFP001F',
          'participants': [
              {
                  'nickname': 'test_consult',
                  'type': 'Agent',
                  'uri': 'http: //10.10.15.212: 9090/api/v2/users/914165a5841348aa94ccfccd56917443',
                  'visibility': 'All',
                  'participantId': '00AF52FCF0C0002F'
              },
              {
                  'nickname': 'test_consult_clientL',
                  'type': 'Customer',
                  'participantId': '00AF52FCF09E002D',
                  'visibility': 'All'
              }
          ],
          'id': '00010a9FSGFP001F'
      },
      'notificationType': 'StatusChange',
      'messageType': 'ChatStateChangeMessage'
  }
This page was last edited on November 30, 2017, at 18:03.

Feedback

Comment on this article:

blog comments powered by Disqus