# Postbacks

Раньше при интеграции у партнёров часто возникало много вопросов — что настроить, где подключить, как всё правильно запустить. Чтобы упростить процесс и сэкономить вам время, мы решили добавить готовые интеграции: всё уже продумано за вас, достаточно просто подключиться.

{% hint style="info" %}
Некоторые интеграции пока ещё в разработке, но мы заранее подготовили для вас примеры правильной настройки. 
{% endhint %}

### ИНСТРУКЦИЯ ПО СОЗДАНИЮ КАСТОМНОЙ ИНТЕГРАЦИИ (если готовой ещё нет)

Если нужной вам интеграции в списке пока нет — не переживайте. Вы можете настроить всё вручную.

1\)  Откройте трекер. Когда окажетесь внутри, найдите в меню раздел **«Интеграции»** и перейдите туда.

<figure><img src="/files/dv4EJbdAaVdVSB3tsXtI" alt=""><figcaption></figcaption></figure>

2\) На этапе настройки укажите параметр, в который в вашей партнёрке будет записываться наш **clickid**.\
\
Это важно: без этого параметра мы не сможем корректно отслеживать конверсии и передавать данные.

<figure><img src="/files/gLbf2dJuxVvNxrWFlaRV" alt=""><figcaption></figcaption></figure>

3\) Создайте конфигурации постбеков (ваши ссылки).

Обычно делают три постбек-ссылки:

* для регистрации (**Registration**)

(вам необходимо самостоятельно задать ивенты - для регистрации registration)

* для первого депозита (**First Deposit**)

(для ФД первого депозита - sale)

* и для повторных депозитов (**Recurring Deposit**)

&#x20;(для РД - resale или sale + tid)<br>

<figure><img src="/files/pAxH22KCDuJLKoasGMh0" alt=""><figcaption></figcaption></figure>

Чтобы увидеть сами ссылки, просто нажмите на значок **`>`** рядом с нужным полем — там и будет спрятана ваша готовая ссылка.

* Registration - вы получили готовую ссылку, которую нужно вставить в партнерку.

<https://api.chatterfy.ai/api/postbacks/48d0524a-3abb-4cd5-82b8-404fa1cb4f7e/tracker-postback?tracker.event=registration&clickid=sub1>

Если ваша партнёрка передаёт дополнительную информацию о клиентах — например, **ID пользователя** или **гео** вы можете настроить, какие именно данные хотите забирать.

Для этого нужно прописать:

1. **Ключ кастомного поля** - кастомное поле, которое вы создали внутри Chatterfy.
2. **Параметр** — откуда именно в партнёрке брать значение

<figure><img src="/files/7Bs8WjbFLic2nG63OTiG" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**ПРИМЕР:**\
\
Пишите `fields.userid` — и указываете, что он подтягивается из `{user_id}` партнёрки.
{% endhint %}

* First Deposit  - вы получите ссылку, но сразу вставлять её в партнёрку нельзя.&#x20;

Сначала ccылку нужно правильно **самостоятельно** **преобразовать** — настроить все параметры так, чтобы партнёрка понимала, что за событие вы передаёте.

{% hint style="info" %}
Вы получите: \
\
&#x20;<https://api.chatterfy.ai/api/postbacks/48d0524a-3abb-4cd5-82b8-404fa1cb4f7e/tracker-postback?tracker.event=first_deposit_&clickid={sub1}>
{% endhint %}

\
Дальше — важно:\
**вам нужно самостоятельно преобразовать ссылку** под свою партнёрку.

{% hint style="success" %}
Пример готовой преобразованной ссылки:<br>

[https://api.chatterfy.ai/api/postbacks/48d0524a-3abb-4cd5-82b8-404fa1cb4f7e/tracker-postback?](https://api.chatterfy.ai/api/postbacks/48d0524a-3abb-4cd5-82b8-404fa1cb4f7e/tracker-postback?tracker.event=first_deposit_\&clickid={sub1})[tracker.event=sale\&clickid={sub1}\&tracker.cost={amount}\&tracker.currency=usd](https://api.chatterfy.ai/api/postbacks/6d1f4e36-b910-4fa1-98f0-11a2df93f054/tracker-postback?tracker.event=sale\&clickid={sub1}\&tracker.cost={amount}\&tracker.currency=usd)
{% endhint %}

Здесь:

`{amount}` — сумма депозита,

`{currency}` — валюта операции.

Эти параметры могут отличаться в зависимости от вашей партнёрки.

* Recurring Deposit  - вы получите ссылку, **но сначала её нужно правильно преобразовать**

{% hint style="info" %}
Вы получите: \
\
<https://api.chatterfy.ai/api/postbacks/48d0524a-3abb-4cd5-82b8-404fa1cb4f7e/tracker-postback?tracker.event=recurring_deposit_&clickid={sub1}>
{% endhint %}

Дальше — важно:\
**вам нужно самостоятельно преобразовать ссылку** под свою партнёрку

{% hint style="success" %}
Пример готовой преобразованной ссылки:\
\
<https://api.chatterfy.ai/api/postbacks/48d0524a-3abb-4cd5-82b8-404fa1cb4f7e/tracker-postback?tracker.event=resale&clickid={sub1}&tracker.tid={event_id}>
{% endhint %}

3\) Далее переходим в раздел создания ссылки \
\
`Link name` - Registration (внутреннее название вашей ссылки) \
`Base URL` - вставьте ссылку которую вам дала партнерка (ссылка которую вы даете лиду)&#x20;

