• TEMPO REAL
  • LOTE
  • HUMANO
  • LIMPO

Como rastrear eventos server-side com sua IA

Conecte o Heap ao seu cliente de IA para transformar linguagem natural em pontos de dados precisos. Seu agente cuida dos payloads dos eventos enquanto você foca na lógica.

Pergunte à IA sobre esta página

Resposta rápida

Como posso enviar eventos server-side para o Heap usando minha IA?

Você diz à sua IA o que aconteceu e ela usa o MCP do Heap para disparar o evento. Ela mapeia sua descrição para as propriedades corretas e envia os dados imediatamente. Você verá os resultados no seu dashboard do Heap através destes resultados específicos.

Resultados de dados

Onde seus dados chegam

O que acontece após você enviar o comando para o seu agente.

TEMPO REAL

Disparo instantâneo

A IA envia os dados de interação individuais para o Heap assim que você confirma a ação. Seus analytics refletem o evento sem a necessidade de chamadas manuais de API.

LOTE

Upload de dados em massa

Seu agente pode agrupar várias ações do usuário em uma única requisição. Isso mantém o fluxo de eventos do Heap organizado e eficiente.

HUMANO

Revisão necessária

Você decide quais eventos são importantes o suficiente para rastrear. A IA propõe a estrutura do evento, mas você dá a palavra final.

LIMPO

Propriedades estruturadas

A IA organiza descrições confusas em pares de chave-valor limpos. Isso facilita muito a criação de seus segmentos no Heap depois.

O fluxo

O que sua IA faz quando o comando chega.

A IA atua como a ponte entre sua conversa e a API do Heap.

  1. Interpretar intenção

    Seu agente lê sua descrição de uma ação do usuário e identifica o nome do evento e as propriedades necessárias.

    track_event

  2. Captura de evento único

    A IA envia uma interação específica para o Heap usando os detalhes do evento fornecidos.

    track_event

  3. Processamento em massa

    Quando você descreve uma série de ações, a IA as agrupa para reduzir o processamento.

    bulk_track_events

  4. Validação de dados

    O agente verifica se o payload do evento corresponde ao que o Heap espera antes de enviar.

    track_eventbulk_track_events

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar o rastreamento de dados.

Pontos de partida

Substitua o texto entre colchetes pelos nomes reais dos seus eventos e atributos de usuário.

Heap Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Heap capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "heap-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"
    }
  }
}
Copie no chat04

  • Rastreie um evento de 'Purchase Completed' no Heap com o user_id '12345' e total_amount '50.00'.

  • Envie uma atualização em lote para o Heap para estes três usuários: user_id 'A', 'B' e 'C', marcando-os como 'Premium'.

  • Registre um evento de 'Button Clicked' para o botão 'Sign Up' com a propriedade 'location: header'.

  • Registre um evento de 'Subscription Cancelled' para o usuário '9876' e inclua o motivo 'too expensive'.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Heap uma vez e depois é só pedir.

Vincule sua conta do Heap ao Vinkius com um clique. Suas credenciais ficam criptografadas e você pode começar a enviar eventos imediatamente por qualquer cliente compatível.

Conectar Heap à sua IA

FAQ

Como esta tarefa funciona

  • 01

    A IA pode criar novas definições de eventos no Heap?

    Não. A IA só pode enviar dados para estruturas de eventos já existentes usando as ferramentas disponíveis.

  • 02

    A IA decide automaticamente quais eventos rastrear?

    Não. Você deve dizer explicitamente à IA qual evento rastrear ou quais dados enviar.

  • 03

    Posso enviar vários eventos de uma vez?

    Sim, você pode usar a capacidade de rastreamento em lote para enviar múltiplos eventos em uma única operação.

  • 04

    A IA vai excluir algum dado existente na minha conta do Heap?

    Não. Este MCP possui apenas ferramentas para enviar e rastrear dados, não para excluir ou modificar registros históricos.

  • 05

    A IA pode alterar minhas propriedades de usuário no Heap?

    Não. A IA só pode enviar dados de eventos e propriedades como parte de uma chamada de rastreamento.

  • Mais dúvidas sobre o Heap? Veja tudo o que o conector do Heap pode fazer

Conecte Heap ao Claude, Cursor, ChatGPT e outros