Установка кнопки Webim в e-mail сообщение

В данной статье мы внедрим кнопку онлайн консультанта 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>
    У Вас остались вопросы?
    
    
    <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. Отправьте Ваше сообщение электронной почты получателю, используя удобный вам способ.
    Пример полученного пользователем сообщения:

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

Создание ссылки без использования изображения кнопки 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>
    У Вас остались вопросы?
    
    
    <a href="https://webim.webim.ru/webim/client.php">
    Напишите нам!
    </a>
    
  2. Отправьте Ваше сообщение электронной почты получателю, используя удобный вам способ.

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

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

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

Чат, открытый после перехода по ссылке

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