Mixpanel

  ## Co to jest

Ta integracja umożliwia połączenie bota Botpress z Mixpanel Analytics, pozwalając na aktualizację profili użytkowników i śledzenie niestandardowych zdarzeń bezpośrednio w przepływach bota.

## Jak to działa

Integracja działa poprzez wykorzystanie akcji do interakcji z Mixpanel Analytics. Oto krótki przegląd działań:

1. **Update User Profile**: Aktualizuje profil użytkownika za pomocą informacji identyfikujących, takich jak adres e-mail i imię i nazwisko.
2. **Track Event**: Śledzi niestandardowe zdarzenia z opcjonalnymi właściwościami zdefiniowanymi w ładunku.

Działania te są wspierane przez Mixpanel Analytics API, wykorzystując klucz zapisu do uwierzytelniania żądań.

## Funkcje integracji

### Akcje

- Aktualizacja profilu użytkownika**
  - Aktualizuje informacje identyfikujące profil użytkownika w Mixpanel Analytics.
  - Dane wejściowe: ID użytkownika, Profil użytkownika (opcjonalny ciąg JSON metadanych użytkownika)

- Śledź zdarzenie**
  - Śledzi niestandardowe zdarzenie i powiązane właściwości w Mixpanel Analytics.
  - Dane wejściowe: User ID, Event Name, Event Payload (opcjonalny ciąg JSON właściwości zdarzenia)

### Konfiguracja

- Token**: Token projektu jest wymagany do uwierzytelniania żądań do Mixpanel Analytics. Po utworzeniu projektu możesz uzyskać token, przechodząc do Ustawienia projektu -> Przegląd -> Klucze dostępu -> Token projektu.

## Instrukcje konfiguracji

#### Konfiguracja Mixpanel Analytics

1. Zaloguj się do pulpitu nawigacyjnego Mixpanel Analytics.
2. Utwórz projekt Mixpanel.
3. Znajdź swój token, korzystając z powyższych instrukcji. 

#### Botpress Konfiguracja

1. Kliknij `Install` w prawym górnym rogu i wybierz swojego bota.
2. Postępuj zgodnie z wyskakującymi instrukcjami, aby skonfigurować integrację.
3. Wprowadź klucz zapisu Mixpanel Analytics z konfiguracji Mixpanel Analytics w polu `token`.
4. Włącz integrację, aby zapisać ustawienia.