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

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

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

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

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

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

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

WhatsApp Business и Telegram работают стабильно. Остальные находятся в стадии бета-тестирования — они полностью функциональны, но продолжают дорабатываться.

Настройка

  1. Перейдите в Настройки > Сообщения (Шлюз обмена сообщениями).
  2. Выберите сервис.
  3. Введите стандартные учетные данные бота или бизнес-аккаунта этого провайдера — тот же токен или аккаунт, который вы бы использовали для любой интеграции на этой платформе.
  4. 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.