Mixpanel

  ## O que é

Esta integração permite-lhe ligar o seu bot Botpress ao Mixpanel Analytics, permitindo-lhe atualizar os perfis de utilizador e acompanhar eventos personalizados diretamente nos fluxos do seu bot.

## Como funciona

A integração funciona usando ações para interagir com o Mixpanel Analytics. Aqui está uma breve visão geral das ações:

1. **Atualizar perfil do usuário**: Actualiza o perfil de um utilizador com informações de identificação, como o e-mail e o nome.
2. **Rastrear evento**: Rastreia eventos personalizados com propriedades opcionais definidas no payload.

Estas acções são apoiadas pela API Mixpanel Analytics, utilizando uma chave de escrita para autenticar os pedidos.

## Recursos de integração

### Ações

- Atualizar perfil do usuário**
  - Atualiza as informações de identificação do perfil de um usuário no Mixpanel Analytics.
  - Entradas: ID do usuário, Perfil do usuário (string JSON opcional de metadados do usuário)

- Rastrear evento**
  - Rastreia um evento personalizado e propriedades associadas no Mixpanel Analytics.
  - Entradas: ID do utilizador, Nome do evento, Carga útil do evento (cadeia JSON opcional de propriedades do evento)

### Configuração

- Token**: Um token de projeto é necessário para autenticar solicitações ao Mixpanel Analytics. Depois de criar um projeto, você pode obter seu token acessando Configurações do projeto -> Visão geral -> Chaves de acesso -> Token do projeto.

## Instruções de configuração

#### Configuração do Mixpanel Analytics

1. Faça login no painel do Mixpanel Analytics.
2. Crie um projeto Mixpanel.
3. Encontre seu token usando as instruções acima. 

#### Botpress Configuração

1. Clique em `Install` no canto superior direito e seleccione o seu bot.
2. Siga as instruções do popup para configurar a sua integração.
3. Introduza a sua chave de escrita do Mixpanel Analytics a partir da Configuração do Mixpanel Analytics no campo `token`.
4. Ative a integração para salvar suas configurações.