## 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.
