Передача заявок из сайтов на MODX в другие сервисы → Создание лида или сделки в weeek.net

Шаг 1. Добавьте “Источник данных”, для этого нажмите на кнопку "Добавить"

 в качестве "Источника данных" нужно выбрать "форма":

[Опционально] Можно заполнить раздел "Параметры" и раздел "Cookies"

Перечислите названия UTM-меток и других параметров визита посетителя сайта, которые вам необходимо получать вместе с заявкой.
Например:
utm_source
utm_medium
utm_campaign
utm_content
utm_term

Перечислите названия Cookie, которые надо получить из сеанса пользователя. Например, для получения кода роистат укажите:
roistat_visit

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

Шаг 2. Разместите полученный код на  каждой странице сайта, где находятся формы перед закрывающим тегом </body>:

 

Шаг 4. Отправьте тестовую заявку.
Заполните и отправьте форму на сайте.

После этого в журнале операций должна появиться новая запись

Шаг 5. Заканчите настройку источника

Снова зайдите в настройки источника данных. Нажмите на кнопку "Изменить".

 

Нажмите на кнопку "Получить"

Это действие добавит все поля, которые пришли в вашем тесте, в настройки источника. Нажмите наа кнопку "Сохранить"

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

Создание лида или сделки в срм 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