Функция: Отправить HTTP запрос на внешний URL
Данная функция ассистента позволяет отправлять произвользый 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
После получения номера телефона пользователя и способа связи, отправь всю информацию на номер 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
— число (номер телефона).
Код скрипта ниже:
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={телефон}
Заголовки: пустые
Тело запроса: пустое