Wiring Lab

В Wiring Lab вы подключаете персону к движку. Такое подключение называется связью: : она соединяет ровно одну персону с одним движком, чтобы движок говорил голосом этой персоны. У каждой связи свой api_slug — уникальный идентификатор именно этой связки, чтобы платформа всегда знала, к какой паре «персона + движок» относится запрос.

Чтобы создать связь:

Откройте Wiring Lab и выберите персону, которую хотите запустить.
Перетащите движок из библиотеки на холст, чтобы прикрепить его к этой персоне.
Нажмите Сохранить (кнопка Применить связи), чтобы связь сохранилась. Пока вы не применили изменения, связь не записана.

В одном аккаунте можно создать несколько связей «персона + движок». Каждая — отдельное подключение со своим api_slug.

API-ключи

API-ключ — это то, чем внешний бот или интеграция аутентифицируется во FluidTalk. Создать его можно двумя способами:

Создать: сгенерировать обычный ключ на уровне аккаунта , ещё не привязанный ни к персоне, ни к движку.
Выпустить с привязкой: за один шаг создать ключ, сразу привязанный к конкретной персоне и движку . Это рекомендуемый путь, потому что уже привязанный ключ готов обслуживать боевой трафик.

Ключами вы управляете из Wiring Lab:

Привязать ключ: связать существующий ключ уровня аккаунта с персоной и движком (и при желании переименовать). Ключ без привязки не сможет обслуживать боевые вызовы.
Список: посмотреть все ключи аккаунта.
Отозвать: удалить ключ, чтобы им больше нельзя было пользоваться.

Обратите внимание

Секрет API-ключа показывается только один раз — в момент создания. Скопируйте его сразу и сохраните в надёжном месте. Если потеряете, увидеть его снова не получится: просто отзовите этот ключ и создайте новый.

Обратите внимание

Прежде чем обслуживать боевой трафик, ключ должен быть привязан к персоне (и движку). Непривязанный ключ уровня аккаунта на боевых вызовах отклоняется. Сначала выпустите ключ с привязкой или привяжите существующий.

Чек-лист запуска

Когда все четыре пункта выполнены, вы в бою:

Персона готова: личность и фото настроены.
Движок связан: движок привязан к этой персоне и применён в Wiring Lab.
Привязанный API-ключ: выпущен (или привязан) именно к этой персоне и этому движку.
Направьте бота на handshake: ваша интеграция отправляет каждое входящее сообщение на боевой эндпоинт handshake, передавая ключ в заголовке X-API-Key . FluidTalk отвечает следующим сообщением и тем, что нужно сделать.

Точные эндпоинты, поля запросов и ответы смотрите в справочнике API для разработчиков.

Совет

Чтобы попробовать, необязательно выходить в бой. Сначала прогоните весь разговор во встроенном симуляторе (тот же движок, без ключа и без реального трафика), а связывайте всё уже после того, как поведение вас устроит.

Обратите внимание

Обслуживание боевых разговоров требует активного платного тарифа. Бесплатный или истёкший аккаунт получает отказ на handshake, поэтому ваш бот перестаёт работать в момент окончания тарифа. Смотрите Оплату и тарифы.

Связанные руководства

Конструктор движков: спроектируйте разговор до того, как связывать.
Тестирование в симуляторе: прогоните движок целиком без ключа.
Справочник API для разработчиков: точные вызовы handshake и заголовки.
Оплата и тарифы: что платный тариф открывает для боевой работы.