Вконтакте. Лид-формы → Создание лида или сделки в weeek.net

Выберите Источник "VK. Лид-формы"

Выберите пользователя Вконтакте

Нажмите на кнопку выбора для поля "Пользователь VK"

Нажмите на кнопку “Подключить”

Авторизуйтесь в ВКонтакте (пользователь должен имеет доступ к лид-формам страницы и к рекламной кампании)

Укажите название для подключения к ВКонтакте

Нажмите кнопку “Выбрать”

Выберите группу ВКонтакте

Нажмите на кнопку выбора поля "Группа VK".

Выберите группу ВКонтакте и нажмите кнопку "Получить токен"

Нажмите "Разрешить"

После этого выберите вашу группу и нажмите кнопку "Выбрать"

Выберите лид-формы

После выбора группы будут отображены все ее лид-формы.

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

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

После того как пользователь заполнит лид-форму, данные будут автоматически поступать в Webjack.

Нажмите кнопку "Сохранить". Интеграция завершена.

Если данные не поступают в обработку Webjack, то тогда необходимо проверить подключение по инструкции ниже

Проверка подключения

Необходимо проверить действительно ли ВКонтакт подключил форму (в некоторых случаях ВКонтакте не делает этого)
Для этого необходимо зайти в настройки группы ВКонтакте и убедится, что напротив сервера WebJack горит зеленая галочка

Если напротив сервера WebJack стоит красная галочка, то значит подключение НЕ установлено.

Какие права в группе надо иметь?

Чтобы подключить группу и получить данные из лид-форм необходимо иметь в группе права "Администратор".

Альтернативные способы подключения

Если автоматически подключение не установлено, то есть 2 способа:

Вариант 1. Можно удалить созданный сервер WebJack и попробовать провести подключение описанным выше способом заново.

Вариант 2. Скопировать код подтверждения из настроек ВКонтакте и установить его в настройках WebJack

Адрес, который должен быть в настройках ВКонтакте: https://webjack.ru/webhooks/vk/group/

Выберите нужную группу из списка и нажмите на кнопку "Установить код подтверждения"

Вставьте код подтверждения, скопированный из ВКонтакте и нажмите на кнопку "Сохранить"

После этого нажмите на кнопку "Подтвердить" в настройках группы ВКонтакте

Если все сделано верно, то должна появится зеленая галочка.

После этого зайдите во вкладку "Типы событий"

И отметьте галочкой пункт "Lead forms: Новая заявка"

После этого ВКонтакте будет отправлять лиды в обработку WebJack.

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