Интеграция Звукограм с Salebot - инструкция

, Обновлено 04 февраля 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.

Поддержка

Если остались вопросы по озвучке, то задайте их в чате поддерки в телеграм @zvukogram
2024 - Звукограм