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

Шлюз обмена сообщениями: пусть Caiioo отвечает в приложениях, которыми уже пользуются ваши контакты

Шлюз обмена сообщениями — это независимый от сервисов способ для Caiioo отправлять и получать сообщения на платформах, которые уже используют ваши клиенты и контакты. Люди пишут вам в WhatsApp, Telegram или где им удобно, а агент отвечает им автономно — в их канале, в режиме реального времени. Тот же шлюз работает и в обратную сторону: из любой ветки агент может отправить сообщение как инструмент («напиши в группу команды в Telegram о встрече»).

Один шлюз, много сервисов. Вы подключаете каждый сервис один раз, и Caiioo нормализует всё за единым интерфейсом.

Поддерживаемые службы

Подключите любую из них в разделе «Настройки» > «Подключения» > «Шлюз обмена сообщениями»:

  • WhatsApp Business — стабильно
  • Telegram — стабильно
  • Messenger (бета)
  • iMessage (бета)
  • Signal (бета)
  • Viber (beta)
  • Beeper (бета)

WhatsApp Business и Telegram работают стабильно. Остальные находятся в статусе бета-версии: полностью пригодны для использования и продолжают дорабатываться.

Настройка

  1. Включите Удаленный доступ для этого устройства в разделе «Настройки» > «Подключения» > «Соединения» > «Private Relay». Именно это соединяет устройство с ретранслятором, получающим входящие сообщения — без этого ничего не придет, как бы ни были настроены службы ниже. Функция отключена по умолчанию и настраивается для каждого устройства отдельно (см. «Поддержка платформ» ниже).
  2. Перейдите в «Настройки» > «Подключения» > «Шлюз обмена сообщениями».
  3. Выберите службу.
  4. Введите стандартные учетные данные бота или бизнес-аккаунта этого провайдера — те же токен или бизнес-аккаунт, которые вы используете для любой интеграции на этой платформе.
  5. Caiioo регистрирует входящий маршрут. Если удаленный доступ еще нигде не включен, «Настройки» > «Подключения» > «Шлюз обмена сообщениями» подскажут об этом и позволят включить его прямо на месте.

Каждая служба настраивается один раз. После этого агент видит единую возможность обмена сообщениями независимо от того, сколько служб подключено.

Режимы взаимодействия для каждой беседы

У каждой беседы есть свой режим, выбираемый тремя кнопками в верхней части ветки, так что вы сами решаете, как именно агент будет вести себя с каждым контактом:

Авто (зеленый)

Агент отвечает всем автоматически. Все, что вы печатаете в этой же ветке, рассматривается как инструктаж — это формирует следующий ответ агента, но не отправляется контакту. Используйте это, когда хотите, чтобы агент вел беседу, но вам нужно иногда направлять его («будь более официальным», «предложи скидку»).

Вмешаться (синий)

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

Чат (янтарный)

Агент приостанавливает работу и отходит в сторону — он перестает отвечать автоматически, и вы ведете беседу самостоятельно, при этом ваши сообщения уходят контакту от вашего имени. Используйте это, когда ветке требуется участие человека, и вы хотите, чтобы агент не мешал.

Медиа в обоих направлениях

Изображения, аудио и видео передаются в обоих направлениях. Когда контакт присылает фото, оно попадает в модель, поэтому вы можете спросить: «что на этой картинке, которую только что прислал клиент?» и ответить прямо в том же канале. Медиафайлы, которые агент создает или прикрепляет, отправляются контакту таким же образом.

Конфиденциальность и архитектура

Вся обработка сообщений происходит локально, на том из ваших устройств, где включен Удаленный доступ — в десктопном приложении, расширении для браузера или в обоих сразу. Агент работает на вашей машине; беседы, учетные данные и медиафайлы обрабатываются там, а не в облаке.

Cloudflare выполняет роль исключительно простого ретранслятора вебхуков для каждого пользователя. У каждого пользователя есть однопользовательский объект Durable Object, который пересылает исходный входящий вебхук на ваше устройство по защищенному соединению и не более того. Никакого облачного хранения сообщений и облачной обработки не существует. Исходящие сообщения полностью обходят Cloudflare — ваше устройство вызывает API службы напрямую. Cloudflare задействован только потому, что внешним службам необходим стабильный публичный URL для доставки входящих вебхуков.

Поддержка платформ

То, что действительно определяет, получаете ли вы сообщение — это Удаленный доступ («Настройки» > «Подключения» > «Соединения» > «Private Relay»). Это переключатель для каждого устройства, отключенный по умолчанию, который не синхронизируется между вашими устройствами намеренно (это настройка сетевого доступа, похожая на открытие порта). Включите его для каждого устройства, с которого хотите отвечать на сообщения, и оставьте выключенным на остальных.

  • macOS, Windows, Linux — поддерживается. Включите «Удаленный доступ» в десктопном приложении, чтобы оно отвечало.
  • Браузерное расширение (Chrome, Safari) — поддерживается и работает полностью самостоятельно — десктопное приложение не требуется. Включите «Удаленный доступ» в собственных настройках расширения, и оно подключится напрямую и будет самостоятельно отвечать на сообщения.
  • Если у вас одновременно включены десктопное приложение и расширение с удаленным доступом, приоритет имеет десктопное приложение; расширение остается в режиме ожидания в качестве резервной копии на случай отключения десктопного приложения.
  • iOS или Android — не поддерживается. Мобильные приложения не запускают клиент Private Relay, от которого зависит шлюз, поэтому входящие сообщения не могут быть получены или отправлены там, независимо от настроек удаленного доступа.

Примечание о Slack

Slack не является частью Шлюза обмена сообщениями. Slack находится в Community Hub как отдельный пакет OAuth — установите его оттуда. См. Community Hub.

Уровень

Шлюз обмена сообщениями — это функция уровня Pro.

См. также

This guide is maintained by the Caiioo team using Slate, our built-in editor.