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

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

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

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

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

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

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

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

Настройка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Уровень

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

См. также

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