Перейти к содержанию

Добавление кнопки Webim в Email

В данной статье мы внедрим кнопку сервиса Webim в Ваше сообщение электронной почты формата HTML. В результате получатель письма сможет перейти к чату с Вашим консультантом.

Получение изображения кнопки Webim

Для получения изображения кнопки Webim необходимо отправить запрос следующего вида:

https://{account_name}.webim.ru/webim/button.php?button-name=baloon_blue.gif&force-status=on

Где account_name — название Вашего аккаунта Webim.

Если Ваш аккаунт размещён не на серверах Webim, запрос будет иметь вид:

https://chat.mycompany.com/webim/button.php?button-name=baloon_blue.gif&force-status=on

Описание параметров запроса /webim/button.php:

Название параметра Описание
button-name Имя изображения кнопки, которое загружается с сервера в момент открытия сообщения в почтовом клиенте.
force-status Отвечает за статус кнопки. Если значение параметра 'force-status=on', то всегда будет отображаться кнопка статуса Онлайн. Если значение параметра 'force-status=off', то всегда будет отображаться кнопка статуса Офлайн. Если параметр не указан, статус кнопки будет зависеть от наличия операторов Онлайн:
  • Если в момент открытия письма в почтовом клиенте в сети были операторы со статусом Онлайн, то отобразится кнопка со статусом Онлайн.
  • Если в момент открытия письма в почтовом клиенте в сети не было ни одного оператора Онлайн, то отобразится кнопка со статусом Офлайн*.

Обратите внимание, что на статус кнопки не влияет параметр Показывать офлайн-кнопку в настройках кнопки. Офлайн-кнопка будет отображаться независимо от значения этого параметра.

Стандартные изображения кнопок Webim

Имя изображения кнопки Изображение онлайн-кнопки Изображение офлайн-кнопки
baloon_mini_blue.gif
baloon_mini_green.gif
circle2_blue.gif
circle2_green.gif
circle_blue.gif
circle_green.gif
square_cyan.gif
square_green.gif
oval_blue.gif
oval_green.gif
oval_blue_l.gif
oval_green_l.gif
oval_blue_r.gif
oval_green_r.gif
baloon_blue.gif
baloon_green.gif
foval_cyan.gif
foval_purple.gif

Таким образом, Вы можете создать кнопку с использованием статического изображения, либо использовать динамическое изображение, зависящее от наличия операторов «онлайн».

Создание кнопки Webim для открытия чата из сообщения электронной почты

  1. В Ваше сообщение электронной почты формата HTML добавьте следующий код:

    <a href="https://{account_name}.webim.ru/webim/client.php">
    <img src="https://{account_name}.webim.ru/webim/button.php?button-name=baloon_blue.gif&force-status=on" />
    </a>
    

    Где account_name — название Вашего аккаунта Webim.

    Пример готового сообщения:

    <h1>Моё письмо формата HTML</h1><pre>
    
    У Вас остались вопросы?
    
    <a href="https://webim.webim.ru/webim/client.php">
    <img src="https://webim.webim.ru/webim/button.php?button-name=baloon_blue.gif&force-status=on" />
    </a>
    
  2. Отправьте Ваше сообщение электронной почты получателю, используя удобный вам способ.

    Пример полученного пользователем сообщения

Создание ссылки без использования изображения кнопки Webim

Вы также можете создать любую удобную Вам ссылку, которая будет перенаправлять пользователя в чат онлайн консультанта Webim. Для такой ссылки Вы можете использовать своё изображение. Либо Вы можете создать текстовую ссылку на Ваш чат.

  1. Для создания ссылки на чат добавьте в атрибут href Вашей ссылки следующий URL-адрес, перенаправляющий пользователя к Вашему чату:

    https://{account_name}.webim.ru/webim/client.php
    

    Где account_name — название Вашего аккаунта Webim.

    Если Ваш аккаунт размещён не на серверах Webim, ссылка будет иметь вид:

    https://chat.mycompany.com/webim/client.php
    

    Пример готового сообщения электронной почты формата HTML с использованием текстовой ссылки:

    <h1>Моё письмо формата HTML</h1><pre>
    
    У Вас остались вопросы?
    
    <a href="https://webim.webim.ru/webim/client.php">
    Напишите нам!
    </a>
    
  2. Отправьте Ваше сообщение электронной почты получателю, используя удобный вам способ.

    Пример полученного пользователем сообщения

Важно

При переходе по ссылке у пользователя будет открыт чат онлайн консультанта Webim на весь экран.

Пример чата, открытого после перехода по ссылке

В результате получатель имеет возможность перейти к чату онлайн консультанта Webim прямо из письма!