bothelp.io → weeek.net

Список шагов:
Шаг 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 и др.

Документация находится в разработке!
Создание лида, сделки в срм weeek.net по api

Пункты меню:
Шаг 1. Подготовка данных контакта: здесь нужно подготовить информацию о контакте, которую хотите передать в систему Weeek.
Шаг 2. Настройка отправки данных: после подготовки данных, их нужно настроить для отправки в Weeek при создании нового контакта.
Шаг 3. Получение ID контакта: получение уникального идентификатора контакта после его успешного создания в системе Weeek.
Шаг4 Подготовка данных сделки: подготовка информации о сделке, которая должна быть передана в Weeek.

Шаг 5 Настройка отправки данных о сделке: настройка процесса отправки подготовленных данных о сделке в Weeek.

Шаг 6 Получение ID сделки: получение уникального идентификатора созданной сделки в Weeek.

Шаг 7. Привязка контакта к сделке: подготовка данных для связывания созданного контакта с определенной сделкой в Weeek.

Шаг 8 Отправка данных о привязке контакта к сделке: настройка процесса отправки данных о привязке контакта к сделке в Weeek.

Подготовка необходимых ключей, данных для работы с api_WEEEK:

Шаг 9 Токен для авторизации можно создать и взять тут:

Шаг 10 Для передачи данных, таких как status_id, в CRM WEEEK через API, необходимо выполнить несколько шагов, чтобы получить этот параметр:

 

Шаг 1. 

1. Подготовка данных контакта: здесь нужно подготовить информацию о контакте, которую хотите передать в систему Weeek.

Добавьте действие "JSON Компоновщик" со следующими настройками:

 

В качестве значений для полей можно выбирать доступные поля из источника

JSON:

{     "firstName": "Имя",     "lastName":"Фамилия",     "emails": ["Почта"],     "phones": ["Телефон"] }

 

 

Шаг 2. 

1. Настройка отправки данных: после подготовки данных, их нужно настроить для отправки в Weeek при создании нового контакта.

Добавьте действие "HTTP-запрос" для создания лида/покупателя:

Шаг 2.1 Настройте действие:

Поля:

Метод	POST
Адрес	https://api.weeek.net/public/v1/crm/contacts
Тело	JSON. Результат

 

Заголовки:

Authorization

Bearer ваш токен

Content-Type

application/json

Шаг 3 

1. Получение ID контакта: получение уникального идентификатора контакта после его успешного создания в системе Weeek.

Добавьте действие "JSON-парсер" для получения id контакта:

Шаг 3.1 Настройте действие:

Поля:

JSON: [HTTP-запрос]- [добавление сделки][Содержимое ответа]

 

Поля JSON

Имя	Путь
id контакта	["contact"]["id"]

 

Шаг 4. 

1. Подготовка данных сделки: подготовка информации о сделке, которая должна быть передана в Weeek.

Добавьте действие "JSON Компоновщик" со следующими настройками:

 

Шаг 4.1 В качестве значений для полей можно выбирать доступные поля из источника

JSON:

{     "name": "Название сделки",     "status_id": "статус где будет создана сделка",     "amount": 1000  - цена, сумма, указывается числом! }

 

 

Шаг 5 

1. Настройка отправки данных о сделке: настройка процесса отправки подготовленных данных о сделке в Weeek.

Добавьте действие "HTTP-запрос" для создания сделки в weeek.net

Шаг 5.1 Настройте действие:

Поля:

Метод	POST
Адрес	https://api.weeek.net/public/v1/crm/statuses/[статус(этап)]/deals
Тело	JSON. Результат

Чтобы посмотреть и получить список статусов вашей воронке обратитесь к официальной документации по api. Там вы можете найти информацию о статусах воронок, либо используйте наше описание на Шаге 10 

Заголовки:

Authorization

Bearer ваш токен

Content-Type

application/json

Шаг 6 

1. Получение ID сделки: получение уникального идентификатора созданной сделки в Weeek.

Добавьте действие "JSON-парсер" для получения id сделки:

Шаг 6.1 Настройте действие:

Поля:

JSON: [HTTP-запрос]- [добавление сделки][Содержимое ответа]

Поля JSON:

Имя	Путь
id сделки	["deal"]["id"]

Шаг 7. 

1. Привязка контакта к сделке: подготовка данных для связывания созданного контакта с определенной сделкой в Weeek.

Добавьте действие "JSON Компоновщик" со следующими настройками:

 

Шаг 7.1 В качестве значений выберите [Поле id контакта]

JSON:

{     "contactId": "[Поле id контакта]" }

 

 

Шаг 8 Отправка данных о привязке контакта к сделке: настройка процесса отправки данных о привязке контакта к сделке в Weeek.

Добавьте действие "HTTP-запрос" для привязки контакта к сделке в weeek.net

Шаг 8.1 Настройте действие:

Поля:

Метод	POST
Адрес	https://api.weeek.net/public/v1/crm/deals/id сделки/contacts
Тело	JSON. Результат

 

Заголовки:

Authorization

Bearer ваш токен

Content-Type

application/json

 

Шаг 9 Токен для авторизации можно создать и взять тут:

 

Шаг 10 Для передачи данных, таких как status_id, в CRM WEEEK через API, необходимо выполнить несколько шагов, чтобы получить этот параметр:

Для передачи данных, таких как status_id, в CRM WEEEK через API, необходимо выполнить несколько шагов, чтобы получить этот параметр:

1. Получение списка воронок (funnels):

• Сначала требуется получить список воронок, чтобы узнать funnelId. Это можно сделать через GET-запрос:

   curl -X GET "https://api.weeek.net/public/v1/crm/funnels" \
   -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
   -H "Content-Type: application/json"

На полученный ответ ты получишь все воронки и их идентификаторы.

2. Получение статусов воронки:

• Используя funnelId, полученный на предыдущем шаге, ты можешь запросить список статусов конкретной воронки, чтобы узнать status_id:

   curl -X GET "https://api.weeek.net/public/v1/crm/funnels/{funnelId}/statuses" \
   -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
   -H "Content-Type: application/json"

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

3. Использование status_id в запросах:

• После получения status_id, ты можешь использовать его в  API-запросах.

Не забудь заменить YOUR_ACCESS_TOKEN на свой API токен, а {funnelId} на реальный идентификатор воронки. Если потребуется помощь, ты всегда можешь обратиться в техническую поддержку через телеграм-бота_weeek или по почте support@weeek.net.
Для помощи в настройке с  webjack можешь обратиться в техническую поддержку через телеграм-бота_AlexWebjack