Agent`s Handbook

You are reading a handbook that offers practical advice for chat agents who use Webim. This is a reference book, you can read it in any order. This handbook contains all or almost all the information you may need while using Webim as a chat agent.

How to log in for the first time

To get started as a chat agent, you need to log in to Webim Control Panel first. Perform the following steps:
  1. Ask your company administrator for a personal login (your email address used while signing up) and a password.
  2. Launch a browser. For Webim Control Panel, we strongly recommend and only support Google Chrome version 42 or up.
  3. Open the Webim home page Webim main page opens.
  4. On this web page, click the following link in the page header: «Войти / Зарегистрироваться (Log In / Sign Up)». The page «Log In to Webim» opens:

    Webim Login page:

    Switch to English on Webim Login page

  5. You may need to switch to English now, if you see the page content displayed in another language. For this, click a flag in the page header and choose English on the context menu:

    Switch to English:

    Switch to English on Webim Login page

  6. Enter your email address as a login and your password. Choose Status «Online». You may want to Remember your input. Then click Log In.
  7. If your login & password are valid, then the main page of Webim Control Panel opens. If you have only agent rights, after authorization you will see Webim Workspace.
    On the page with Workspace (as well as on the each page of Control Panel) you will see side menu with several settings.Please note that administrator has more commands, when he or she logs in to Webim Control Panel, because an administrator has top privileges and manages other teammates: supervisors and agents. That's why some settings are available for agents, but many of them aren't.
  8. Here is Workspace - the page where agent communicates with visitors.

    Initial Workspace of an Agent:

    Initial Workspace of an Agent

  9. Wait for a new visitor on your site.

Setting up Webim app for Windows

For setting up Webim app for Windows click here.

Detecting new visitors who need assistance

When a new visitor opens your site and asks for assistance, Webim first of all needs to notify agents, by any means.Agents who have Webim Control Panel opened in a browser (any other page but Workspace) will notice a red sign in a toolbar (highlighted on the following picture):

New visitor notification in the Control Panel toolbar:

New visitor notification in the Control Panel toolbar

When you click the highlighted icon, Workspace opens.

Agents who have Workspace already opened will see visitors in the queue Waiting for an answer:

New visitor in Workspace:

New visitor notification in Workspace

Agents who switched to another tab from Webim Control Panel in their browser, will notice a blinking asterisk at the caption of the Webim tab, as well as a sound signal (earcon).

Webim notifies about a new visitor in Google Chrome browser:

Webim notifies about a new visitor in Google Chrome browser

Agents who have their browser minimized or in background, will notice a push notification in the bottom right corner of a screen (supported for Google Chrome browser only, agent also needs to allow push notifications from Webim):

Push notification about a new visitor from Google Chrome:

Push notification about a new visitor from Google Chrome

Agents who have previously installed Webim App for Microsoft Windows will notice push notifications from their apps:

Push notification from Webim App for Microsoft Windows:

Push notification from Webim App for Microsoft Windows

Mouse click on push notifications opens agent's Workspace.

How to select a visitor on the list and start chatting

To start chatting with a visitor, perform the following steps:
  1. Open Webim Control Panel, choose the Workspace page.
  2. First time Google Chrome will ask you to Allow or Block push notifications for Webim:

    Enabling push notifications for Webim in Google Chrome:

    Enabling push notifications for Webim in Google Chrome

    Click Allow.

  3. Select a visitor in the queue Waiting for the Answer, single-click a block with a selected visitor.
  4. Chat interface, information about a visitor and available commands will be displayed on the Workspace page:

    Webim Workspace:

    Webim Workspace

    Workspace interface consists of the following components:

    1. A visitor list that contains the following visitor groups:
      • Waiting for an Answer - visitors who need assistance right now;
      • In Chat with You - you are chatting with visitors in this group now;
      • Offline Requests - requests sent by visitors when all agents were “Offline” and messages sent by users of mobile apps;
      • General Queue - this group appears only if Auto-assign is enabled in Additional Features (in Settings); Webim puts visitors in this group if all agents are busy (see Maximum chats per operator also in Additional Features);
      • In chat with others - visitors who are now chatting with other agents; this feature is available for supervisors and administrators; for other agents, it is only available if the Hide another chats feature is disabled (see Additional Features);
      • Recent chats - visitors who left chats and/or site recently, visitors who browse your site and do not ask for assistance, and so on.
    2. Current chat history: log of all actions and messages of an agent and a visitor
    3. Button to Workspace
    4. Switch between chats with visitors and with other agents
    5. Switch between chat and co-browsing modes
    6. Information about a visitor
    7. Details about current visit
    8. Web pages of your site that are currently opened by this visitor
    9. Your chat box where you type in messages

How to type in your answer or choose a template

  1. When you are in chat with a visitor and Webim Workspace is opened in your browser (see above), start typing your message to the visitor in the chat box.
  2. While you type, Webim automatically suggests templates that contain this text:

    Automatically suggested templates in your Webim chat box:

    Automatically suggested templates in your Webim chat box

  3. Choose one of the templates on this list by pressing keys Up and Down on your keyboard or with your mouse.
  4. Press Enter, and an answer which was carefully prepared beforehand will be sent to a visitor.

You can also add the text you typed in as a personal template by clicking Answer templates and choosing Add current message as a predefined template.

How to process offline requests

Offline requests differ from online chats. Such a request can appear in one of the following cases:
  • a visitor posted this request on your site by clicking an offline Webim button, when none of agents were online
  • a visitor answered one of those automatic invitations, configured to appear when none of agents are online
  • a visitor posted this request in a client mobile app for iOS or Android

An offline request does not imply an immediate answer. When some agent answers it, the answer will be sent by email (in case visitor has provided it before). Agent will see a system message that his answer was sent on visitor's email.

If this offline request comes from a mobile app, the answer will be displayed in the same app.

An agent can identify a visitor who uses a mobile app by looking at the Landing Page in Contact Details. For those visitors it will display "iOS Client" or "Android Client" respectively.

How to change your status

An agent can choose any of the following six statuses:
  • Online
  • Invisible
  • Dinner
  • Before Dinner
  • Private Break
  • Short Break
  • Offline Processing
  • Offline

To change a status, click an arrow located to the right from Online in the header of Webim Control Panel:

Webim agent selects a status:

Webim agent selects a status

Status informs visitors and colleagues about the current work mode of an agent:

  • Online - general work mode of an available agent
  • Invisible - an agent can assist visitors, chat, have access to all data. Other agents see him/her, but visitors do not, and Webim does not automatically assign chats to such an agent. This status is appropriate for a team leader who does not chat with visitors directly in a normal situation, but when it is critical and all agents are busy or cannot help, this leader joins the conversation.
  • Dinner - agents choose this status when they leave for a dinner during a day.
  • Before Dinner - agents choose this status in advance before leaving for a dinner. In this mode Webim does not assign chats to such an agent. As soon as all active chats are closed, Webim changes this status to Dinner.
  • Private Break - agents choose it when they leave for some private reasons.
  • Short Break - agents choose it when they are off for a short period of time (up to 15 min).
  • Offline Processing - only offline chats are routed to agents with this status. This status appeared in Webim 10.1. For turning it on, system parameter offline_chat_processing should be set as true.
  • Offline - an agent does not assist visitors at this time, have no access to chats with visitors and agents and to their data. However, this agent can access all other functionality of Webim Control Panel.

Functionally, there is no difference between Invisible, Dinner, Private Break and Short Break. Names are different but not the system behaviour.

Webim tracks and saves data including agent status and its changes. This data can be displayed in the Statistics Module, see Stats by Operators Time table/report.

How to chat with other agents

Webim Control Panel allows agents to chat with their colleagues as well as with visitors.You can use it to take advice, broadcast news, or other information important for work.

To get into inter-agents chat, please open your Workspace and click Agents link at the page header:

Switch between Webim chat with visitors and agents:

Switch between Webim chat with visitors and agents

Chat window opens:

Webim inter-agents chat:

Webim inter-agents chat

Inter-agents chat is global, i. e. any agent can see each message by any other agent. There is a list of all agents to the right side of the screen. You can use it to quickly insert names of your cooleagues by clicking them.

If you miss inter-agents chat in your Webim Control Panel, please submit a request to our support service.