Smart Tracker AMIHUB в большинстве случаев умеет отправлять данные об онлайн покупках, если у вас настроена электронная торговля Google Analytics или Яндекс.Метрики. Однако при использовании этого метода в отчетах по доходам не будут учтены возвраты товаров или услуг, что хоть и минимально, но влияет на отчет.
Чтобы настроить получение данных по суммам транзакций, включая возвраты, необходимо настроить интеграцию через API с вашей системой CRM.
Эти данные отправляются при помощи Webhook (то есть данные будут отправляться каждый раз при изменениях в транзакциях (покупка, возврат или частичный возврат) в CRM).
Для авторизации будет необходим Webhook Token, который находится в разделе «Администратор» ⟶ «Интеграции».
Покажите следующую документацию вашему разработчику для настройки интеграции с CRM через API.
---
id: webhook-api
title: API
sidebar_label: Транзакции
---
### Транзакции |
Для расчета метрик в отчетах необходима информация об оплаченных заказах. Для этого необходимо отправлять информацию о транзакциях в AMIHUB.
Транзакция — фактическая оплата заказа/услуги.
Для того чтобы информация об оплаченных заказах отображалась в отчетах, необходимо [отправлять событие создания заказа](/docs/tracker-js#другие-методы-событий).
Для получения токена проекта перейдите в личный кабинет AMIHUB на страницу «Администратор» -> «Интеграции» -> Webhook token.
Код валюты необходимо указывать в международном формате (USD, EUR, KZT, UAH, RUB). Все транзакции конвертируются в базовую валюту проекта по текущему курсу на момент получения транзакции.
### Отправка методом GET |
Запрос принимает общую сумму транзакции.
**URL:** https://api.amihub.tech/crm/transaction
**METHOD:** GET
**PARAMS:** project_token, order_id, total_price, currency
### Отправка методом POST |
Позволяет отправить информацию об оплате заказа, разделенную по товарам.
**URL:** https://api.amihub.tech/crm/transaction **METHOD:** POST **CONTENT-TYPE:** application/json **DATA:** ```json { "data": { "project_token": "project_token_here", "order_id":"order_id_here", "products":[ { "id": "1", "price": 1000, "currency": "KZT" }, { "id": "2", "price": 2000, "currency": "KZT" } ] } } ``` |
### Примеры отправки транзакций |
<!--DOCUSAURUS_CODE_TABS--> <!--Node JS--> ```js const request = require('request'); request({ method: "POST", url: "https://api.amihub.tech/crm/transaction", json: { "data": { "project_token": "project_token_here", "order_id":"order_id_here", "products":[ { "id": "1", "price": 1000, "currency": "KZT" }, { "id": "2", "price": 2000, "currency": "KZT" } ] } } }, (err, res) => { if(err) console.error(err); console.log(res); }); ``` <!--Python--> ```py import requests
API_ENDPOINT = "https://api.amihub.tech/crm/transaction"
# your webhook project token here PROJECT_TOKEN = "XXXXXXXXXXXXXXXXX" data = { "data": { "project_token": PROJECT_TOKEN, "order_id":"ХХХХХХХХ", "products":[ { "id": "1", "price": 1000, "currency": "KZT" }, { "id": "2", "price": 2000, "currency": "KZT" } ] } }
r = requests.post(url = API_ENDPOINT, data = data)
result = r.text ``` <!--END_DOCUSAURUS_CODE_TABS--> |