Communication Server

Comm Server doesn't proceed to submit incoming message from Line to Workqueue/TMAC

a) Issue Description

When a Line user sends message, message reaches Comm Server via SMM, but Comm Server doesn't proceed to send it to Workqueue/TMAC and seems to stop at Session Started event. No logs after the one shown below

b) Cause

This happens because of enable.callagentMsg config set to true in Comm server run time configs

c) Troubleshooting

With enable.callagentMsg set to true in Comm server rconfig, Comm server expects another message from requester after initial message to start a conversation. This is required when we use text chat interactions using Comm proxy wherein first message is usually considered as just a session start request and subsequent messages are actual messages to be responded to. Hence, Comm Server waits for a second message to come from same user and then sends to TMAC for a response. Since we are using SMM Proxy and Server for interactions from social media, every message is to be responded to, including the first, enable.callagentmsg config in rconfig needs to be set to false. Both the snapshots of rconfig key and port in comm server config and callagentmsg config in rconfig are given below

In above screenshot of comm server config, rconfig port is 65500 and appname is tchat. so, you can open rconfig in the same server with url http://localhost:65500/rconfig_tchat as shown below, find the enable.callagentmsg config, select and change value to false.

 

System.DllNotFoundException: Unable to load DLL 'libsip.dll'

a) Issue Description:

TComm Service throws error on start and "Unable to load libsip.dll" error is observed in TComm logs as below

2019-10-01 17:00:24,867 [5] ERROR TextchatServer.Program - Config Error(1):System.DllNotFoundException: Unable to load DLL 'libsip.dll'

b) Cause

TComm is not starting due to missing Microsoft Visual C++ 2010 x64 redistributable

c) Troubleshooting

Microsoft Visual C++ Redistributable 2010 x64 is one of the pre-requisites for TComm Server Installation. Make sure to download and install the redistributable from https://www.microsoft.com/en-in/download/details.aspx?id=14632 and then start the TComm Service.

Chat disconnected in Queue while Agent did a Blind Transfer to Queue

Issue:
Agent A transferred a chat to the Queue. While the chat was in Queue, it got disconnected even before Agent B could receive the chat.

Component to Check:  Communication Server

What to Check:

  • Find rconfig.port & rconfig.appname key in Communication Server config. Go to the browser and type
     http://localhost:<port>/<appname>
  • Enter the username and password
  • Check the value of "blindtransfer.timeout"

Log Keywords:

In Communication Server logs, 'Waiting with blind transfer timeout" keyword can be found as below.

If the value rconfig is set to 3000, then 3 seconds after Agent A transfers the chat to the Queue, Communication Server will disconnect the chat.

Resolution:

Increase the value of blindtransfer.timeout key via rconfig

or

stop the communication service, update the below key in rconfig.dat file and start the service.

<config name="blindtransfer.timeout" value="60000" type="uint" />

 

Textchat gets disconnected immediately after being received on TMAC

Issue Description:

As soon as the Textchat is received on TMAC, the chat gets disconnected

Components to Verify:
ComponentWhat to CheckWhere to Check
TMAC Server.1. Check TMAC - template.config for the key "TextChat_ServerConfig"
2. In TextChatServerConfig.json, check for "TextChatServerIP"," TextChatServerPort" & "ChatNumbers" configured.
TMAC - template.config
Communication Server1. Check TextChatServer.exe.config for the keys "cid.rangeStart", "cid.rangeEnd" & the listener port for agent as below

<add type="tcp" port="2233" user="agent"/>

The port and the range should be same as that configured in TMAC Server -> TextChatServerConfig.json

TextChatServer.exe.config
Keywords to Search:
ComponentKeywordsLog Path
TMAC Server LogsStart FailedGo to TMACServer folder -> AMACWebServerWin.exe.config -> key ‘Log4NetConfigFile’ will have the path to TMACServerLogs
Troubleshooting:
ComponentDetails
TMAC ServerCheck the output telnet <CommunicationServer> <agentPort> from Application Server where TMACServer is hosted

 

Staffed agents check by Communication Server gives -2 from TMAC Server

Issue Description:

