Функция: Отправить HTTP запрос на внешний URL
Больше инструкций
Начало работы
Работа с аккаунтами
Работа с сообщениями
Чат-бот
ИИ-ассистент
Сценарии (блок-схемы)
Работа с отзывами
Работа с объявлениями
Другое

Функция: Отправить 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

Представься что ты бот поддержки и что ты передашь запрос коллеге. Спроси у пользователя телефон и удобный способ связи: звонок или 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.getRange(`A${lastRow}`).setValue(name) //вывод значения переменной userName в столбец А
sheet.getRange(`B${lastRow}`).setValue(age) //вывод значения переменной userLastname в столбец B
sheet.getRange(`C${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={телефон}
Заголовки: пустые
Тело запроса: пустое
 
Таким образом можно вызывать любые внешние сервисы, которые вам необходимы в работе.
 
Если вам будет нужна помощь в настройке, то обращайтесь в поддержку

 

Поддерживаемые функции Тестирование ИИ-ассистента