## O que é Esta integração permite-lhe ligar o seu bot Botpress a Segment Analytics, permitindo-lhe atualizar perfis de utilizador, acompanhar visualizações de nós e eventos personalizados diretamente nos fluxos do seu bot. ## Como funciona A integração funciona usando ações para interagir com o Segment 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. **Track Node**: Rastreia quando um nó específico dentro do seu bot é acionado. 3. **Track Event**: Rastreia eventos personalizados com propriedades opcionais definidas no payload. Essas ações são apoiadas pela API do Segment Analytics, utilizando uma chave de gravação para autenticar solicitações. ## Recursos de integração ### Ações - Atualizar perfil do utilizador - Actualiza a informação de identificação do perfil de um utilizador em Segment Analytics. - Entradas: ID do utilizador, Perfil do utilizador (cadeia JSON opcional de metadados do utilizador) - Rastrear nó** - Rastreia quando um nó foi acionado dentro do bot. - Entradas: ID do utilizador, ID do nó - Rastrear evento - Rastreia um evento personalizado e as propriedades associadas em Segment Analytics. - Entradas: ID de utilizador, Nome do evento, Carga útil do evento (cadeia JSON opcional de propriedades do evento) ### Configuração - Chave de gravação**: A chave de gravação é necessária para autenticar solicitações para Segment Analytics. Depois de criar uma fonte, pode gerar uma chave de escrita acedendo a Fontes -> Chaves de API -> Definições -> Chave de escrita ## Instruções de configuração #### Segment Configuração do Analytics 1. Inicie sessão no seu painel de controlo do Segment Analytics. 2. Crie uma nova fonte para receber seus eventos Botpress 3. Gere uma nova chave de gravação 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 Segment Analytics a partir de Segment Analytics Setup no campo `Write Key`. 4. Active a integração para guardar as suas definições.
