# Postbacks

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

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

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

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

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

<figure><img src="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2FAdY4Y6LpUJ5xv1GemVTO%2Fimage.png?alt=media&#x26;token=d2298e3c-b8d3-44ab-9ca3-d23dde196d69" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2FxYaTcudXdR6DclfkgIKO%2Fimage.png?alt=media&#x26;token=6c457db5-8007-48db-a243-21a2290c50ac" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

<figure><img src="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2F2bq9JRyF9gUO7zAVA30H%2Fimage.png?alt=media&#x26;token=b8f15849-972b-4d5b-909c-872288644c94" 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="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2FTf6kSPic4L18VFAe9RBc%2Fimage.png?alt=media&#x26;token=21a5b4da-a0a8-41a1-b444-ac5a444f6f60" 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="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2FmVmOMtuVpSv2R82O8IHi%2Fimage.png?alt=media&#x26;token=3580bb13-ab79-4781-b23c-bc7e53267767" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2FG3mgfTXcyPpOoifNcvRl%2Fimage.png?alt=media&#x26;token=23a8dcaf-7996-46e8-bf9d-e3dfda264b16" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2Fbpe1ngn5LVPiorxELx7h%2Fimage.png?alt=media&#x26;token=3d2067da-c697-4c18-982c-6f6b2a598765" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2FZhoQMpQC64KBq7qV4stV%2Fimage.png?alt=media&#x26;token=420b1265-cdae-4d2e-95d8-edd2f5b561d7" 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="https://1652732612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdQv3zQy9PTd8nN6uVUYs%2Fuploads%2FmXkfUhBHfVSoD8qLXOy0%2Fimage.png?alt=media&#x26;token=80390b39-7996-4318-9c75-8bc4b1aee9fb" 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 %}