Интеграция Звукограм с Salebot - инструкция
03 февраля 2024 , Обновлено 06 марта 2024
Инструкция по интеграции АПИ Звукограм для озвучки речи в чат-ботах в конструкторе Salebot. SaleBot - конструктор чат-ботов для вконтакте, telegram, facebook, viber, whatsapp, Instagram. Многие пользователи Звукограма используют этот сервис в своей работе. По многочисленным просьбам, совместно с EasyDrafting выпустили подробную инструкцию. В конце статьи есть готовый шаблон json для Сейлбота, который вы можете скачать взять за основу для своего проекта.
Инструкция в видео-формате
1 вариант - быстрая озвучка коротких текстов.
Рассмотрим первый вариант настройки озвучки
Нам понадобиться ссылка с документации : https://zvukogram.com/index.php?r=api/text
Далее, мы идем в Salebot.pro , в вашем проекте добавляем блок для старта
В условии прописываем start (либо любое условие по которому запускается бот)
Отводим стрелку от блока к следующему пустому блоку. Наводимся на стрелку, и нажимаем на шестеренку:
Внутри выставляем “Задержку перед ответом” 1 секунду. Ставим “не отменять” в настройке стрелки.
В следующем блоке пишем нужный вам текст. Для примера: “Напиши свой текст, который хочешь обработать”
Отводим стрелку к следующему пустому блоку, и заходим в настройки стрелки. В настройках стрелки активируем “Пользователь вводит данные”. Туда вводите свою переменную. Для примера использовалась text_zvukogram
В следующем блоке указываем можно указать текст, для клиента, он будет понимать что его текст пошёл в обработку
Как ввели текст, мы выбираем внутри блока API - запрос
После мы выбираем тип запроса GET
А в URL - запроса мы вводим уже ссылку которая указана в самом начале (https://zvukogram.com/index.php?r=api/text) .
К ссылке мы добавляем обязательные параметры с документации. Сейчас я укажу готовую ссылку, внутри вы вставляете свои значения: https://zvukogram.com/index.php?r=api/text&token=APITOKEN&email=MAIL&voice=VOICE&text=#{TEXT}
APITOKEN - токен, который берется в личном кабинете на сайте. В разделе “Профиль”.
VOICE - берем название голоса в разделе “Озвучка текста”
MAIL - берем почту в личном кабинете, в разделе “Профиль”
TEXT - указываем переменную, которую указывали выше(где запрашивали текст у пользователя)
Далее мы отводим стрелку к другому пустому блоку, заходим в настройки стрелки, ставим 1 секунду задержку, и “не отменять” бегунок.
И в последнем блоке мы указываем интересующий нас текст. В примере был указан “Ваша ссылка на скачивание озвучки текста:”
Далее идем в калькулятор, и достаем ответ от сервера. Прописываем: data(здесь может быть любая ваша переменная) = #{custom_answer}
После чего мы достаем из ответа ссылку на сам файл. Прописываем: file_zvukogram(здесь может быть любая ваша переменная) = data(либо ваша переменная, которую указывали выше)[‘file’]
Тем самым, вы достали из ответа сервера ссылку на сам файл озвучки. Теперь эта ссылка хранится в переменной file_zvukogram. Её вы можете теперь добавить в текст. Пример: “Ваша ссылка на скачивание озвучки текста: #{file_zvukogram}”
Клиенту придет сообщение с ссылкой на скачивание.
Итог, как видит клиент общение с ботом:
2 вариант - постановка задачи на озвучку текста.
Рассмотрим второй вариант настройки озвучки
Нам понадобиться ссылка с документации : https://zvukogram.com/index.php?r=api/longtext
Далее, мы идем в Salebot.pro , в вашем проекте добавляем блок для старта
В условии прописываем start (либо любое условие по которому запускается бот)
Отводим стрелку от блока к следующему пустому блоку. Наводимся на стрелку, и нажимаем на шестеренку:
Внутри выставляем “Задержку перед ответом” 1 секунду. Ставим “не отменять” в настройке стрелки.
В следующем блоке пишем нужный вам текст. Для примера: “Напишите ваш текст для обработки”
Отводим стрелку к следующему пустому блоку, и заходим в настройки стрелки. В настройках стрелки активируем “Пользователь вводит данные”. Туда вводите свою переменную. Для примера использовалась text_zvuka
В следующем блоке указываем можно указать текст, для клиента, он будет понимать что его текст пошёл в обработку
Как ввели текст, мы выбираем внутри блока API - запрос
После мы выбираем тип запроса GET
А в URL - запроса мы вводим уже ссылку которая указана в самом начале 2 варианта (https://zvukogram.com/index.php?r=api/longtext).
К ссылке мы добавляем обязательные параметры с документации. Сейчас я укажу готовую ссылку, внутри вы вставляете свои значения: https://zvukogram.com/index.php?r=api/longtext&token=APITOKEN&email=MAIL&voice=VOICE&text=#{TEXT}
APITOKEN - токен, который берется в личном кабинете на сайте. В разделе “Профиль”.
VOICE - берем название голоса в разделе “Озвучка текста”
MAIL - берем почту в личном кабинете, в разделе “Профиль”
TEXT - указываем переменную, которую указывали выше(где запрашивали текст у пользователя)
Добавляем в сохраненные значение то, что придет нам от сервера. Нам нужно ID, уникальный номер. Оно достается так “ id -> id_zapisi(тут может быть любая ваша переменная) “
Мы отводим следующую стрелку к пустому блоку, наводимся на стрелку, нажимаем на шестеренку и настраиваем ее.
Текст будет большой, поэтому ставим задержку побольше. В примере указано 20 секунд. Ставим активным “не отменять”.
В следующем блоке мы открываем его, и нажимаем на
Выбираем тип запроса GET
А в URL - запроса мы вводим уже ссылку https://zvukogram.com/index.php?r=api/result
К ссылке мы добавляем обязательные параметры с документации. Сейчас я укажу готовую ссылку, внутри вы вставляете свои значения: https://zvukogram.com/index.php?r=api/result&token=APITOKEN&email=MAIL&id=#{id_zapisi}
APITOKEN - токен, который берется в личном кабинете на сайте. В разделе “Профиль”.
MAIL - берем почту в личном кабинете, в разделе “Профиль”
ID - указываем переменную, которую указывали выше(где сохраняли ID уникальной записи)
Добавляем в сохраненные значение то, что придет нам от сервера. Нам нужно status и file.
status -> status_id(тут может быть любая ваша переменная);
file -> file_zapis(тут может быть любая ваша переменная)
Делаем следующую стрелку к новому пустому блоку, заходим в настройки стрелки, указываем 1 секунду задержку, выбираем “не отменять” и ниже нажимаем “расширенные настройки”. В расширенных настройках мы в “переменная для сравнения” указываем status_id(тут может быть любая ваша переменная, которую сохраняли выше) == '1'
И в блоке, куда ведет эта стрелка мы указываем текст с ссылкой на файл. В примере использовалось: “Держи ссылку на озвучку: #{file_zapis}(тут может быть любая ваша переменная)”
Теперь, сделаем другое ответвление от блока выше, с проверкой если аудио не было готово. Возвращаемся к блоку
Отводим стрелку в другую сторону на другой блок. Заходим в настройку стрелки, указываем 1 секунду задержку, выбираем “не отменять” и ниже нажимаем “расширенные настройки”. В расширенных настройках мы в “переменная для сравнения” указываем status_id(тут может быть любая ваша переменная, которую сохраняли выше) == '0'
Блок оставляем пустым, и от него введем стрелку обратно. Настраиваем стрелку , указываем 20 секунд задержку, выбираем “не отменять”.
Все. Настройка завершена. Клиент это увидит у себя вот так:
Мы предоставляем вам готовый шаблон для скачивания в json. Его можно загрузить в свой проект и применить для своих целей.
Как его загрузить на платформу. Вы создаете проект, внутри проекта заходите “Резервная копия”
В разделе “Резервная копия”, листаете в самый низ и выбираете “Восстановление файла”.
После вы нажимаете на это окно, выбираете файл который вы скачали у нас, и шаблон в вашем проекте.
Автор статьи: Артём Товмасян (https://t.me/artyomtex), технический директор технического агентства EasyDrafting.
