Данная функция ассистента позволяет отправлять произвользый HTTP запрос (вебхук) и передавать в нем данные.
Что такое Вебхуки простыми словами?
Представьте, что вебхук — это как автоматический "звонок" или уведомление, которое ваш ИИ-ассистент может отправить другому сервису в интернете. Как только в диалоге с пользователем происходит какое-то важное событие (например, пользователь оставил заявку или указал свой номер телефона), ассистент может мгновенно передать эту информацию по указанному вами веб-адресу (URL).
Функция пригодится тем, кто хочет:
Передавать информацию во внешние системы.
Передавать данные для отправки SMS-уведомлений клиентам или менеджерам.
Отправлять сообщения в мессенджеры (например, WhatsApp, Telegram) через специальные шлюзы или API.
Записывать данные в базы данных, Google Таблицы (помимо стандартной интеграции) или любые другие ваши внутренние системы.
Как работает?
Это универсальный инструмент: вы можете отправлять данные на любой URL. Главное — правильно настроить логику ассистента (через промт или сценарий), чтобы он понимал, когда и что отправлять.
Важно: Сейчас функция работает только на отправку данных.
Параметры:
Метод HTTP-запроса . Можно использовать стандартные методы: GET , POST . По умолчанию используется GET .
Адрес (URL) , на который будет отправлен запрос.
Заголовки запроса в формате JSON.
Например: {"Content-Type": "application/json", "Authorization": "Bearer token"}
Используется для передачи дополнительной информации, такой как тип контента или токен авторизации.Тело запроса в формате JSON. Актуально для метода POST, когда нужно отправить данные на сервер.
Пример: Отправка в WhatsApp
Пример простого запроса для отправки смс с использованием сервиса wappi.pro
Представься что ты бот поддержки и что ты передашь запрос коллеге. Спроси у пользователя телефон и удобный способ связи: звонок или WhatsApp ?
После получения номера телефона пользователя и способа связи, отправь всю информацию на номер XXXX:
Метод HTTP запроса: POST
URL (не меняй его): https://wappi.pro/api/sync/message/send?profile_id=***
Заголовки: {
"Authorization": "***",
"Content-Type": "application/json"
}
Тело запроса: {
"body": ЗАЯВКА "{Информация о диалоге}"
"recipient": "XXXX"
}Таким образом, после получения всех данных от пользователя, они будут подставлены в запрос и он будет вызван!
Пример: Отправка СМС
Пример простого запроса для отправки смс с использованием сервиса https://smsaero.ru/:
Спроси у пользователя его имя, телефон и возраст.
После получения всех данных отправь их:
Метод HTTP запроса: GET
URL (не меняй его): https://_ДОСТУПЫ_К_API_@gate.smsaero.ru/v2/sms/send?number={номер телефона}&text={имя и возраст}&sign=SMS Aero
Заголовки: пустые
Тело запроса: пустоеТаким образом, после получения всех данных от пользователя, они будут подставлены в URL и он будет вызван!
Пример: Добавление записи в Гугл-таблицу
1. Настройка доступа к таблице
Прежде чем отправлять данные в Google Таблицу, нужно разрешить доступ:
Откройте нужную таблицу.
В правом верхнем углу нажмите на кнопку "Настройки доступа".
Установите доступ: "Все, у кого есть ссылка" — это нужно, чтобы скрипт мог отправлять данные без ограничений.
2. Создание скрипта для обработки данных
Теперь нужно добавить код, который будет принимать и обрабатывать данные:
В меню таблицы выберите "Расширения" → "Apps Script".
В открывшемся редакторе создайте функцию, которая будет получать данные и работать с ними.
Пример функции принимает три параметра:
name — строка (имя пользователя),
age — строка (возраст пользователя),
phone — число (номер телефона).
Код скрипта ниже:
function doGet(request) {
const {name,age,phone} = request.parameter //получение параметров
const sheet = SpreadsheetApp.getActiveSheet("Лист1") //получение активного листа
const lastRow = sheet.getLastRow() + 1 //получение последней строчки таблицы
sheet.getRangeA${lastRow}).setValue(name) //вывод значения переменной userName в столбец А
sheet.getRangeB${lastRow}).setValue(age) //вывод значения переменной userLastname в столбец B
sheet.getRangeC${lastRow}).setValue(phone) //вывод значения переменной userLastname в столбец B
return ContentService.createTextOutput("Данные успешно добавлены.");
}3. Публикация скрипта как веб-приложения
После того как написан скрипт, нужно сделать его доступным для внешнего вызова:
Нажмите "Начать развертывание" → "Новое развертывание". (новое развертывание необходимо делать при каждом изменении скрипта!)
Выберите тип развертывания: "Веб-приложение".
При запросе доступа — подтвердите, нажав "Предоставить доступ".
В меню "У кого есть доступ" выбраит Все
После публикации скопируйте ссылку из поля "Веб-приложение". Она будет выглядеть примерно так:
https://script.google.com/macros/s/AKf...
4. Написание инструкции в промте
Теперь преобразуем ссылку, чтобы в нее передавались параметры: https://script.google.com/macros/s/AK*****mJ2/exec?name={имя}&age={возраст}&phone={телефон}
Напишем конечную инструкцию:
Спроси у пользователя его имя, телефон и возраст.
После получения всех данных отправь их:
Метод HTTP запроса: GET
URL (не меняй его): https://script.google.com/macros/s/AK*****mJ2/exec?name={имя}&age={возраст}&phone={телефон}
Заголовки: пустые
Тело запроса: пустоеТаким образом можно вызывать любые внешние сервисы, которые вам необходимы в работе.
Если вам будет нужна помощь в настройке, то обращайтесь в поддержку