Перейти до основного вмісту

Інтеграція з E-chat

E-chat підключає до Skynum звичайний номер телефону вашої компанії у Viber і Telegram. Клієнт пише на знайомий номер, а ваша команда читає його повідомлення і відповідає в розділі Месенджер. На відміну від бота, з номера можна написати клієнту першим.

У Skynum це два канали: Viber номерний і Telegram номерний. Кожен месенджер номера підключається окремою інтеграцією. Номер у WhatsApp підключається офіційно, через Meta — стаття Інтеграція з WhatsApp.

Що описує ця стаття

Тут — підключення номера і правила двох номерних каналів. Як вести листування, описано в розділі Месенджер, як почати діалог із клієнтом — у статті Новий діалог, а різницю між каналами показує таблиця Можливості каналів.

Що потрібно підготувати​

  • номер телефону компанії, на якому вже працює потрібний месенджер: Viber або Telegram. Це має бути робочий номер компанії для клієнтів;
  • телефон із цим месенджером під рукою — він знадобиться, щоб підтвердити підключення номера в E-chat;
  • акаунт E-chat. Якщо його ще немає, зареєструйтеся в E-chat.

E-chat — платний сервіс. Тариф оплачується окремо за кожен месенджер номера, умови й вартість визначає E-chat.

Номер і API ключ в E-chat​

Підключення номера​

Номер додається в особистому кабінеті E-chat, окремо для кожного месенджера.

  1. Натисніть угорі кабінету кнопку свого месенджера: Підключити номер Viber або Підключити номер Telegram.
  2. У вікні Додавання номера під написом Оберіть інтеграцію виберіть Skynum.
  3. Для Viber введіть номер компанії в полі Номер телефону у міжнародному форматі. Для Telegram номер не вводиться — його визначить QR-код.
  4. Натисніть Додати номер.
  5. Відскануйте QR-код, який показує E-chat, застосунком месенджера на телефоні з цим номером.

Як сканувати код у кожному месенджері, показують інструкції E-chat: Viber, Telegram.

Після підключення месенджер на телефоні працює як раніше. Пристрій E-chat, який з'явився в списку пристроїв месенджера, не видаляйте: через нього йде листування.

API ключ​

Підключений номер стоїть у кабінеті E-chat окремим рядком у блоці свого месенджера. У цьому рядку є колонка API ключ — скопіюйте її значення.

Ключ у кожного месенджера свій. Якщо один номер працює у Viber і в Telegram, у нього два рядки в кабінеті і два різні ключі.

Ключ дає доступ до листування

Хто має API ключ, той читає повідомлення клієнтів і пише їм від імені вашого номера. Не публікуйте ключ і не надсилайте його стороннім.

Номер уже був підключений до іншої системи​

Якщо номер раніше працював з іншою CRM або сервісом, у них лишився ваш API ключ. Поки ключ той самий, стара система далі отримує повідомлення клієнтів разом зі Skynum. Тому перед підключенням до Skynum змініть ключ:

  1. У кабінеті E-chat натисніть шестерню в рядку номера.
  2. У вікні Налаштування номера в рядку API ключ натисніть Оновити.
  3. Скопіюйте новий ключ із рядка номера — у Skynum вставляйте саме його.

Якщо у вікні Налаштування номера в рядку Webhook URL стоїть адреса старої системи, видаліть її кнопкою з кошиком: Skynum передає свою адресу в E-chat сам, вставляти її в кабінет не потрібно.

Інтеграція в Skynum​

  1. Відкрийте Налаштування → Інтеграції → Месенджери.
  2. Натисніть Додати інтеграцію і виберіть канал: Viber номерний або Telegram номерний.
  3. Заповніть Назва інтеграції.
  4. У полі Номер телефону введіть номер компанії в міжнародному форматі, наприклад +380 67 123 45 67.
  5. У полі API ключ вставте ключ цього месенджера з кабінету E-chat.
  6. Вкажіть решту полів інтеграції: Канал продажу, Тип ціни, Виконавець за замовчуванням, Звук сповіщень, Відправляти сповіщення тільки, Філія, юридична особа. Для чого кожне з них, пояснює стаття Підключення інтеграцій.
  7. Поле Обліковий запис залиште порожнім: Skynum внесе туди номер сам.
  8. Натисніть Зберегти.

