Обзор коннекторов

TelegramWhatsAppMessengerInstagramDiscordKakaoTalk

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

Подключение нового канала требует Operate или Scale. Существующие подключения продолжают работать на Launch.

Матрица возможностей#

«Входящий голос» означает, что поддерживаемое голосовое/аудио сообщение загружается и транскрибируется. «Исходящий голос» требует работающего провайдера речи и опции коннектора Отвечать голосом. Неподдерживаемые вложения вроде изображений и локаций игнорируются, а не интерпретируются как инструкции агенту.

Перед подключением#

1. Протестируйте предполагаемого агента сайта в панели. Публикация рекомендуется, чтобы его публичные ссылки и страницы работали; черновик коннектора всё равно может отвечать.
2. Настройте рабочий ключ модели в Настройки → Ключи AI-провайдеров. Настройте ключи речи перед тестированием голоса. См. Ключи провайдеров.
3. Создайте выделенное приложение, бота, номер или канал у внешнего провайдера. Не используйте повторно учётные данные, принадлежащие несвязанной продакшен-интеграции.
4. Убедитесь, что ваше развёртывание имеет публичный HTTPS базовый URL коннекторов. Вебхуки провайдеров не могут доставлять на localhost без защищённого туннеля разработки.
5. Откройте страницу Коннекторы сайта и выберите канал.

При сохранении Make Agent Fast вызывает провайдера для проверки отправленных учётных данных. Метка «подключено» означает, что проверка учётных данных и любое автоматическое обеспечение завершились; она не доказывает, что ручной шаг консоли Meta, Discord или Kakao был выполнен.

Обращение с учётными данными#

Формы коннекторов принимают учётные данные провайдеров только из аутентифицированной панели или серверного публичного API. Секреты зашифрованы при хранении и никогда не возвращаются в ответах списка коннекторов. Относитесь к следующим значениям как к паролям:

• Токен бота Telegram
• Токены доступа Meta и секрет приложения
• Токен бота Discord
• REST API ключ Kakao и секрет бота

Не помещайте их в браузерный JavaScript, скриншоты, тикеты поддержки или систему контроля версий. URL вебхука и токен проверки Meta — значения конфигурации, предназначенные для копирования в соответствующую консоль провайдера; они не заменяют учётные данные провайдера.

Подключение через API#

Используйте серверный ключ MAF API с connectors:write. Объект credentials конкретного канала доступен только для записи. Ответ опускает секреты в открытом виде и включает URL вебхука, нужный для ручной настройки провайдера.

curl -X POST "https://makeagent.fast/api/v1/sites/$SITE_ID/connectors" \
  -H "Authorization: Bearer $MAF_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: connector-telegram-v1" \
  -d '{
    "channel": "telegram",
    "credentials": { "bot_token": "'$TELEGRAM_BOT_TOKEN'" },
    "config": { "reply_with_voice": false }
  }'

Сохранение того же канала заменяет его учётные данные/конфигурацию, сохраняя токен маршрутизации. Используйте Аутентификацию API, Области и ошибки и Справочник API для правил продакшен-интеграции.

Тестируйте и наблюдайте#

Используйте тестового пользователя провайдера и реалистичный вопрос, зависящий от знаний агента. Подтвердите всё следующее:

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

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

Отключение, ротация или удаление#

Отключение останавливает обработку, сохраняя запись коннектора. Вебхук Telegram удаляется при отключении и регистрируется снова при включении; подписки провайдера, настроенные в консоли, остаются и тоже должны быть приостановлены на стороне провайдера при необходимости. Удаление удаляет коннектор Make Agent Fast и пытается наилучшими усилиями демонтировать провайдера, но не удаляет внешнее приложение, не отзывает его учётные данные и не стирает существующую историю диалогов.

Для ротации создайте новый токен провайдера, обновите коннектор, протестируйте его, затем отзовите старый токен. Если учётные данные были раскрыты, сначала отзовите их у провайдера и трактуйте интервал как инцидент безопасности.

Частые сбои#

Продолжите гайдом по каналу для точных полей провайдера и последовательности в консоли.