Skip to main content

Transformar Dados de WiFi de Convidados em Gatilhos de Automação de Marketing

Este guia de referência fornece um manual técnico para converter dados brutos de WiFi de convidados em gatilhos de automação de marketing orientados por eventos. Abrange a arquitetura completa — desde a captura de dados do Captive Portal e regras LogicFlow até ao envio de webhooks e integração com CRM — com cenários de implementação reais para hotelaria e retalho. As equipas de IT e os especialistas em automação de marketing sairão com uma estrutura concreta e implementável para construir campanhas baseadas em presença, incluindo fluxos de boas-vindas, ofertas de tempo de permanência e recuperação de visitantes inativos.

📖 8 min de leitura📝 1,858 palavras🔧 2 exemplos3 perguntas📚 10 termos-chave

🎧 Ouça este Guia

Ver Transcrição
Welcome to this technical briefing from Purple. I'm going to walk you through one of the most underutilised capabilities in enterprise venue technology: turning raw guest WiFi data into event-driven marketing automation triggers. If you're an IT manager, a CRM specialist, or a venue operations director, this is directly relevant to decisions you're likely making this quarter. So let's get into it. First, the context. Traditional marketing automation relies on digital interactions: website visits, email clicks, app opens. But for physical venues — hotels, retail chains, stadiums, conference centres — the most critical customer interaction isn't digital. It's physical. When a guest walks through the door, connects to the WiFi, or spends 45 minutes in a specific zone, those are high-value behavioural signals. And right now, most venues are collecting them and doing absolutely nothing with them. The opportunity here is significant. By mapping network events to customer lifecycle stages and connecting them to your marketing stack via webhooks, you can trigger highly relevant, timely communications that outperform batch-and-blast campaigns by a considerable margin. So, how does this actually work? Let's go through the technical architecture. It starts at the data capture layer. When a device connects to the network, two things happen simultaneously. First, the access point logs a presence event, capturing the device's MAC address and a timestamp. Second, if the user authenticates through a captive portal, you capture their identity — typically an email address or phone number — along with their marketing consent. That consent capture is non-negotiable. Under GDPR and CCPA, you cannot trigger marketing communications without explicit opt-in, so the portal configuration must be airtight. Now, the presence data and the identity data are two distinct streams, and understanding the difference is critical. Presence data tells you that a device is in the venue. Identity data tells you who that person is. The power comes from combining them. Once the data is captured, it flows into a rules engine. In Purple's platform, this is called LogicFlow. LogicFlow evaluates incoming network events against a set of predefined conditions. For example: Condition equals Session Start, Qualifier equals First visit AND marketing consent equals True, Action equals POST webhook to CRM after a 15-minute delay. This declarative model allows marketing operations teams to define trigger logic without requiring network engineering involvement for every campaign change. When a condition is matched, the webhook dispatcher sends a structured JSON payload to the configured endpoint. The payload includes the user's unique identifier, the event type, the venue identifier, the event timestamp, and any relevant contextual data such as dwell duration or visit count. The receiving system — whether Salesforce, HubSpot, Klaviyo, or a custom CDP — then executes the corresponding automation flow. Let me walk through a concrete implementation scenario. A 200-room hotel wants to send a personalised welcome email with a spa discount 15 minutes after a guest authenticates on the WiFi for the first time during their stay. Here's how you build it. Step one: configure the captive portal to capture email and marketing consent. Step two: in LogicFlow, create a rule with the condition First Authentication and a 15-minute delay. Step three: configure the webhook to POST the user's email, name, and venue ID to the CRM endpoint. Step four: in the CRM, create a dynamic email template that triggers upon receiving the webhook payload, inserting the specific spa offer for that property. The key architectural decision here is placing the delay at the network layer, not the CRM layer. This reduces unnecessary API calls and ensures the trigger only fires once per user, per stay. Now let's look at a retail scenario. A fashion chain wants to send a We miss you SMS to loyalty members who haven't visited any of their stores in over 90 days. The WiFi platform's lapsed visitor logic is purpose-built for this. The rule identifies devices associated with a known loyalty profile that have not registered a presence event for 90 days. When the threshold is crossed, a webhook fires to the SMS gateway with the user's phone number and a unique discount code. The CRM record is updated to reflect that the win-back campaign has been triggered, preventing duplicate sends. This scenario illustrates an important point: the value of passive presence data. The user doesn't need to actively connect to the WiFi again. The system evaluates absence across the entire estate and fires the trigger when the inactivity threshold is crossed. Let's talk about the pitfalls, because there are several that can undermine an otherwise well-designed implementation. The most common mistake is over-messaging. If a guest connects to your WiFi daily, they absolutely should not receive a welcome email every morning. The solution is twofold. First, configure your LogicFlow rules to trigger on state changes, not continuous presence. A webhook should fire when a user transitions from Not Present to Present, not every time an AP detects their device. Second, implement frequency capping at the CRM level. A single user should only receive a given campaign type once within a defined period. The second major pitfall is MAC address randomisation. Modern mobile operating systems — iOS and Android — now randomise the device's MAC address to prevent tracking. This means the MAC address you see today may be completely different from the one you saw last week, even for the same device. If your architecture relies on the MAC address as the primary identifier for long-term tracking, you will see a significant drop in repeat visitor identification. The fix is straightforward: rely on the authenticated identity captured at the captive portal — the email address or phone number — as your primary CRM key. The third pitfall is payload schema mismatch. When the WiFi platform sends a webhook, the receiving CRM must understand the data structure. Mismatches in field names, data types, or encoding can cause silent failures where the webhook is received but the automation doesn't trigger. Always validate your payload schema during the integration phase and implement monitoring on both the sending and receiving ends. Now, a rapid-fire Q&A on the questions I hear most often. Question: How do we prevent API rate limits from being exceeded? Answer: Trigger on state changes, not continuous presence. Implement exponential backoff in your retry logic, and use a dead-letter queue to capture any payloads that fail to deliver. Question: Can we trigger location-specific offers? Answer: Yes. Configure your LogicFlow rules to evaluate the specific access point or zone where the event occurred. This allows you to send a coffee shop offer when a user is detected near the café, and a retail offer when they're in the clothing section. Question: How do we handle multi-venue deployments? Answer: Include the venue ID in every webhook payload and use it as a routing parameter in your CRM to ensure the correct template and offer are applied. Question: What about healthcare environments? Answer: For venues like hospitals, the same architecture applies, but the use cases shift from commercial marketing to operational communications — wayfinding, appointment reminders, and patient information. The privacy governance requirements are also significantly more stringent, so ensure your data handling aligns with applicable healthcare regulations in your jurisdiction. To summarise, the key takeaways from this briefing are as follows. Guest WiFi infrastructure is a powerful, often untapped source of first-party data. Captive portals capture identity and consent; access points track presence and dwell time. LogicFlow rules evaluate network events in real-time to trigger relevant actions. Webhooks provide the connective tissue between the WiFi platform and your marketing stack. Implement frequency capping and trigger on state changes to avoid over-messaging. Adapt your architecture to account for MAC randomisation by relying on authenticated identity. And measure your success through trigger-to-open rates, offer redemption rates, and win-back conversion metrics. The next steps for your team are clear. Audit your current captive portal configuration to ensure consent capture is properly implemented. Map your existing customer lifecycle stages to specific network events. And engage your CRM team to define the webhook endpoints and automation flows you want to build. If you want to go deeper on the ROI measurement framework, I'd recommend reviewing the Purple guide on measuring return on investment from guest WiFi — it provides a structured approach for presenting the business case to your CFO or CMO. Thank you for your time. This has been a Purple technical briefing.