Після збереження поле Обліковий запис показує номер із плюсом. Для другого месенджера того самого номера створіть ще одну інтеграцію зі своїм ключем.

Увімкнення і перевірка підключення​

  1. В інтеграції Skynum увімкніть Інтеграція активна.
  2. Натисніть Зберегти.
  3. Натисніть Перевірити підключення.

Якщо номер і ключ правильні, з'являється повідомлення Підключення успішно пройшло перевірку. Skynum сам повідомляє E-chat адресу, на яку приходять повідомлення клієнтів: нічого вставляти в кабінет E-chat не потрібно. У кабінеті E-chat рядок номера показує в колонці Активні інтеграції — Skynum, у колонці Статус — Активний.

Якщо інтеграцію в Skynum вимкнути або видалити, Skynum зникає з колонки Активні інтеграції номера; інші системи, підключені до номера, лишаються.

Щоб переконатися, що листування працює:

  1. Зі свого особистого месенджера, не з номера компанії, надішліть повідомлення на номер компанії.
  2. Відкрийте в Skynum розділ Месенджер і знайдіть новий діалог зі значком месенджера.
  3. Надішліть відповідь із чату Skynum і перевірте, що вона прийшла на телефон.

Як клієнти потрапляють у діалог​

Діалог з'являється в Skynum двома шляхами:

  • клієнт пише на номер компанії — як звичайному контакту у своєму месенджері;
  • менеджер пише клієнту першим за номером телефону кнопкою Новий діалог. Докладно: Новий діалог.

Діалог із новим клієнтом одразу пов'язується з контрагентом, коли номер клієнта записаний у картотеці в одного контрагента або в його контактної особи. Якщо номер невідомий або записаний у кількох контрагентів, виберіть контрагента в полі Контрагент у правій панелі чату. У Telegram це працює, коли клієнт не приховав свій номер.

Повідомлення, які співробітник написав клієнту просто із застосунку месенджера на телефоні, теж видно в чаті Skynum серед повідомлень компанії. Так команда бачить усе листування з номера.

Правила месенджерів для номера​

Viber і Telegram стежать, щоб зі звичайних номерів не розсилали спам. За масові повідомлення людям, які не писали вам першими, і за скарги клієнтів месенджер може заблокувати номер. Про це нагадує червоне попередження в інтеграції.

E-chat радить починати з одного номера не більше 20 нових діалогів на день у кожному месенджері. Для номера, яким у месенджері користуються недавно, межа нижча: у Viber блокування можливе вже на п'ятому повідомленні новим контактам за день. Діалогу, у якому клієнт уже відповів, ці обмеження не стосуються.

Skynum рахує, скільки діалогів почато з номера за сьогодні, і показує це число у вікні Новий діалог. Коли воно досягає 20, під ним з'являється попередження про ризик блокування. Рішення, чи писати далі, ухвалює менеджер.

Щоб номер працював довго:

  • пишіть першими тим, хто чекає вашого повідомлення: залишив заявку, зробив замовлення, просив передзвонити;
  • не надсилайте однаковий текст багатьом новим контактам поспіль;
  • для масових розсилок використовуйте SMS-розсилки, а не номерний канал.

Що можна надсилати​

З номера клієнту йдуть текст, фото, документи і товар із каталогу Skynum: кнопка з коробкою біля поля введення — клієнт отримає фото товару з ціною за полем Тип ціни інтеграції. Докладніше: Надсилання товару з картотеки. Решта залежить від месенджера.

Viber номернийTelegram номерний
Текст і файл разомклієнт отримує два повідомленняодне повідомлення, текст стає підписом
Відповідь із цитатою—так
Редагування і видалення свого повідомлення—так

Текст повідомлення — до 4096 символів, підпис до файла в Telegram — до 1024.

Редагувати й видаляти можна повідомлення, надіслані зі Skynum. Пункти Редагувати і Видалити з'являються в меню повідомлення, коли воно отримало позначку Доставлено. Повідомлення, написане із застосунку на телефоні, змінюється там само, на телефоні.

Після надсилання під повідомленням стоїть Відправлено. Коли месенджер передав його клієнту, позначка змінюється на Доставлено. Переглянуто з'являється, коли клієнт відповів.

Що приходить від клієнта​

