bothelp.io → HTTP-запрос. Отправка данных

Список шагов:
Шаг 1.Добавления источника.
Шаг 2. Настройка отправки данных из bothelp.io.
Шаг 2.1  Настройте действие по отправке данных
Шаг 3. Настройка получения данных

Настройка получения данных из bothelp.io

Шаг 1. Добавления источника.
Выберите источник данных "HTTP-Запрос (Webhook)".

Нажмите на кнопку "Добавить"

Шаг 1.1 Не изменяя параметров, нажмите кнопку "Сохранить"

Шаг 1.2 Скопируйте ссылку.

Шаг 2. Настройте отправку данных в вашем bothelp.io.

Перейдите в Боты

Редактировать

Нажмите  кнопку плюс "✢"

Выберите кнопку Действия "⚡︎"

 

Шаг 2.1  Настройте добавленое действие "Действия 1".

1. Нажмите на  "Действия 1".
2. Нажмите на кнопку "Добавить действие".
3. Из списка выберите "Отправить данные подписчика через Webhook".
4. Вставьте скопированную ссылку из webjack.ru "Шаг 1.2" в поле "Отправить данные подписчика через Webhook".
5. Нажмите на кнопку "Сохранить и закрыть".

Шаг 3. Настройка получения данных.
Добавьте действие "JSON-Парсер". Для этого нажмите накнопку "Добавить"

Шаг 3.1 Выберите пункт меню "JSON. Парсер"

Шаг 3.2  Настройте действие "JSON-парсер", как указано на рисунке ниже.
добавьте все необходимые  поля с данными в формате "JSON" приходящие из bothelp.io

												HTTP-запрос Тело	{"bothelp_user_id":2, "created_at":1718979405, "name":"TestName", "first_name":"TestFirstName", "last_name":"", "profile_link":"", "email":"", "phone":"79999999999", "ref":"", "utm_medium":"", "utm_source":"", "utm_campaign":"", "utm_term":"", "utm_content":"", "conversations_count":1,"first_contact_at":1718977647, "last_contact_at":1718979404,"user_id":"963133715", "messenger_username":"UserName", "created_at_show":"21/06/2024 14:16:45 UTC", "cuid":"8tz6.2"}

Чтобы получить  поля name, phone, messenger_username мы должны настроить JSON-парсер следующим образом:

Имя:	Путь:
Имя	["name"]
Телефон	["phone"]
Телеграм	["messenger_username"]

В поле "JSON" выберите значение поля "HTTP-запрос. Тело" из списка доступных полей.

В блок "Поля JSON" укажите настройки для получения списка нужных полей.
На скрине выше выбраны стандартные поля из телеграм подписчика.
Также можно добавить кастомные(доп. поля) которые вы создавали сами в боте.

Нажмите на кнопку "Сохранить".

На этом настройка получения данных о поступивших заявках из bothelp.io закончена.
Заявки для компании, для которой вы настроили отправку, будут поступать в обработку.
Далее можно настроить действия по отправке этих данных в amoCRM, Bitrix24, Telegram и др.

Интеграция с произвольными сервисами через API

Многие сервисы имеют свое API и могут принимать http-запросы. С помощью этих запросов можно создавать контакты, заявки, сделки, отправлять письма и т.д.

Набор возможностей определяется сервисом, в который вы собираетесь отправлять запрос.

У каждого сервиса, который имеет свое API и может принимать запросы есть документация. В этой документации подробно описывается каким образом надо формировать запрос, куда отправлять и т.д.

Сформируйте нужный вам http-запрос

С помощью этого действия можно сформировать практически любой http-запрос. Можно задать все необходимые параметры запроса, указать адреса, заголовки, тело запроса и т.д. Ниже мы разберем основные параметры и дополнительные действия, необходимые для этого.

Еще раз отметим, что все подробности указаны в документации того сервиса, куда вы хотите отправлять запрос.

Добавьте действие http-запрос

Параметры запроса

Заполните параметры запроса

Метод
Укажите метод отправки данных. Это может быть POST или GET запрос.

GET-запросы чаще всего используются для получения данных,

POST-запросы чаще для отправки данных. Но метод зависит от того какой запрос ожидает сервер, на который вы будете отправлять HTTP-запрос.

Адрес
Нужно указать адрес, на который будет отправляться запрос. Например, сервис Bizon365 принимает запросы по адресу https://online.bizon365.ru/api/v1/course/student/add

В вашем случае адрес нужно взять из документации сервиса, куда вы хотите отправлять данные.

Тело
Чаще всего в теле запроса отправляют данные в формате "Form Urlencoded" или "JSON".

Если это необходимо, то сначала надо отдельным действием сформировать нужные данные, и потом указать их в этом поле.

Успешные коды статуса:

Укажите коды статуса, при которых надо считать, что запрос выполнился успешно.

По умолчанию это "2**", т.е. все успешные коды

Параметры строки запроса
Перечислите все параметры, которые необходимо добавить в строку запроса. Это могут поля с данными, например, name/phone или другие необходимые параметры.

Заголовки
В заголовках часто передают служебную информацию: коды для авторизации, токены и т.д.

Если в теле запроса вы отправляете данные, то в большинстве случаев необходимо указать тип данных которые вы отправляете.

Если в теле запроса данные в формате "Form Urlencoded", то необходимо добавить заголовок:
Content-Type: application/x-www-form-urlencoded

Если в теле запроса "JSON", то необходимо добавить заголовок:
Content-Type: application/json

Сохраните действие.