Communication Server before initiating a call to Avaya CM Skill will send the VDN to TMAC Server to check the number of agents staffed for that particular skill. The response from TMAC  shows Staffed -2

Components to Verify:
ComponentWhat to CheckWhere to Check
TMAC Server.1. Check TMAC server logs if the request from Chat Server has reached TMAC
2. Check if TMAC Server is able to communicate with SMSAPI Service
TMAC server logs.
Communication Server1. Check if the correct TMAC Server end points are configuredrconfig - csodetails.url
Keywords to Search:
ComponentKeywordsLog Path
TMAC Server LogsGetQueueStatusGo to TMACServer folder -> AMACWebServerWin.exe.config -> key ‘Log4NetConfigFile’ will have the path to TMACServerLogs
Communication Server LogsStaffed =Go to CommunicationServer folder -> TextChatServer.exe.config -> key ‘Log4NetConfigFile’ will have the path to Communication Server Logs
Troubleshooting:
ComponentDetails
TMAC Server LogsCheck the output of GetQueueStatus
Communication Server LogsCheck the status code for Staffed:
-2 : VDN is invalid or cannot get the VDN Details from SMSApi
-3 : Invalid Skill
-4 : TSAPI Failed. Unable to get the Queue

 

Single Chat request from customer shows double on TMAC Wallboard - Work Queue Routing

Issue Description:

Customer initiates a chat, on TMAC wallboard, the Calls in Queue is seen as 2 instead of 1.

Components to Verify:
ComponentWhat to CheckWhere to Check
Communication ServerCheck Communication Server logs for keyword - "AddWorkItemWithCustomIdentifier" is written twice for the same Chat Session ID.Communication server logs.
Keywords to Search:
ComponentKeywordsLog Path
Communication ServerAddWorkItemWithCustomIdentifierGo to Communication Server folder -> TextChatServer.exe.config -> key ‘Log4NetConfigFile’ will have the path to Communication Server Logs
Troubleshooting:
ComponentDetails
Communication Server
  1. Open rconfig in the browser of application Server: http://localhost:<rconfig.port>/<rconfig.appname>
  2. <rconfig.port> & <rconfig.appname>keys are present in TextChatServer.exe.config
  3. Enable.CallAgentMsg key should be set to 'true'

 

Customer details are Encrypted on TMAC during Chat Interaction

Components to Verify:
ComponentWhat to CheckWhere to Check
Communication ServerIn rConfig - Check the value of 'enable.decrypt' keyhttp://localhost:<port>/<name>
The keys is defined in Communication TextChatServer.exe.config:<name> - file name
<port> - port on which the app is running
Communication ServerIn rConfig - Check the file name configured at 'decrypt.keyfile' keyhttp://localhost:<port>/<name>
The keys is defined in Communication TextChatServer.exe.config:<name> - file name
<port> - port on which the app is running
Next Steps:
  1. Change the 'enable.decrypt' value to 'true'
  2. Check the 'decrypt.keyfile' file and compare if private & public key are of the same set.

Text chat session timeout.

Issue Description:

Chat end reason is empty in OCM.

Components to Verify:
ComponentWhat to CheckWhere to Check
TMAC Server.Get the UCID/SIP ID and search for connection handle in the TSAPI events. Filter with the connection handle and go to TSAPI Disconnect Event.

Check for the disconnect cause in the disconnect event.

In normal scenarios disconnect cause will be  as -1

Apart from this we can classify it as an abnormal disconnect.

Also check if agent has exceed the chat duration limit.(check it the Limit is Exceed in the Session- Expries field)

TMAC server logs

Text chat server LibSip Logs

Keywords to Search:
ComponentKeywordsLog Path
TMAC Server LogsDisconnect:Cause:Go to TMACServer folder -> AMACWebServerWin.exe.config -> key ‘Log4NetConfigFile’ will have the path to TMACServerLogs
Troubleshooting:
ComponentDetails
TMAC Server Logs1) Check when the call got disconnected
Next Steps:
ComponentDetailsHow to perform operation
AESTo check with AES Team why the disconnect cause is different and what is the reasonNA