# Telegram

Благодарим за интерес к интеграции Telegram+amoCRM!🧡 

## Видео-инструкция, как работает интеграция в amoCRM 👇

{% embed url="<https://disk.yandex.ru/i/8FzIp9xluOhNrQ>" %}

## Видео-инструкция, как работает интеграция в ЛК RadistWeb 👇

{% embed url="<https://disk.yandex.ru/i/snjQGWQLIDNIMA>" %}

## Функционал интеграции

Интеграция не зависит от телефона, на котором запущено приложение Telegram с подключаемым номером. \
Интеграция не зависит от того, на скольких устройствах запущен Telegram с подключаемым номером.\
Интеграция зависит от работоспобности  amoCRM, нашего сервиса и самого Telegram.

1️⃣ Начало чата по Telegram из amoCRM.\
Начало чата через Telegram возможно с каждого подключенного номера. Для каждого номера в сделке будет своя кнопка для начала чата. Название кнопки соответствует названию номера в ЛК в разделе "Подключения" (см. скрин).

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FJBOacVAj6MAQ2lkxA9I5%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202022-03-22%20%D0%B2%2011.44.58.png?alt=media&#x26;token=8d192775-594f-4bd8-9e59-4e30a1becb5c" alt=""><figcaption></figcaption></figure>

Начало чата из мобильного приложения amoCRM также поддерживается.

2️⃣ Переписка с клиентом по Telegram внутри сделки amoCRM.

3️⃣ Поддержка мобильного приложения amoCRM.

4️⃣ Автоматические отображение имени контакта.

5️⃣ Прием фото в виде нативной картинки, прием emoji, прием видео, документов, gif и стикеров в виде файлов для скачивания, прием аудиосообщений в виде дорожки для прослушивания в амоСРМ, прием контактов и геопозиций.

6️⃣ Автоматическое отображение номера телефона клиента, при условии, что у клиента включено отображение номера в настройках Telegram "для всех" или для "мои контакты", если ваш номер сохранен у клиента в контактах.

{% hint style="info" %}
ID пользователя и username подтягивается, когда клиент напишет. Номер телефона забивается 1 раз при первом сообщении клиента
{% endhint %}

7️⃣ Автоматическое инициирование чата по Telegram через salesbot.

8️⃣ Возможность подключения нескольких номеров к одному аккаунту amoCRM. \
Для каждого номера Telegram можно установить статус Неразобранное разных воронок для создания сделок.

9️⃣ Можно квалифицировать клиентов по первому сообщению и отслеживать  конверсию через Roistat.

