# Каналы коммуникаций

<figure><img src="/files/FaolcNIswEqiXrKYqVKP" alt=""><figcaption></figcaption></figure>

* [Входящие](https://docs.iiagent.pro/nastroika-bota#vkhodyashie)
* [Umnico](https://docs.iiagent.pro/nastroika-bota#umnico)
* [Wazzup](https://docs.iiagent.pro/nastroika-bota#wazzup)
* [Whapi](https://docs.iiagent.pro/nastroika-bota#whapi)
* [Wapico](https://docs.iiagent.pro/nastroika-bota#wapico)
* [Green-api](https://docs.iiagent.pro/nastroika-bota#green-api)
* [Chat2Desk](https://docs.iiagent.pro/nastroika-bota#chat2desk)
* [Jivosite](https://docs.iiagent.pro/nastroika-bota#jivosite)
* [WILDBERRIES](https://docs.iiagent.pro/nastroika-bota#wildberries)

## Входящие

Для подключения каналов связи используются различные сервисы, такие как Umnico и Wazzup. Эти сервисы позволяют интегрировать WhatsApp, Telegram, ВКонтакте, Авито, Instagram и другие платформы.

<figure><img src="/files/hz2h6ZExX67PlrU4gYy7" alt=""><figcaption></figcaption></figure>

### Umnico

Umnico позволяет подключить множество каналов, включая виджеты для сайта. Для интеграции необходимо взять API ключ в личном кабинете Umnico и вставить в соответствующее окно на странице Интеграций в ProTalk и нажать кнопку сохранить. После обновление страницы на зеленом поле появятся подключенные номера каналов.

<figure><img src="/files/B9eehWev4DbLOfimg90h" alt=""><figcaption></figcaption></figure>

Скопируйте ID канала и вставьте в соответствующее поле в настройках вашего бота во вкладке Входящие каналы в разделе Umnico. Перезагрузите бота, после чего можно принимать сообщения.

<figure><img src="/files/DBvzd38RBBm6Fqg9B62m" alt=""><figcaption></figcaption></figure>

Иногда связь между, например вашим номером Whatsapp и каналом в Umnico может пропасть или закончиться подписка на Umnico, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Umnico был активен.

### Wazzup

Wazzup поддерживает интеграцию с WhatsApp, Telegram и другими платформами. Для подключения необходимо указать ID канала и API-ключ. При настройке каналов важно правильно указать ID и API-ключи. Например, для Telegram это может быть номер телефона, а для Авито — уникальный ID. Эти данные можно найти в личном кабинете Wazzup.

Примеры для записи в окошке “Канал и ID канала”:

Номер WhatsApp (whatsapp:79158888888)

WhatsApp Business API (wapi:79158888888)

Номер Telegram (tgapi:79158888888)

ВКонтакте (vk:123456789)

Авито (avito:123456789)

Instagram (instagram:my\_login\_instagram)

Telegram Bot (telegram:my\_bot)

Иногда связь между, например вашим номером Whatsapp и каналом в Wazzup может пропасть или закончиться подписка на Wazzup, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Wazzup был активен.

<figure><img src="/files/oArTLI8mOvse3O2PGQMV" alt=""><figcaption></figcaption></figure>

### Whapi

Здесь нужно указать название канала, которое найдете в личном кабинете Whapi и токен для входящих обращений к боту.

<figure><img src="/files/3zgPq6FTB6BXfD1escNX" alt=""><figcaption></figcaption></figure>

Иногда связь между, например вашим номером Whatsapp и каналом в Whapi может пропасть или закончиться подписка на Whapi, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Whapi был активен.

### Wapico

Для настройки интеграции с Wapico делаем следующее:

1\. В настройках бота в поле Access Token нужно указать ключ, который нужно взять в личном кабинете Wapico

2\. В разделе "Интеграция и API" копируем ссылку из блока Wapico

3\. В настройках чат-бота в сервисе Wapico вписываем ссылку в поле webhook

<figure><img src="/files/I3n7S7VgbvRb9azFtrW1" alt=""><figcaption></figcaption></figure>

### Green-api

Здесь нужно указать название канала, которое найдете в личном кабинете Green-api и токен для входящих обращений к боту.

<figure><img src="/files/NwkaTcOOykIJoqBSOXRi" alt=""><figcaption></figcaption></figure>

Иногда связь между, например вашим номером Whatsapp и каналом в Green-api может пропасть или закончиться подписка на Green-api, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Green-api был активен.

### Chat2Desk

Для интеграции необходимо взять API ключ в личном кабинете Chat2Desk и вставить в соответствующее окно на странице Интеграций в ProTalk и нажать кнопку сохранить. После обновление страницы на зеленом поле появятся подключенные каналы ID.

<figure><img src="/files/9BCNjXZhlmi75drytuCv" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tg35i2pKGN2KaO0HKB3O" alt=""><figcaption></figcaption></figure>

Скопируйте эти данные и вставьте в соответствующие поля в настройках вашего бота во вкладке Входящие каналы. Запись должна состоять через двоеточие из ID оператора, ID канала и названия канала.

Пример: operator\_id:channel\_id:transport

<figure><img src="/files/pjO2K8WKJE7OzxiOfZ3o" alt=""><figcaption></figcaption></figure>

### Jivosite

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

<figure><img src="/files/NS8WfraB6P6QkEdcHoUv" alt=""><figcaption></figcaption></figure>

В вашем личном кабинете JIVO напишите такой запрос в чат поддержки:

Мы хотим подключить наш API к боту JIVO:

<https://api.pro-talk.ru/api/v1.0/jivo\\_webhook/token>

Email: \_\_ВАШ\_EMAIL\_В\_JIVO\_\_

Канал: \_\_ВАШ\_КАНАЛ\_В\_JIVO\_\_

После этого вам вышлют ID провайдера и токен для интеграции с ProTalk.

### WILDBERRIES

Добавить описание

<figure><img src="/files/8B0FSZQtRqi2O1f8AIU4" alt=""><figcaption></figcaption></figure>

## Исходящие

### Выбор Whatsapp, Телеграмм или Телергамм бот

Вы можете использовать различные каналы для рассылки сообщений, где бот инициирует общение. Например, выбрав WhatsApp, вы можете задать список номеров для рассылки уведомлений. Однако, важно учитывать ограничения, накладываемые самим WhatsApp. Он может отслеживать нежелательные рассылки, поэтому используйте эту функцию с осторожностью. Не стоит массово загружать списки клиентов. Лучше, если контакты уже имели с вами переписку. Это снизит риск блокировки, так как клиент уже знаком с вашим номером.

Для минимального риска блокировки, мы реализовали возможность отправки сообщений с интервалами, чтобы избежать массового спама. Рекомендуется писать текущим клиентам по важным для них вопросам, чтобы они были знакомы с вашим номером и имели историю переписки.

Также доступна интеграция с Telegram. Вы можете пополнять список номеров для рассылки, но не стоит добавлять сразу тысячи контактов. Лучше ограничиться, например, 50 номерами на этапе, и чередовать их через время для безопасности. Для отправки сообщений через Telegram бот, клиент должен быть подписан на ваш бот.

Сервисы, позволяющие привязывать ваши аккаунты WhatsApp и Telegram, аналогичны тем, что описаны в разделе  [Входящие каналы коммуникаций.](#vkhodyashie)

## Телеграмм бот

<figure><img src="/files/5cUT5YiiFwqzrQS9BlB7" alt=""><figcaption></figcaption></figure>

### Токен и никейм

Перейдите в Telegram и найдите бота @BotFather. Следуйте инструкциям для создания нового бота: выберите имя и получите токен доступа. Вставьте токен бота и его никнейм в соответствующие поля.

<figure><img src="/files/tc1ldGu3c5JBCN3WLyFp" alt=""><figcaption></figcaption></figure>

### Меню

#### Команды в меню

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

Кнопки можно располагать как вертикально, так и горизонтально. Для горизонтального расположения используйте запятую для разделения кнопок, а для вертикального — новую строку.

<figure><img src="/files/y1kLmjvH0LMlGWXe0Acp" alt=""><figcaption></figcaption></figure>

Пример: если вы добавите две команды в одну строку, они будут отображаться горизонтально.

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

#### Готовые ответы для команд из меню

Вы можете создать кнопки, которые будут выдавать заранее подготовленные ответы без генерации нового текста. Это экономит токены и время.

<figure><img src="/files/l0DJQqvjQxbcDRwyoTHf" alt=""><figcaption></figcaption></figure>

#### Фраза во время ожидания ответа бота

Вы можете задать фразу, которая будет отображаться во время ожидания ответа от бота. Например, «⏳ Думаю ....».

<figure><img src="/files/ZEvsrYNTrUdAUrQrJSIk" alt=""><figcaption></figcaption></figure>

#### Количество подсказок

Можно настроить количество подсказок, которые будут отображаться под ответом бота в виде inline-ссылок, еще их называют инлайн кнопки. Сперва необходимо включить режим Inline в настройках @Botfather.

<figure><img src="/files/HD5J5oVnyYgMKaEbQ2E9" alt="" width="240"><figcaption></figcaption></figure>

<figure><img src="/files/bTc4NyvIQ6l3MXwyQ2tj" alt="" width="326"><figcaption></figcaption></figure>

Затем установите количество подсказок в поле “Количество подсказок”

<figure><img src="/files/kP0prAw9OQDfG54CycpJ" alt="" width="352"><figcaption></figcaption></figure>

<figure><img src="/files/ntxqe9EKmSl0EFAPwvHL" alt="" width="563"><figcaption></figcaption></figure>

### Обязательная подписка на канал

Вы можете настроить бота так, чтобы он требовал подписку на ваш канал или чат перед началом общения. Для этого добавьте бота в качестве администратора канала или чата и укажите соответствующий ID.

<figure><img src="/files/o61toSsSRUAZjjAg0JRz" alt=""><figcaption></figcaption></figure>

### Автоматически переводить текст кнопок в меню бота и готовые ответы на язык пользователя

<figure><img src="/files/VW7W8uyl11DEzWu7FLVd" alt=""><figcaption></figcaption></figure>

Ваш Телеграмм бот может самостоятельно переводить себя на любые языки мира.&#x20;

Что переводится:

&#x20;1\. Приветствия

2\. Кнопки меню

3\. Подсказки

4\. Служебные сообщения

Перевод осуществляется с помощью передового Google API, обеспечивая высокое качество и точность. Перевод активируется автоматически, если в команде бота присутствует эмодзи с флагом и как минимум одно слово. Например:

<figure><img src="/files/4FLDYNikBooK8omRt4zi" alt="" width="162"><figcaption></figcaption></figure>

Информация о локализации пользователя берётся из настроек его Телеграмм.&#x20;

<figure><img src="/files/654i3w17L7HJpg1DWguH" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iiagent.pro/nastroika-bota/kanaly-kommunikacii.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.