У кожному з двох каналів у чат потрапляють текст, фото, відео, голосові повідомлення і документи. Файл розміром до 20 МБ Skynum зберігає у себе, тому він відкривається в чаті будь-коли.

Особливості каналів:

  • Viber номерний — ім'я клієнта таке, під яким він записаний у телефонній книзі номера. Дзвінки клієнта у Viber видно в чаті рядками Клієнт телефонував у месенджері і Пропущений дзвінок клієнта в месенджері. Контакт, яким поділився клієнт, приходить текстом з іменем і номером. Стікер E-chat не передає: на його місці стоїть картка Повідомлення цього типу не підтримується з підписом «стікер»;
  • Telegram номерний — відповідь клієнта на конкретне повідомлення показується з цитатою. Контакт приходить текстом. Коди входу та інші службові повідомлення Telegram у чат не потрапляють.

Якщо клієнт виправив своє повідомлення в Telegram, у чаті змінюється текст цього повідомлення і з'являється позначка олівця. У Viber виправлений текст приходить новим повідомленням.

Фото клієнта в списку переписок і в правій панелі є тоді, коли месенджер його передає: це залежить від налаштувань приватності клієнта.

Типові ситуації​

«E-chat не прийняв номер телефону або API ключ, перевірте їх у картці інтеграції»​

Номер і ключ не відповідають одне одному. Перевірте, що номер в інтеграції збігається з номером у кабінеті E-chat, а ключ скопійовано з рядка саме цього месенджера: ключ Viber не підходить для Telegram того самого номера. Якщо ключ у кабінеті E-chat оновили, вставте в інтеграцію новий.

«Вкажіть номер телефону та API ключ у картці інтеграції»​

В інтеграції порожнє поле Номер телефону або API ключ. Заповніть обидва поля і натисніть Зберегти.

«Інтеграція з обліковим записом … вже існує»​

Цей номер у цьому месенджері вже підключений в іншій інтеграції вашої компанії. Відкрийте наявну інтеграцію. Для іншого месенджера того самого номера виберіть інший канал під час створення.

Клієнт пише на номер, а діалог у Skynum не з'являється​

  • Відкрийте інтеграцію і переконайтеся, що перемикач Інтеграція активна увімкнено.
  • Перевірте в кабінеті E-chat, що рядок номера має статус Активний, а дата в колонці Сплачено до ще не минула.
  • Перевірте в кабінеті E-chat, що в рядку номера в колонці Активні інтеграції є Skynum. Якщо немає, натисніть Перевірити підключення в інтеграції — Skynum підключиться до номера заново.

Під повідомленням стоїть «Цього номера немає в месенджері»​

У клієнта немає акаунта в цьому месенджері на вказаний номер. Перевірте номер або напишіть клієнту в іншому каналі. Якщо так закінчився Новий діалог, порожній діалог у списку не залишається.

Повідомлення клієнтів приходять і в стару систему​

Інша CRM або сервіс далі отримує листування номера, бо має ваш API ключ. Змініть ключ у кабінеті E-chat і вставте новий в інтеграцію Skynum — як описано в розділі Номер уже був підключений до іншої системи.

«Цього номера немає в Telegram, або власник приховав його»​

Telegram не знайшов акаунт за номером. Клієнт або не користується Telegram на цей номер, або заборонив знаходити себе за номером у налаштуваннях приватності. Такому клієнту можна відповісти, коли він напише вам сам.

Під повідомленням стоїть помилка з текстом «Tariff Expired»​

Закінчився оплачений період номера в E-chat. Продовжіть тариф у кабінеті E-chat і натисніть Повторити під повідомленням.

Файл клієнта показується карткою з посиланням​

Файл більший за 20 МБ. У чаті стоїть його назва, розмір і посилання, за яким файл відкривається протягом 30 днів від дня надсилання. Якщо файл потрібен надовго, завантажте його за цей час.

Підсумок​

E-chat підключає до Skynum номер телефону компанії у Viber і Telegram. Для підключення потрібні лише номер і API ключ із кабінету E-chat; адресу для повідомлень Skynum передає в E-chat сам. Номеру, який раніше працював з іншою системою, спершу оновіть ключ. Після цього ваша команда відповідає клієнтам і пише їм першою зі Skynum. Бережіть номер: дотримуйтеся правил месенджерів і стежте за лічильником нових діалогів.