🔟 Telegram-визитка: позволит отправить сообщение подрядчикам/исполнителям, контакты которых не заведены в карточке сделки\
📙 [Инструкция по настройке Telegram-визитки](https://docs.radist.online/radist.online-docs/nashi-produkty/amocrm/telegram/telegram-vizitka)

1️⃣1️⃣ Подтягиваются сообщения, отправленные с телефона (Telegram), сообщения будут отмечены, как отправленные ботом.

1️⃣2️⃣  Писать на username клиента.\
Вы можете из СРМ первыми писать на username клиента, но при условии, что эти данные не скрыты в профиле вашего клиента.\
Если скрыты - отправка не пройдет. Но может получится отправить сообщение из приложения. Когда клиент ответит - то чат будет синхронизирован с СРМ<br>

В окне чата есть кнопка “Telegram” (В “сделке”/”покупателе”)\
При клике на нее открывается окно для начала чата через username.\
[Подробнее по инструкции (нажмите чтобы перейти).](https://docs.radist.online/radist.online-docs/nashi-produkty/amocrm/telegram/kak-pisat-na-username-klienta-telegram-v-amocrm)

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2Ft7Ul4UV7U9hJeqy2RhuA%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202022-09-16%20%D0%B2%2018.00.49.png?alt=media&#x26;token=86e92294-243e-4290-bb85-e06cd4152f7f" alt=""><figcaption></figcaption></figure>

1️⃣3️⃣. Поддерживаем все статусы в AmoCRM: отправлено / доставлено / прочитано

1️⃣4️⃣ Поддерживаем видеокружочки:&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FvNtkLmdNMNCVKz5uiDRn%2FScreenshot%202024-04-25%20at%2009.33.06.png?alt=media&#x26;token=023d462e-ae8a-427b-913a-6d36823c5c34" alt=""><figcaption></figcaption></figure>

1️⃣5️⃣ Поддерживаем картинки  с большим размером и высоким разрешением:

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FVu2XbWPhx0PeFtVc890L%2FScreenshot%202024-04-25%20at%2009.34.17.png?alt=media&#x26;token=102c8398-c2a6-429a-8ac1-9c9913a786f9" alt=""><figcaption></figcaption></figure>

1️⃣6️⃣ Поддержка цитирования ваших сообщений клиентами в телеграмм:&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F192VoesuS0gTBJnxzAXH%2FScreenshot%202024-06-03%20at%2011.15.21.png?alt=media&#x26;token=6c7545fe-a439-4d68-9e3e-d4762f33d699" alt=""><figcaption></figcaption></figure>

1️⃣7️⃣ Поддерживаем сообщения **с ссылками в кнопках**:&#x20;

{% hint style="warning" %}
**Важно:**&#x20;

* В кнопках к сообщению могут быть только ссылки, другие варианты кнопок не поддерживаются.

* Кнопки можно добавить как при создании Salesbot, так и при создании в разделе "Настройки" шаблонов ответов. В Salesbot элемент называется "URL-адрес", в шаблонах ответов "URL кнопка".

* Если произойдет ошибка при отправке сообщения с кнопкой, отправится только текстовое сообщение без кнопки.

* Сейчас работает только для отправки текстовых сообщений (т.е. нельзя добавить кнопку с ссылкой к сообщению с файлом).
  {% endhint %}

* Как это выглядит в SalesBot: <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FhZD91Vm1IQEzpXsZ7RE3%2Fphoto_2024-06-18_16-13-26.jpg?alt=media&#x26;token=bb122a28-e345-4b2f-a202-4cda53ef717c" alt=""><figcaption></figcaption></figure>

  *Максимальное количество доступных кнопок в Salesbot - 13 кнопок*<br>

* Как это выглядит в телеграмме у клиента: <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FAgbrG7OlUxsFGht3qd00%2Fphoto_2024-06-18_16-12-19.jpg?alt=media&#x26;token=65f404a3-f019-4f3f-957b-28a61eed59df" alt=""><figcaption></figcaption></figure>

* Как это выглядит в amoCRM:  <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2Fe55sUxc9waWIBE1lb5VK%2Fphoto_2024-06-18_16-11-45.jpg?alt=media&#x26;token=dcb960dd-b1e7-4ef2-a23a-57afb6c893c7" alt=""><figcaption></figcaption></figure>

* Как это будет выглядеть в шаблонах быстрого ответа в amoCRM: <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F1wU9LQm6faSdT1iID35u%2Fphoto_2024-06-18_16-16-57.jpg?alt=media&#x26;token=f01c3d75-60d1-4415-8fa4-734f8e74749d" alt=""><figcaption></figcaption></figure>

  *Максимальное количество доступных кнопок в шаблонах быстрого ответа - 2 кнопки*

1️⃣8️⃣ Поддерживаем **ответы на сторис в Telegram** в amoCRM:

Поддерживаются ответы как тестовым сообщением, так и голосовым сообщением, документом, и видео

При ответе клиента на сторис в тг:

1. *Текстовым сообщением:*

в чате amoCRM сообщение отображается как ответ текстом на сторис (картинка или видео). Смайлики поддерживаются.

2. &#x20;*Голосовым сообщением, документом, и видео:*

в чате amoCRM приходит сообщение с голосовым сообщением, видео или документом

#### Как это выглядит в Telegram:&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FWExQeNxebejHvZo0GlRv%2F14%20%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D1%8B%20%D0%BD%D0%B0%20%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%81%20%D0%B2%20%D1%82%D0%B3.png?alt=media&#x26;token=4642e91d-da05-4cee-95b0-5497a4c9a3cb" alt=""><figcaption></figcaption></figure>

#### Как это выглядит в amoCRM:&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FppvJae3aWHfL94LICMwR%2F14%20%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D1%8B%20%D0%BD%D0%B0%20%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%81%20%D0%B2%20%D0%B0%D0%BC%D0%BE.png?alt=media&#x26;token=e6599879-7f2b-4685-90ba-9cc82770293b" alt=""><figcaption></figcaption></figure>

1️⃣9️⃣ **Данные о Telegram Username и ID пользователя в CRM:**&#x20;

В разделе информации о контакте (в карточке контакта и сделке) отображаются данные о TG User ID и имени пользователя контакта:&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FYZf8CxxeBZ4bRnHtiIn3%2F%D1%80%D1%83%D1%81.png?alt=media&#x26;token=0c3b50cb-cb69-4223-83f0-54c76cef92ef" alt=""><figcaption></figcaption></figure>

2️⃣0️⃣ **Отображение звонков в TG:**&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FiFpXINA5766XFNKAa2pb%2F1.png?alt=media&#x26;token=f6afeeb0-e3cc-4854-9695-bb362c8f5e99" alt=""><figcaption></figcaption></figure>

#### 1. Длительность звонков

Длительность всех звонков отображается **в секундах**.&#x20;

#### 2. Статусы несостоявшихся звонков

Если соединение для звонка установить не удалось, у такого звонка отображается **значок крестика**.\
Это может происходить по различным причинам, например:

* нестабильное или отсутствующее интернет-соединение;
* завершение звонка со стороны клиента;
* использование VPN или другие сетевые ограничения;
* иные технические сбои при попытке соединения.

**Исключение:**\
Если звонок был отклонён **со стороны подключённого номера** (нажата кнопка «Отклонить»), он отобразится **с галочкой и длительностью 0 секунд**.\
Это является особенностью логики работы мессенджера и не считается ошибкой.

## **Рассылка сообщений из личного кабинета Radist.Web**

Radist.Web позволяет создать рассылку сообщений клиентам с моментальной отправкой, а так же с возможностью запланированной рассылки на определённую дату и время. [Подробнее здесь (нажмите чтобы перейти)](https://docs.radist.online/radist.online-docs/nashi-produkty/radist-web/rassylki)

## Ограничения Telegram/баны номеров

{% hint style="danger" %}
Наша интеграция не защищает вас от бана номера, поэтому рекомендуем строго соблюдать Условия предоставления услуг Telegram.&#x20;

Если ваш номер Telegram будет заблокирован, мы не несем за это ответственность, и бан номера не является причиной возврата денежных средств, оплаченных за интеграцию.
{% endhint %}

Настоятельно просим ознакомиться с Условиями использования Telegram 👇

{% embed url="<https://docs.radist.online/radist.online-docs/nashi-produkty/amocrm/telegram/ogranicheniya-telegram-bany-nomerov>" %}

## Авто-оповещение о**б отключившейся интеграции**

Мы автоматически уведомляем клиентов о том, что в телефоне отключилась активная сессия интеграции, из-за которой перестает работать интеграция.

[Чтобы получать такие уведомления, в ЛК настройте раздел "Уведомления".](https://docs.radist.online/radist.online-docs/nashi-produkty/amocrm/telegram/avtomaticheskie-uvedomleniya-o-sboyakh-v-rabote-integracii-telegram)

## **ID компании**

При обращении вашего сотрудника по вопросам работы интеграции в тех.поддержку, он должен указать ID компании из ЛК.

Это нужно для соблюдения конфиденциальности, чтобы мы были уверены, что это сотрудник вашей компании. В противном случае, в тех.поддержке может быть отказано до момента подтверждения участия сотрудника вами.  Где взять ID, указано на скриншоте ниже.&#x20;

![](https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FhBfonnCMNj9vTJX3KCO5%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202021-11-09%20%D0%B2%2017.41.57.png?alt=media\&token=d263da4b-5998-4562-a0fb-90890320475f)