Интеграция Twelve Data: курсы валют и цены акций в разговоре – Twelve Data в Binom

Интеграция Twelve Data с Binom даёт ИИ-сотруднику актуальные рыночные данные: курсы валют, цены акций и криптовалют, котировки и календарь дивидендов прямо в разговоре. Twelve Data доступен по запросу в кабинете Binom: Интеграции → Больше интеграций → Twelve Data.

Что Binom умеет в Twelve Data

Binom здесь означает вашего ИИ-сотрудника. После подключения Twelve Data он вызывает действия сервиса, когда разговору нужны эти данные. Какие действия ему доступны, решаете вы. В кабинете каждое действие помечено: read (Binom только смотрит данные), write или delete (Binom меняет или удаляет данные в Twelve Data).

Может ли чат-бот назвать курс валют через Twelve Data?

Да. Binom называет курс ("Get Exchange Rate") или сразу пересчитывает сумму в другую валюту ("Get Currency Conversion").

Цена акции или криптовалюты

Binom находит инструмент ("Get Symbol Search") и называет текущую цену ("Get Price") или котировку ("Get Quote").

Какие доступы понадобятся

Способ подключения: API-ключ. Ключ выдаётся сразу при регистрации и действует в лимитах вашего тарифа Twelve Data. Подробности по каждому способу показаны в блоке "Аутентификация" на странице Twelve Data в кабинете.

Как получить интеграцию Twelve Data

Twelve Data подключается по запросу: сначала команда Binom настраивает интеграцию для вашего аккаунта. Общие правила каталога описаны в инструкции как подключить сервис из "Больше интеграций".

1. Откройте Интеграции → Больше интеграций, введите "Twelve Data" в поле "Поиск интеграций" и откройте карточку Twelve Data.
2. На странице "Интеграция Twelve Data для ассистента" будет сообщение "Интеграция доступна по запросу. Запросите сейчас, и мы настроим её для вас в приоритетном порядке." Ассистент здесь это ваш Binom. Блок "Аутентификация" показывает, какие доступы понадобятся, а список "Действия" показывает всё, что Binom умеет делать в Twelve Data.
3. Нажмите "Запросить интеграцию". Появится "Запрос отправлен. Вы получите уведомление, когда интеграция станет доступна.", а кнопка сменится на "Запрошено".
4. С вами свяжется сотрудник Binom по настройке. Когда интеграция будет готова, на странице Twelve Data появится кнопка "Подключить".
5. Нажмите "Подключить", пройдите шаги в окне "Подключение Twelve Data" и нажмите "Готово". После "Подключается…" статус станет "Подключено". Если появилось "Подтверждение пока не пришло. Подключение ещё может завершиться – проверьте через минуту.", нажмите "Проверить ещё раз".

Как выбрать, что Binom может делать в Twelve Data

Подключённая интеграция ничего не делает, пока вы не разрешите действия. В кабинете это сказано прямо: "Отметьте действия, которые может вызывать ассистент. Пока ничего не отмечено, ему недоступно ни одно."

1. На странице Twelve Data отметьте галочками нужные действия в списке "Действия". Найти их по названию помогает поле "Фильтр по действиям". Счётчик показывает, сколько выбрано.
2. Проверьте переключатель "Спрашивать перед изменением данных". Он включён по умолчанию: перед действием на запись или удаление Binom опишет, что собирается сделать, и дождётся ответа.
3. Нажмите "Сохранить". Сообщение "Разрешённые действия сохранены" подтверждает изменения.

Для начала достаточно "Get Symbol Search", "Get Price", "Get Exchange Rate" и "Get Currency Conversion". Действия на изменение и удаление добавляйте, когда будете готовы доверить Binom изменения в Twelve Data.

Как проверить, что интеграция работает

• Начните новый диалог с вашим Binom, например по публичной ссылке на чат, спросите курс доллара к евро и сравните с Twelve Data.

Возможные проблемы

Binom не использует данные Twelve Data в ответах

Что проверить: статус Twelve Data "Подключено", и нужные действия отмечены (например "Get Price").
Что сделать: отметьте действия и нажмите "Сохранить".
Как понять, что решено: появилось "Разрешённые действия сохранены", и в новом диалоге Binom отвечает по данным Twelve Data.

"Не удалось записать запрос. Попробуйте ещё раз."

Что сделать: снова нажмите "Запросить интеграцию". Если сообщение повторяется, напишите на support@binomai.com: название вашего Binom и интеграции (Twelve Data).
Как понять, что решено: на кнопке появилось "Запрошено".

"Интеграция временно недоступна – ваш запрос записан."

Больше ничего делать не нужно: запрос сохранён, и вы получите уведомление, когда Twelve Data можно будет подключить.

"Нужно переподключить"

Что это значит: "Сервис больше не принимает сохранённые доступы, поэтому ассистент им не пользуется."
Что сделать: откройте страницу Twelve Data в Больше интеграций, нажмите "Переподключить" и пройдите окно подключения заново.
Как понять, что решено: статус "Подключено".

"Не удалось начать подключение. Попробуйте ещё раз."

Что сделать: снова нажмите "Подключить". Если сообщение повторяется, напишите на support@binomai.com: название вашего Binom, интеграции (Twelve Data) и скриншот сообщения.
Как понять, что решено: открывается окно "Подключение Twelve Data".

"На платном тарифе" вместо кнопки подключения

На странице будет "Доступно на платном тарифе. Скажите, что нужно, и мы сообщим о запуске." Что входит в тарифы, смотрите на странице тарифов и цен подписки, а как сменить тариф, описано в инструкции как сменить или повысить тариф. После смены тарифа вернитесь в Больше интеграций и снова откройте Twelve Data.

"У вас нет прав для управления этим разделом."

Что это значит: интеграциями управляют только пользователи с уровнем доступа Владелец или Администратор.
Что сделать: попросите владельца аккаунта выдать вам уровень Администратор или подключить Twelve Data самому. Подробнее: уровни доступа в команде.
Как понять, что решено: после обновления страницы открываются настройки интеграции.

Если проблема не решилась, напишите на support@binomai.com или в чате Тьютора "Хочу поговорить с человеком". Укажите название Binom, интеграции и приложите скриншот сообщения.

Как отключить Twelve Data

На странице Twelve Data нажмите "Отключить". В окне "Отключить Twelve Data?" будет предупреждение: "Ассистент потеряет доступ к сервису. Чтобы вернуть его, интеграцию придётся подключить заново и снова ввести доступы." Подтвердите, и появится "Интеграция отключена".

Как ещё спрашивают

Может ли Binom что-то изменить в Twelve Data?

Нет. Все действия интеграции только читают данные, поэтому подключение безопасно для любого тарифа.

Нужен ли программист для интеграции Twelve Data?

Нет. Вы запрашиваете Twelve Data в разделе Интеграции → Больше интеграций, команда Binom настраивает интеграцию, а затем вы сами подключаете аккаунт и выбираете действия.

Что дальше

• Интеграция Rillet: счета и учёт