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. Получение токена для авторизации
Шаг 2. Получение status_id и funnelid через API
Шаг 3. Подготовка данных контакта
Шаг 4. Настройка HTTP-запроса для отправки данных о контакте
Шаг 5. Получение ID контакта
Шаг 6. Подготовка данных сделки
Шаг 7. Настройка HTTP-запроса для отправки данных о сделке

Шаг 1. Получение токена для авторизации

На этом этапе мы расскажем где взять токен авторизации, он нам понадобиться для http-запросов:

• Настройки>API>Добавить токен.
• Напишите название> нажмите сохранить>скопируйте Токен.

Шаг 2. Получение status_id и funnelid через API

В CRM WEEEK параметр  status_id представляет собой идентификатор статуса, который используется для отслеживания этапов сделок или лидов в системе. Этот идентификатор необходим для работы с API WEEEK, особенно при создании или обновлении записей о сделках.

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

Получение списка воронок (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"

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

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

• Используя 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.

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

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

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

Шаг 3. Подготовка данных контакта

Подготовьте информацию о контакте, настройте действие чтобы потом передать его в Weeek.

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

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

JSON:

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

Шаг 4. Настройка HTTP-запроса для отправки данных о контакте

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

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

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

Поля:

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

Заголовки:

Authorization

Bearer "ваш токен полученный на шаге 1"

Content-Type

application/json

Шаг 5. Получение ID контакта

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

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

Настройте действие.

Поля:

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

 

Поля JSON

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

Шаг 6. Подготовка данных сделки

Подготовим информацию о сделке, настройте действие чтобы потом передать его в Weeek.

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

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

JSON:

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

status_id можно  получить на шаге 2.

Шаг 7. Настройка HTTP-запроса для отправки данных о сделке

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

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

Поля:

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

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

Заголовки:

Authorization

Bearer "ваш токен из шага 1"

Content-Type

application/json