Resumo Executivo

Para locais empresariais, o WiFi de convidados já não é apenas um centro de custos de conectividade; é a camada de dados fundamental para todo o ciclo de vida do cliente. Quando configurada corretamente, a infraestrutura de pontos de acesso captura dados precisos de presença, permanência e retorno que podem desencadear fluxos de trabalho de automação de marketing altamente direcionados. Este guia descreve a arquitetura técnica necessária para transformar eventos de rede brutos — incluindo handshakes de autenticação 802.11 e logins de Captive Portal — em gatilhos acionáveis para CRM. Ao alavancar Guest WiFi e integrações de webhook, as equipas de IT e marketing podem implementar campanhas orientadas por eventos — desde ofertas em tempo real baseadas no tempo de permanência até à recuperação de visitantes inativos — sem comprometer o desempenho da rede ou a conformidade com a privacidade dos dados. O resultado é um aumento mensurável na relevância da campanha, nas taxas de conversão e no valor vitalício do cliente, tudo impulsionado pela infraestrutura que já possui.

header_image.png


Análise Técnica Detalhada

A transformação de eventos WiFi em gatilhos de automação de marketing baseia-se numa arquitetura em camadas que interliga a infraestrutura de rede e a pilha de marketing. Compreender cada camada é essencial antes de qualquer trabalho de integração começar.

A Camada de Captura de Dados

Quando um dispositivo entra num local e se conecta à rede WiFi, duas transmissões de dados distintas são geradas simultaneamente. A primeira são os dados de presença: o ponto de acesso regista um pedido de sonda ou um evento de associação, capturando o endereço MAC do dispositivo, a intensidade do sinal (RSSI) e um carimbo de data/hora preciso. Esta transmissão é passiva e contínua — não requer qualquer ação do convidado. A segunda são os dados de identidade: quando o convidado se autentica através do Captive Portal, a plataforma captura a sua identidade declarada (endereço de e-mail ou número de telefone), o seu perfil demográfico, se recolhido, e, crucialmente, o seu consentimento explícito para marketing.

Para locais em Retail ou Hospitality , esta abordagem de fluxo duplo fornece uma visão determinística do comportamento do cliente que nenhum outro canal pode replicar. O Captive Portal serve como o principal ponto de ingestão de dados primários, e a sua configuração deve ser tratada como um componente crítico para a conformidade. Sob o GDPR, o consentimento deve ser dado livremente, ser específico, informado e inequívoco. Sob o CCPA, os utilizadores devem ter o direito de optar por não participar. Consulte o guia CCPA vs GDPR: Global Privacy Compliance for Guest WiFi Data para requisitos de configuração detalhados.

Processamento de Eventos e o Motor LogicFlow

Os eventos de rede brutos não são diretamente acionáveis. Devem ser normalizados, avaliados em relação a regras predefinidas e traduzidos em gatilhos com significado para o negócio. O motor LogicFlow da Purple atua como esta camada intermediária. Ele ingere o fluxo de eventos dos pontos de acesso e do Captive Portal, avalia cada evento em relação a um conjunto de regras e determina se uma condição de gatilho foi cumprida.

Uma regra LogicFlow é composta por três elementos: uma condição (o evento ou estado da rede), um qualificador (parâmetros adicionais como contagem de visitas, duração da permanência ou dias desde a última visita) e uma ação (tipicamente um envio de webhook). Por exemplo: Condição = 'Início de Sessão', Qualificador = 'Primeira visita E consentimento de marketing = Verdadeiro', Ação = 'POST webhook para CRM após um atraso de 15 minutos'. Este modelo declarativo permite que as equipas de operações de marketing definam a lógica do gatilho sem exigir o envolvimento da engenharia de rede para cada alteração de campanha.

Envio de Webhook e Integração com CRM

Quando uma regra LogicFlow é correspondida, o despachante de webhook dispara um payload JSON estruturado para o endpoint configurado. O payload deve incluir, no mínimo: o identificador único do utilizador (e-mail ou telefone), o tipo de evento, o identificador do local, o carimbo de data/hora do evento e quaisquer dados contextuais relevantes, como a duração da permanência ou a contagem de visitas. O sistema recetor — seja Salesforce, HubSpot, Klaviyo ou um CDP personalizado — executa então o fluxo de automação correspondente.

webhook_architecture_diagram.png

A plataforma WiFi Analytics fornece a camada de observabilidade, permitindo que as equipas monitorizem volumes de eventos, taxas de gatilho e métricas de sucesso de entrega num dashboard unificado. Isto é essencial para diagnosticar problemas de integração e otimizar os limiares dos gatilhos.


Guia de Implementação

A implementação de um fluxo de automação de marketing acionado por WiFi requer uma coordenação estreita entre a engenharia de rede e as operações de marketing. A seguinte abordagem passo a passo garante uma entrega fiável e uma atribuição precisa desde o primeiro dia.

Passo 1: Definir a Taxonomia dos Gatilhos

Antes de qualquer configuração técnica começar, mapeie os eventos de rede para as fases do ciclo de vida do cliente. Esta taxonomia torna-se o contrato entre a equipa de rede e a equipa de marketing. A tabela abaixo fornece um ponto de partida padrão.

Fase do Ciclo de Vida Evento de Rede Condição do Gatilho Ação Recomendada
Visitante Pela Primeira Vez Início de Sessão Primeira autenticação, consentimento = Verdadeiro E-mail de boas-vindas + integração de fidelidade
Visitante Ativo Presença de Permanência Tempo de permanência > 45 minutos Oferta por SMS ou notificação na aplicação
Convidado Recorrente Início de Sessão Contagem de visitas = 5 ou 10 Notificação de atualização de nível de fidelidade
Visitante Inativo Ausência Nenhum evento de presença por 60–90 dias E-mail de recuperação ou campanha por SMS
Visitante Reengajado Início de Sessão Primeira visita após campanha de inatividade Recompensa VIP ou oferta personalizada

wifi_trigger_lifecycle_diagram.png

Passo 2: Configurar o Captive Portal

Certifique-se de que o portal recolhe os campos mínimos obrigatórios: endereço de e-mail (ou telefone), caixa de seleção de consentimento de marketing e, opcionalmente, um identificador de programa de fidelidade. Mantenha o formulário conciso — cada campo adicional reduz as taxas de conclusão. Configure o portal para passar a sinalização de consentimento para a plataforma de análise para que possa ser avaliada pelas regras do LogicFlow.

Passo 3: Criar e Testar Regras do LogicFlow

Crie regras incrementalmente, começando com o gatilho de maior valor (normalmente Primeira Conexão). Teste cada regra num ambiente de teste antes de implementar em produção. Verifique se o payload do webhook está corretamente estruturado e se o endpoint do CRM recetor retorna uma resposta 200 OK. Implemente uma fila de mensagens mortas (dead-letter queue) para capturar quaisquer payloads que falhem na entrega durante interrupções transitórias.

Passo 4: Mapear Campos de Dados e Validar Esquema

Alinhe o esquema de dados entre a plataforma WiFi e o CRM. O identificador único capturado no portal deve corresponder à chave primária no CRM. Incompatibilidades nos nomes dos campos, tipos de dados ou codificação causam falhas silenciosas onde o webhook é recebido, mas a automação não é acionada. Documente o mapeamento completo dos campos e revise-o sempre que qualquer sistema for atualizado.

Passo 5: Implementar Limitação de Frequência (Frequency Capping)

Configure a limitação de frequência ao nível do CRM para evitar o excesso de mensagens. Defina frequências máximas de envio por tipo de campanha — por exemplo, um e-mail de boas-vindas só pode ser enviado uma vez por utilizador, e uma oferta de tempo de permanência só pode ser enviada uma vez por período de 7 dias. Esta lógica deve ser imposta no CRM, não apenas no LogicFlow, para contabilizar casos excecionais onde múltiplos gatilhos são acionados em rápida sucessão.


Melhores Práticas

As seguintes recomendações são extraídas de implementações em ambientes de hotelaria, retalho e Transporte e representam o padrão atual da indústria para automação de marketing baseada em presença.

Acionar na Mudança de Estado, Não na Presença Contínua. O erro arquitetónico mais comum é configurar regras para avaliar a presença em cada batimento cardíaco do AP. Isso inunda o motor de regras e gera chamadas API excessivas para o CRM. As regras devem avaliar as transições de estado: de 'Não Presente' para 'Presente', de 'Ativo' para 'Inativo', ou de 'Anónimo' para 'Identificado'. Esta abordagem reduz a carga do sistema e garante que cada gatilho seja significativo.

Confiar na Identidade Autenticada para Rastreamento a Longo Prazo. Os sistemas operativos móveis modernos empregam a randomização de endereços MAC para proteger a privacidade do utilizador. O iOS tem endereços MAC aleatórios desde o iOS 14, e o Android seguiu a partir da versão 10. Qualquer arquitetura que dependa do endereço MAC do hardware como identificador primário do CRM irá experienciar uma degradação significativa na identificação de visitantes repetidos. A identidade autenticada — e-mail ou telefone — capturada no captive portal deve ser o identificador canónico para todo o rastreamento e atribuição a longo prazo.

Incluir Contexto do Local em Cada Payload. Para operadores com múltiplos locais, o identificador do local é um parâmetro de encaminhamento crítico. Sem ele, o CRM não consegue determinar qual modelo, oferta ou campanha aplicar. Inclua o ID do local, nome do local e, opcionalmente, a zona ou piso em cada payload do webhook.

Monitorizar Continuamente a Saúde do Webhook. As falhas na entrega do webhook são silenciosas por padrão. Implemente monitorização tanto na plataforma de envio (alerta sobre taxas de falha de entrega acima de um limiar definido) quanto no CRM recetor (alerta sobre quedas inesperadas no volume de gatilhos de entrada). Para implementações de Saúde , onde as comunicações operacionais podem ser críticas para a segurança, esta monitorização é inegociável.

Alinhar Atualizações de Rede com Requisitos de Integração. Ao planear a modernização da rede — por exemplo, avaliando Os Principais Benefícios do SD WAN para Empresas Modernas — garanta que as capacidades de análise e webhook da plataforma WiFi sejam incluídas na revisão da arquitetura. As implementações de SD-WAN podem afetar a latência e a fiabilidade do streaming de eventos em tempo real a partir de locais de ponta.


Resolução de Problemas e Mitigação de Riscos

Mesmo com uma arquitetura robusta, ocorrem falhas de integração. Os seguintes modos de falha são os mais frequentemente encontrados em implementações de produção.

Falhas na Entrega do Payload. Erros HTTP 4xx tipicamente indicam um problema de autenticação ou esquema com o endpoint do webhook. Erros HTTP 5xx indicam um problema no sistema recetor. Implemente lógica de repetição com backoff exponencial (tentativa inicial em 30 segundos, depois 2 minutos, depois 10 minutos) e encaminhe payloads não entregáveis para uma fila de mensagens mortas (dead-letter queue) para revisão manual.

Disparos de Gatilhos Duplicados. Se um utilizador se reconectar ao WiFi várias vezes num curto período — por exemplo, movendo-se entre pisos numa implementação multi-AP — o evento 'Início de Sessão' pode disparar várias vezes. Implemente chaves de idempotência no payload do webhook (um ID de evento único composto pelo identificador do utilizador e um carimbo de data/hora) e configure o CRM para deduplicar com base nesta chave.

Atrasos na Propagação da Sinalização de Consentimento. Em ambientes de alto débito, pode haver um breve atraso entre um utilizador submeter o formulário do portal e a sinalização de consentimento estar disponível para o motor LogicFlow. Configure um atraso mínimo de 60 segundos em todos os gatilhos de Primeira Conexão para garantir que o status do consentimento foi propagado antes do webhook disparar.

Conflitos de Registo de Contacto do CRM. Quando um webhook cria um novo contacto no CRM, pode entrar em conflito com um registo existente se o utilizador já tiver interagido anteriormente através de um canal diferente. Implemente uma estratégia de fusão no CRM que priorize a identidade capturada pelo WiFi e enriqueça o registo existente em vez de criar um duplicado.


ROI e Impacto no Negócio

O caso de negócio para a automação de marketing acionada por WiFi está bem estabelecido em todas as categorias de locais. Os gatilhos baseados em presença superam consistentemente as campanhas em lote nas métricas que mais importam para os operadores comerciais.

Para uma comprequadro abrangente para quantificar e apresentar este ROI a partes interessadas de nível sénior, consulte Medir o ROI no Guest WiFi: Um Quadro para CMOs . Os principais indicadores de desempenho a monitorizar são os seguintes.

KPI Descrição Referência Típica
Taxa de Abertura de Acionadores % de e-mails acionados abertos pelos destinatários 35–55% (vs. 15–25% para envio em massa)
Taxa de Resgate de Ofertas % de ofertas acionadas resgatadas no local 8–15% (vs. 2–4% para envio em massa)
Conversão de Recuperação % de visitantes inativos que regressam após a campanha 12–20%
Taxa de Captura de Dados % de utilizadores de WiFi que completam o registo no portal 60–80% com portal otimizado
Aumento da Frequência Média de Visitas Aumento de visitas por cliente por trimestre 15–25% para clientes inscritos em programas de fidelidade

O efeito cumulativo destas métricas é significativo. Uma cadeia de retalho com 50 localizações, cada uma a capturar 500 registos de WiFi por semana, gera 25.000 novos contactos de CRM por semana. Uma taxa de conversão de recuperação de 15% num segmento inativo de 90 dias, combinada com uma taxa de resgate de ofertas de 10% em acionadores de tempo de permanência, produz um aumento de receita mensurável e atribuível que justifica o investimento na integração num único trimestre.

Termos-Chave e Definições

LogicFlow

Purple's event rules engine that evaluates incoming network events against predefined conditions to determine whether a marketing trigger action should be executed.

IT teams configure LogicFlow to define the exact conditions under which a webhook fires, without requiring code changes to the marketing stack.

Webhook

An HTTP callback mechanism that automatically sends a structured JSON payload to a specified URL endpoint when a defined event occurs on the source system.

The primary integration mechanism for transmitting real-time WiFi presence events to CRM, email, and SMS platforms.

Captive Portal

A web-based authentication page that users must interact with before being granted access to a public WiFi network. Used to capture identity and marketing consent.

The compliance-critical touchpoint for first-party data collection. Portal configuration directly determines the quality and legality of downstream marketing triggers.

Presence Data

Network telemetry derived from wireless device probe requests and association events, indicating that a device is physically within the coverage area of an access point.

Enables passive tracking of dwell time and return visit frequency without requiring active user authentication on every visit.

MAC Address Randomisation

A privacy feature implemented in iOS (since version 14) and Android (since version 10) that periodically rotates the device's MAC address to prevent persistent tracking by network operators.

Requires all long-term customer identification and CRM matching to be based on authenticated identity (email/phone) rather than hardware device addresses.

Dwell Time

The total duration a device remains within the detectable coverage area of a venue's WiFi network during a single session.

A key trigger qualifier for in-venue offers. A dwell time threshold (e.g., 45 minutes) indicates genuine engagement and increases offer relevance and redemption rates.

First-Party Data

Customer information collected directly by the venue from the customer, with their explicit consent, through owned channels such as the captive portal.

Increasingly valuable as third-party cookies are deprecated and data privacy regulations tighten. WiFi-captured first-party data is among the highest-quality inputs available to venue operators.

Dead-Letter Queue (DLQ)

A message storage buffer that captures webhook payloads that could not be successfully delivered to the target endpoint after all retry attempts have been exhausted.

Essential for ensuring marketing triggers are not permanently lost during CRM outages or endpoint failures. DLQ contents should be reviewed and replayed once the receiving system recovers.

Idempotency Key

A unique identifier included in each webhook payload that allows the receiving system to detect and discard duplicate requests, ensuring a trigger is processed exactly once.

Critical in high-availability deployments where webhook retry logic may cause the same event to be delivered multiple times, potentially resulting in duplicate emails or SMS messages.

Frequency Capping

A constraint applied at the CRM or marketing automation layer that limits how many times a given user can receive a specific campaign type within a defined time window.

Prevents over-messaging and subscriber fatigue. Must be configured independently of the LogicFlow trigger rules, as the rules engine does not have visibility into CRM send history.

Estudos de Caso

A 200-room hotel wants to trigger a personalised welcome email offering a spa discount 15 minutes after a guest authenticates on the guest WiFi for the first time during their stay. The hotel uses Salesforce as its CRM and Klaviyo for email delivery.

  1. Configure the captive portal to capture the guest's email address and a GDPR-compliant marketing consent checkbox. Ensure the consent flag is passed to the Purple analytics platform in real time.

  2. In LogicFlow, create a rule with the following parameters: Condition = 'Session Start', Qualifier = 'First authentication at this venue AND marketing consent = True', Delay = '15 minutes', Action = 'POST webhook to Salesforce endpoint'.

  3. Configure the webhook payload to include: user_email, user_first_name, venue_id, event_type ('first_connect'), event_timestamp, and a unique event_id for idempotency.

  4. In Salesforce, create a process builder flow that triggers on receipt of the webhook. The flow checks whether a contact record exists for the email address. If yes, it enriches the record with the WiFi visit data. If no, it creates a new contact.

  5. The Salesforce flow then triggers a Klaviyo transactional email via the Klaviyo API, passing the venue_id as a dynamic variable to select the correct spa offer template for that property.

  6. Configure a suppression list in Klaviyo to ensure the welcome email is only sent once per guest per stay (keyed on email + check-in date).

Notas de Implementação: The 15-minute delay is placed at the network layer (LogicFlow) rather than the CRM layer. This is the correct architectural decision because it reduces unnecessary API calls to Salesforce — the webhook only fires once, after the delay, rather than immediately on authentication and then again after 15 minutes. The idempotency key (event_id) prevents duplicate emails if the webhook is retried due to a transient delivery failure. The suppression list in Klaviyo provides a secondary safety net against over-messaging during multi-day stays.

A fashion retail chain with 80 UK stores wants to send a 'We miss you' SMS with a 20% discount code to loyalty members who have not visited any store in over 90 days. The chain uses a custom CDP and an SMS gateway.

  1. In the Purple platform, configure a 'Lapsed Visitor' rule: Condition = 'Absence', Qualifier = 'No presence event recorded for this user across any venue in the estate for 90 consecutive days AND loyalty_member = True', Action = 'POST webhook to CDP endpoint'.

  2. The rule evaluates the absence condition daily at 02:00 UTC against the full estate's presence data. This batch evaluation approach is more efficient than real-time evaluation for absence-based triggers.

  3. The webhook payload includes: user_phone, user_email, loyalty_tier, days_since_last_visit, last_visited_venue_id, and a campaign_id.

  4. The CDP receives the payload and generates a unique discount code for the user, then passes the code and the user's phone number to the SMS gateway.

  5. The SMS gateway sends the win-back message. The CDP updates the user's record with a 'win_back_sent' flag and the send timestamp to prevent duplicate sends.

  6. When the user next connects to any store's WiFi, the 'Re-engaged Visitor' trigger fires, the CDP clears the lapsed flag, and the user is enrolled in a re-engagement nurture sequence.

Notas de Implementação: This scenario demonstrates the value of estate-wide presence data aggregation. The lapsed visitor condition evaluates absence across all 80 stores, not just the user's most recently visited location. This requires the Purple platform to be configured with a unified customer view across all venue instances. The batch evaluation at 02:00 UTC is a deliberate design choice to avoid real-time processing overhead for absence-based conditions, which by definition cannot be time-critical. The re-engagement trigger on the next visit closes the attribution loop, allowing the chain to measure the direct impact of the win-back campaign on in-store visits.

Análise de Cenários

Q1. A retail client reports that their CRM is hitting API rate limits during peak trading hours on Saturdays. Investigation reveals the WiFi platform is sending thousands of webhooks per hour. The current LogicFlow rule fires every time any device is detected by an access point. How should the IT manager reconfigure the system to resolve the issue without losing marketing trigger coverage?

💡 Dica:Consider the difference between continuous presence detection and meaningful state transitions. Also consider whether every device detection event has marketing value.

Mostrar Abordagem Recomendada

The IT manager should reconfigure the LogicFlow rule to trigger only on state change events — specifically 'Session Start' (device transitions from Not Present to Present) and 'Session End' — rather than on every AP detection heartbeat. Additionally, a frequency cap should be applied at the rule level to ensure a single device only generates a webhook once per 24-hour period. For anonymous devices (those without an authenticated identity), webhooks should be suppressed entirely, as they cannot be actioned by the CRM. These three changes — state-change triggers, frequency capping, and identity filtering — will reduce webhook volume by an estimated 90% while preserving all commercially relevant trigger events.

Q2. A hospital trust wants to send a wayfinding SMS to outpatients when they connect to the guest WiFi, directing them to their appointment department. However, the trust has multiple buildings on the same network estate, and the wayfinding message must be specific to the building where the patient connected. How is this achieved architecturally?

💡 Dica:Think about how physical location is represented within the WiFi platform's data model and how it can be included in the webhook payload.

Mostrar Abordagem Recomendada

The solution requires zone-based trigger configuration. Each building's access points must be assigned to a named zone within the Purple platform (e.g., 'Main Hospital', 'Outpatients Wing', 'Oncology Centre'). The LogicFlow rule is configured to evaluate the zone of the authenticating access point and include the zone identifier in the webhook payload. The SMS gateway or CRM then uses the zone identifier to select the appropriate wayfinding message template for that building. This approach ensures the SMS is contextually accurate regardless of which building the patient enters first. For a healthcare deployment, the IT team should also ensure the trigger only fires for users who have authenticated (not anonymous presence) and that the data handling complies with applicable healthcare data regulations.

Q3. Following an iOS 17 update rolled out across a venue's visitor base, the marketing team reports a significant drop in repeat visitor identification, causing loyalty tier upgrade triggers to stop firing for a large segment of their customer base. What is the technical root cause, and what architectural changes are required to restore accurate repeat visitor tracking?

💡 Dica:Consider what changed in iOS 17's networking behaviour and which identifier the current architecture relies upon for repeat visitor recognition.

Mostrar Abordagem Recomendada

The root cause is MAC address randomisation. iOS 17 introduced per-network MAC randomisation, meaning the device presents a unique, randomised MAC address for each WiFi network it connects to, even if it has connected to that network before. Any architecture that uses the MAC address as the primary identifier for repeat visitor recognition will fail to match the returning device to the existing CRM record. The required architectural change is to shift the primary identifier from the MAC address to the authenticated identity captured at the captive portal — specifically the email address or phone number. The CRM must be updated to use this authenticated identity as the canonical customer key. For users who have previously been tracked by MAC address only, a re-authentication campaign (prompting users to log in via the portal again) will be required to re-establish the identity link. Going forward, the MAC address should be used only for session-level analytics within a single visit, not for cross-visit customer recognition.

Principais Conclusões

  • Guest WiFi infrastructure generates two distinct and complementary data streams: presence data (from access points) and identity data (from the captive portal). Both are required for effective marketing automation.
  • LogicFlow rules should evaluate state transitions — not continuous presence — to prevent API rate limit issues and ensure every trigger is commercially meaningful.
  • MAC address randomisation in iOS 14+ and Android 10+ makes hardware device addresses unreliable for long-term customer identification. Authenticated email or phone must be the canonical CRM key.
  • Webhook payloads must include venue context (venue ID, zone, timestamp) to enable accurate routing and personalisation in multi-venue deployments.
  • Frequency capping must be enforced at the CRM level, not solely in the rules engine, to prevent over-messaging when multiple triggers fire in close succession.
  • Dead-letter queues and idempotency keys are non-negotiable in production deployments to ensure trigger reliability and prevent duplicate communications.
  • The compounding ROI of presence-based triggers — higher open rates, redemption rates, and win-back conversions — typically justifies the integration investment within a single quarter for estate-scale deployments.