В разделе **Final URL with Parameters** вы получите готовую ссылку, в которой уже будут стоять все необходимые параметры.

В эту ссылку вы можете добавлять любые параметры, нужные вам, например:\
\
<https://api.chatterfy.ai?sub4=\\{{tracker.clickid\\}}>

<figure><img src="/files/QSlSxoMKqBY8yKkDzSoT" alt=""><figcaption></figcaption></figure>

### ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ГОТОВЫХ ИНТЕГРАЦИЙ&#x20;

{% hint style="info" %}
Разберем на примере IGaming, везде где написано soon - значит, что интеграция еще в разработке
{% endhint %}

1\) Нажимаем на интеграцию 1win

<figure><img src="/files/Nn0rCtu3Z3L24r0unLto" alt=""><figcaption></figcaption></figure>

2\) На этапе настройки укажите параметр, в который в вашей партнёрке будет записываться наш **clickid (в данном примере - sub4)**

<figure><img src="/files/e6TAOXUSTNF5zFLjL1te" alt=""><figcaption></figcaption></figure>

2\) Конфигурации постбеков в данном случае создавать не нужно - они уже заранее настроены. Открываем доступные ссылки и забираем готовые — просто вставляем их в партнёрку.<br>

<figure><img src="/files/9tGVR5WusLGDPlJLLSzI" alt=""><figcaption></figcaption></figure>

3\) Далее нам нужно получить готовую ссылку, которую нужно передать лидам. \
\
Для этого переходите в раздел **Ссылки регистрации (Registration links)**, вставьте свою ссылку (ее вам выдала партнерка) — готово, в поле **Готовая ссылка с параметрами (Final URL with Parameters)** в получаете готовую ссылку, которую будете выдавать клиентам внутри нашей CRM\
\
В эту ссылку вы можете добавлять любые параметры, нужные вам, например:\
\
<https://api.chatterfy.ai?sub4=\\{{tracker.clickid\\}}\\&fields.userid={user\\_id}> - в данном случае мы из партнерки может автоматически забрать ID клиента и записать его в кастомное поле внутри СРМ&#x20;

<figure><img src="/files/Pg5wboEWUqI11EMiNaAk" alt=""><figcaption></figcaption></figure>

## Постбеки в трекере (запись внешних данных)

[Инструкция по созданию кастомных полей: Нажмите, чтобы перейти](https://help.chatterfy.ai/crm-dlya-obsheniya/funkcional-crm/stranica-chatov/kastomnye-polya)

Если вам **необходимо записать кастомную информацию о клиенте**, например сумма последнего депозита, ID клиента.

{% hint style="success" %}
Вам нужно **в постбеке трекера,** который вы **добавляете в партнерку** **добавить fields.key параметра=параметр из партнерки**
{% endhint %}

Например, постбек для FD

[https://api.chatterfy.ai/api/postbacks/51edc052-f7a2-4650-8085-d04abb38de5e/tracker-postback?clickid={clickid}\&tracker.event=sale\&tracker.cost={cost}\&tracker.currency=usd\&fields.last\_deposit={cost}\&fields.user\_id={user\_id}](https://help.chatterfy.ai/chatterfy.ai/update-log/update-06.10.2024)

Таким образом, **пользователю запишется ивент sale**, а **в кастом филды** пользователя **запишется параметры last\_deposit и user\_id**

<br>

## FAQ - Часто задаваемые вопросы 📍

### 1) Для чего нужно настраивать постбеки?

{% hint style="success" %}
Начнем с основы, вы лиду даете ссылку на регистрацию в партнерке, типа partner.com/signup?clickid={{tracker.clickid}}<br>

Когда лид зарегистрируется, то партнерка отправит запрос туда, что вы указали в их постбеках

Например, <https://api.chatterfy.ai/api/postbacks/5540a501-882f-4a94-8b5d-a2b888a9fd0f/tracker-postback?clickid={clickid}&tracker.event=registration>\
\
В какой конкретно параметр передавать {{tracker.clickid}} зависит от партнерки. <br>
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.chatterfy.ai/tracker/funkcional-tracker/postbacks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.