Pular para o conteúdo principal

Dataoris - Configuração de Webhook

Esta página explica como configurar células H3 para monitoramento de eventos Dataoris via webhook​

Visão Geral​

O Dataoris utiliza células H3 (hexágonos geográficos) para detectar quando usuários entram em áreas de interesse. Para receber esses eventos via webhook, você precisa:

  1. ✅ Configurar seu webhook (endpoint, autenticação, etc.) - Veja o guia completo de Integração Webhook
  2. ✅ Definir células H3 que deseja monitorar (explicado nesta página)

Pré-requisitos​

Importante

Antes de configurar células H3, certifique-se de que você já:

  • Integrou o SDK da Group Link em seu aplicativo móvel (Veja como)
  • Configurou seu endpoint webhook (Veja o guia)

O que são Células H3?​

Células H3 são hexágonos geográficos que representam áreas específicas no mapa. O Dataoris usa essas células para detectar quando um dispositivo entra ou sai de uma área de interesse.

Exemplo de Cell ID: 88a8100ecdfffff, 8881839825fffff

Como escolher Cell IDs?​

Se você não conhece os Cell IDs das áreas que deseja monitorar, você pode:

  1. Consultar nossa equipe para ajudá-lo a identificar as células corretas
  2. Usar ferramentas online como H3 Geo para encontrar células específicas
  3. Fornecer coordenadas (latitude/longitude) que nossa equipe converterá em Cell IDs
Disponibilidade

É extremamente importante consultar a disponibilidade de cell_ids com o nosso comercial para avaliar a disponibilidade (suporte@grouplinkone.com).

Como Solicitar a Configuração​

Para configurar células H3 para seu webhook, envie um email para suporte@grouplinkone.com com:

Assunto: Configuração Webhook Dataoris - [Nome da sua empresa]

Corpo do email:

Empresa: [Nome da sua empresa]
Endpoint Webhook: [URL do seu endpoint - já configurado]
Cell IDs H3: [Lista das células que deseja monitorar]
Package Name: [com.suaempresa.seuapp]
Observações: [Qualquer informação adicional relevante]

Exemplo:

Empresa: Acme Corp
Endpoint Webhook: https://api.acme.com/webhooks/Dataoris
Cell IDs H3: ['88a8100ecdfffff', '8881839825fffff', '88a8100ecffffff']
Package Name: com.acme.app
Observações: Queremos monitorar eventos de entrada em shoppings de São Paulo

Nossa equipe irá processar sua solicitação e confirmar a configuração.

Testando a Integração​

Após a configuração ser concluída pela nossa equipe:

  1. ✅ Certifique-se de que seu aplicativo com o SDK está em execução
  2. ✅ Visite fisicamente uma das áreas monitoradas (Cell IDs configurados)
  3. ✅ Verifique se os eventos estão sendo recebidos no seu endpoint
  4. ✅ Valide a estrutura dos eventos conforme documentado em Exemplo de Evento

Estrutura dos Eventos​

Os eventos enviados ao seu webhook incluirão informações específicas do Dataoris:

{
  "mm": 1220290060,
  "cell_id": "8881839825fffff",  // ← Célula H3 onde o evento ocorreu
  "event_type": "EVENT_IN",
  "created_at": 1767623650044,
  ...
}

Para detalhes completos da estrutura de eventos, veja:

Próximos Passos​

Suporte​

Em caso de dúvidas sobre células H3 ou configuração Dataoris: