Как настроить передачу данных программу лояльности?

В статье описано как настроить передачу данных из Aplaut в программу лояльности

Мы можем оповестить вашу программу лояльности о написании отзыва, отправив данные в JSON формате, для того, чтобы вы смогли начислить баллы пользователю.

Для настройки этого нам необходимо:

  1. Дать нам URL хоста, на который нужно отправлять webhook.
  2. Если установлена защита по IP, добавить наши IP в белый список, предварительно уточни их у своего менеджера или в чате технической поддержки.

Пример вебхука для отзыва (формат JSON):

 {   
"id": "613f59762f42f8001932b595", (тип — string (ID отзыва))   
"created_at": "2021-09-13T17:00:22.176+03:00",   
"updated_at": "2021-09-13T17:00:22.176+03:00",   
"context_type": "product",   
"external_id": null,   
"rating": 5.0,   
"rating_details": [],   
"author_details": [     
{       
"label": "Email:",       
"name": "email",       
"value": "test@test.com"     
},   
],   
"lang": "ru",   
"body": "Отличные саморез для работы с деревом",   
"pros": null,   
"cons": null,   
"published_at": null,   
"imported_at": "2021-09-13T17:00:22.151+03:00",   
"author_name": "Константин",   
"author_email": null,   
"origin": "omnibox",   
"syndication_source": null,   
"state": "published”,   
"product_id": "5ac6c4514b25650007dfbb7b",   
"photos": [],   
"videos":[],   
"tags": [],   
"recommended": true,   
"custom_attributes": { "submitted_product_id": "160979" },   
"location_name": "Санкт-Петербург",   
"likes": 0,   
"dislikes": 0,   
"order_number": null,   
"custom_source": null,   
"custom_medium": null,   
"custom_campaign": null,   
"location": {     
"continent_code": "EU",     
"continent": "Европа",     
"country_code": "RU",     
"country": "Россия",     
"city": "Санкт-Петербург",     
"postal_code": "190807",     
"latitude": 59.8981,     
"longitude": 30.2619,     
"time_zone": "Europe/Moscow",     
"client_ip": "5.18.171.189"   },   
"comments": [],   
"product": {     
"name": "Саморезы по дереву 4.0x40 мм потайная головка конструкционный (500 шт.)",     
"url": "https://yoursite.ru/",     
"external_id": "11111111", (тип — string (Внешний ID товара (offer.id в YML файле)))     
"alias": null,     
"group_id": null,     
"category_name": "Саморезы (шурупы) по дереву конструкционные",     
"brand_name": null,     
"description": "Предназначены для монтажа деревянных конструкций из цельной и срощенной древесины между собой, а так же металлических конструкций (например: уголки крепежные, пластины, металлический профиль) к основанию из цельной или срощенной древесины. Шурупы имеют потайную головку, шлиц в форме шестигранной звезды TORX Т20, неполную крупную резьбу, острый с ребрами наконечник, который предотвращает раскалывание древесины. Не требуют предварительного засверливания.nИзготовлены из стали, имеют желтопассивированное защитное покрытие.nnТехнические характеристики:nДиаметр шурупа: 4 мм.nДлина шурупа: 40 мм.nДлина резьбы: 24 мм.nПроизводитель: Тайвань.",     
"recommended_product_ids": [],     
"custom_attributes": {},     
"reviews_count": 15,     
"questions_count": 0,     
"published_group_reviews_count": 13,     
"published_group_questions_count": 0,     
"rating": 3.25,     
"rating_details": [],     
"recommended": 53.84615384615385,     
"created_at": "2018-04-06T03:50:25.367+03:00",     
"updated_at": "2021-09-13T07:37:43.112+03:00"   } } 


Сейчас вебхуки работают по следующим событиям:

1. Отзыв
Создание = "create_review"
Обновление = "update_review"
Удаление = "destroy_review"
Публикация = "publish_review"
Бан = "ban_review"
Обновление тегов = "update_review_tags"

2. Комментарий к отзыву
Создание = "create_comment"
Обновление = "update_comment"
Удаление = "destroy_comment"

3. Ответ на опрос
Создание = "create_survey_response"
Обновление тегов = "update_survey_response_tags"

4. Вопрос
Создание = "create_question"
Обновление = "update_question"
Удаление = "destroy_question"

5. Ответ на вопрос
Создание = "create_answer"
Обновление = "update_answer"
Удаление = "destroy_answer"

6. Диалог
Создание = "create_conversation"


Примечания.

  • В вебхуках не предусмотрены дополнительные фильтры, а также не настраивается содержание ответа.
  • Если в ответ на отправку вебхука мы получаем ошибку, он отправится снова еще несколько раз.
👆 На этом пока всё