Jump to: navigation, search


Section: interaction-workspace
Default Value:
Valid Values: Name of a valid Script object of type Interaction Queue
Changes Take Effect: At the next attempt to request a conference with an Agent Group or with an agent of a particular Skill

Specifies the name of the Interaction Queue that is used by the routing-based feature for Apple Messages for Business. The following attached data is added by Workspace: IW_RoutingBasedOriginalEmployeeId, IW_RoutingBasedTargetId, IW_RoutingBasedTargetType, IW_RoutingBasedRequestType.


Section: interaction-workspace
Default Value: 5000
Valid Values: Any integer from 1 to 2147483647.
Changes Take Effect: At the next interaction

Specifies the maximum size of the message in bytes.


Section: interaction-workspace
Default Value: 20
Valid Values: Any integer from 1 to 1000
Changes Take Effect: At the next interaction

The number of previous chat sessions that are shown when the Agent clicks "See older messages...".

Handle an Apple Messages for Business Interaction

This section describes using Workspace Desktop Edition to receive and handle interactions coming from the Apple Messages for Business channel of Genesys Messaging Apps.

Receiving and Handling an Inbound Apple Messages for Business Interaction

If you are the selected internal target of an inbound Apple Messages for Business interaction, you receive a notice on your workstation desktop. You can decide to accept or reject the interaction.

ES MessAppsGuide ABCInteraction.png

If you accept it, the Apple Messages for Business Interaction window is displayed. The Apple Messages for Business Interaction window contains information about the interaction and the controls that you need to complete the interaction.

ES MessAppsGuide ABCPlugin.png

The message area appears similar to a smartphone-based messaging app client:

  • Client messages are left-aligned.
  • Agent messages are right-aligned.
  • Errors are centered.
  • The date for when the session started is centered.
  • The customer sees a typing notification when the agent is writing a message, as shown below.

ES MessAppsGuide ABCTyping.png

If the customer's contact information matches an entry in your contact database, the customer's name appears in the message area. Otherwise, a default nickname appears.

Additionally, if the customer previously contacted your company using Apple Messages for Business, these previous interactions appear in the message area. Depending on your settings and the number of previous messages, you might need to click see older messages... to see previous Apple Messages for Business from the current contact. Records of previous Apple Messages for Business interactions, as well as records of other interaction types, also appear in the Contact History view in Workspace.

  • Administrators can configure colors and text size. See the configuration options page for more information.
  • Administrators can configure the option applebcsession.transcript-interactions-count to specify how many messages from previous interactions appear in the chat message window.
  • Administrators can configure the option applebcsession.max-text-message-size to set the maximum size of the outbound text message, specified in bytes by converting the message string to UTF-8 encoding. A notification appears below the message area if the maximum value is exceeded. Some symbols might require additional characters, such as emojis.

Lesson: Handling an inbound Apple Messages for Business interaction

Purpose: To handle an inbound Apple Messages for Business interaction properly.



  1. A preview of the inbound interaction is displayed on your workstation desktop in an interactive-notification view. The Interaction Preview contains a summary of information that pertains to the interaction, including contact information and type of interaction. The Interaction Preview might also contain Case Information, which is part of the case data about the interaction.
  2. You can choose to accept or reject the interaction in the Interaction Preview by performing one of the following steps:
    • Click Accept to display the interaction.
    • Click Reject to return the interaction to the queue.
    • Do nothing. The interaction will time out and be redirected.
  3. To reply to the message, just enter text in the message area. You can copy and paste selected text.
  4. (Optional) If necessary, you can transfer the conversation to another agent, or invite another agent to join a conference.
    1. Click MSGA WhatsApp900 TransferIcon.png (transfer) or MSGA WhatsApp900 ConferenceIcon.png (conference), and select the type of target.
    2. Click the magnifying glass to search by name or phone number.
  • Before agents can request a conference, an administrator must:
    • Set the option intercommunication.applebcsession.queue before agents can request a conference via the Skill or Group option.
    • Create a Business Attribute of type Interaction Subtype with the name InternalConferenceInvite.
  • For more information on transfers, refer to the Workspace documentation topic Lesson: Starting an instant SMS transfer, which is similar to the Apple Messages for Business procedure.


Next Steps

  • You may wish to use some of the the features in described in Apple Messages for Business Functionality and Workspace Functionality below. When you are finished, click Done to stop the current interaction.The information is saved in the contact history and the Apple Messages for Business Interaction window is closed. You can also set a disposition code.

Apple Messages for Business-Specific Functionality

While you are interacting with your Apple Messages for Business contact, you can use the general Workspace functionality in the Apple Messages for Business Interaction window.

Some of the procedures and tasks below are media-specific, but you can apply the information when working with Apple Messages for Business interactions.
  • Use the Note to attach a note to the interaction history. See Managing Contact History.
  • View Case Information for the current interaction.
  • View and manage contact history. See Managing Contact History
  • View and manage contact information. See Lesson: Finding and viewing an interaction in the contact database.
  • Your account might be configured to let you assign an interaction with an unknown contact to a known contact in the contact database by using the Manual Contact Assignment feature.
  • Use the Standard Response Library for pre-written text for replies and comments. Click the vertical Responses button, as shown in the Using The Standard Response Library lesson.
  • Cross over into another media channel. If, as an agent, you learn other contact information, such as a contact's phone number or email address, you can manually enter this information on the Information tab. The corresponding choice for other media channels is then displayed when you click the Party Action menu that is next to the name of the contact. You can then reply by using a voice call, an email, an SMS message, or any other supported media channel for a Apple Messages for Business contact. Workspace displays a drop-down list of available channels to access a contact.
  • If you want to transfer the interaction to another internal target or consult with another internal target about the interaction, you can perform the following functions:
This page was last edited on September 19, 2022, at 04:58.
Comments or questions about this documentation? Contact us for support!