# Conectar a Easy Auth à BIP e receber os visitantes do Wi-Fi

> No Dashboard da Easy Auth, clique em bip.marketing, confira nome, idioma e fuso, escolha os campos do EasySpot e autorize. A BIP cria a conta no Lite com 1.000 envios grátis por mês, os campos, a chave de API e o webhook que traz cada visitante para Contatos. Data de Criação é a primeira visita; Atualizado, a última.

Fonte: https://wiki.bip.marketing/pt-br/wifi-conectar-easy-auth · Atualizado: 2026-10-08

<UseCaseMeta effort="nocode" plan="free" />

Cada pessoa que entra no seu Wi-Fi pode virar um contato pronto para campanha. Com a Easy Auth ligada à BIP, o visitante se identifica no EasySpot e aparece em **Contatos** na hora, sem planilha e sem copiar e colar.

<Checklist items="Uma licença da Easy Auth (Standard ou PRO) e acesso ao Dashboard|Um EasySpot que peça o telefone ou o e-mail do visitante (o nome é sempre pedido)|Um usuário na BIP, ou alguns minutos para criar um na hora, sem cartão" />

## O que você vai conseguir

- Uma conta na BIP ligada à sua licença, criada em um clique, no BIP Lite com 1.000 envios grátis por mês.
- Cada visitante do Wi-Fi em **Contatos**, com nome, e-mail e telefone. O telefone chega com o código do país, pronto para o WhatsApp.
- Os campos do EasySpot que você escolher (data de nascimento, gênero, cidade, textos e números) como campos personalizados, prontos para segmentar.
- Nenhum duplicado: quem volta ao Wi-Fi é atualizado no mesmo contato.
- Duas datas que contam a história de cada visitante: **Data de Criação** é a primeira visita e **Atualizado**, a mais recente.

## Como funciona

<Steps items="Clique em bip.marketing no Dashboard da Easy Auth|Confira a conta e escolha os campos do EasySpot|Cada visitante que se conecta vira contato na BIP" />

Quando você autoriza, a BIP cria a conta, os campos e uma chave de API, e registra na Easy Auth um webhook que aponta para a BIP. A partir daí, a cada conexão, a Easy Auth envia o visitante para `https://api.bip.marketing/api/leads`.

A BIP reconhece o visitante pelo **telefone** ou pelo **e-mail**:

- na primeira conexão, cria o contato, e a **Data de Criação** marca essa visita;
- nas conexões seguintes, atualiza o mesmo contato: soma telefones e e-mails novos, atualiza o nome e os campos com o que veio do EasySpot, e o **Atualizado** passa a marcar a última visita.

<Callout type="tip">
O webhook automático traz o contato e os campos. Ele não envia tags, KPIs nem metadados e não dispara campanhas. Para responder na hora da conexão (boas-vindas, oferta do dia), você cria um webhook próprio na Easy Auth que chama uma campanha de **Disparo por API**. Veja [API](/pt-br/api).
</Callout>

## Passo a passo

### 1. Clique em bip.marketing no Dashboard da Easy Auth

1. Entre no Dashboard da Easy Auth, em app.easyauth.net.
2. No rodapé do menu lateral, clique em **bip.marketing** (_Leve seus leads para o próximo nível_).
3. A Easy Auth gera um acesso seguro e abre a BIP em `dash.bip.marketing/easyauth-authorize`, já vinculada à sua licença.

<Shot src="/img/wifi-conectar-easy-auth/1-pt-br.png" alt="Botão bip.marketing no rodapé do menu lateral do Dashboard da Easy Auth" url="app.easyauth.net" />

### 2. Entre na BIP

Se você já está logado na BIP, a tela de autorização abre direto. Se não:

1. A BIP abre a tela de login. Informe e-mail e senha e clique em **Entrar**, ou use **Entrar com OTP** para receber um código por e-mail.
2. Ainda não tem usuário? Clique em **Cadastrar-se**, preencha **Nome Completo**, **Email**, **Localização**, **Senha** e **Confirmar Senha** e clique em **Cadastrar**.
3. Depois do login ou do cadastro, a BIP volta sozinha para a tela de autorização.

<Shot src="/img/wifi-conectar-easy-auth/2-pt-br.png" alt="Tela de login da BIP com Entrar, Entrar com OTP e Cadastrar-se" url="dash.bip.marketing/signin" />

### 3. Confira o nome, o idioma e o fuso

A tela de autorização mostra o logo da Easy Auth e avisa que a BIP vai criar a conta, sincronizar os campos e configurar o webhook por você.

1. **Nome da Conta**: já vem com o nome da licença. Ajuste se quiser, por exemplo _Padaria Aurora_. É o nome que aparece no seletor de contas e como remetente dos e-mails.
2. **Idioma**: a tela abre em **Inglês**. Escolha **Português** para a conta nascer com grupos e tópicos em português.
3. **Fuso Horário**: a BIP sugere o fuso do seu computador. No horário de Brasília, é **America/Sao_Paulo (-03:00)**. Ele define o que é "hoje" nos critérios de data dos segmentos.

<Shot src="/img/wifi-conectar-easy-auth/3-pt-br.png" alt="Tela de autorização com Nome da Conta, Idioma e Fuso Horário" url="dash.bip.marketing/easyauth-authorize" />

### 4. Escolha os campos que vão para a BIP

Na lista de campos para criar na conta, a BIP mostra os campos do seu EasySpot:

1. Os campos padrão (**Nome**, **Telefone** e **Email**) ficam sempre marcados. Eles preenchem os dados principais do contato.
2. Os demais campos viram campos personalizados. Ao lado de cada um, a BIP mostra o tipo que vai criar (veja a tabela em [Referência](#referencia)).
3. Desmarque o que você não quer na BIP. Se quiser, troque o nome do campo: é esse nome que aparece em **Configurações** → **Geral** → **Campos** e nos critérios de segmento.

<Shot src="/img/wifi-conectar-easy-auth/4-pt-br.png" alt="Lista de campos do EasySpot com o tipo que a BIP vai criar para cada um" url="dash.bip.marketing/easyauth-authorize" />

### 5. Autorize e crie a conta

1. Clique em **Autorizar e Criar Conta**.
2. A BIP mostra **Conta criada com sucesso!** e abre a conta nova. Você entra como administrador.
3. O identificador da conta (o namespace) é `easyauth-` seguido do rótulo da sua licença. Ele aparece na URL e em **Configurações** → **Geral**.

Mudou de ideia? **Recusar** cancela sem criar nada e volta para o login.

<Shot src="/img/wifi-conectar-easy-auth/5-pt-br.png" alt="Conta criada pela Easy Auth aberta no painel da BIP" url="dash.bip.marketing/easyauth-…" />

### 6. Confira o que a BIP criou

1. Em **Configurações** → **Geral**, vá até **Campos**: estão lá os campos que você marcou, com os tipos da tabela de referência.
2. Em **Configurações** → **Chaves de API**, veja a chave **EasyAuth API Key**, ativa, com o escopo **Escrita de Contatos**.
3. Em **Configurações** → **Grupos** e **Tópicos**, a conta já vem com grupos e tópicos prontos para usar.

<Callout type="warning">
Não desative, não apague e não ponha data de expiração na **EasyAuth API Key**. É com ela que a Easy Auth entrega os visitantes: sem a chave ativa, os novos visitantes deixam de chegar.
</Callout>

<Shot src="/img/wifi-conectar-easy-auth/6-pt-br.png" alt="Chave EasyAuth API Key em Configurações, aba Chaves de API" url="dash.bip.marketing/easyauth-…/settings" />

### 7. Veja os visitantes chegarem

1. Conecte um celular ao Wi-Fi e passe pelo EasySpot, ou espere o próximo visitante.
2. Em **Contatos**, ordene por **Atualizado (Mais Recente)**. Quem acabou de se conectar aparece no topo, por exemplo _Marina Alves_.
3. A coluna **Data de Criação** mostra a primeira visita; **Data de Atualização**, a mais recente.
4. Clique no contato para ver telefone, e-mail e, em **Campos**, os dados do EasySpot.

<Shot src="/img/wifi-conectar-easy-auth/7-pt-br.png" alt="Contatos ordenados por Atualizado (Mais Recente), com os visitantes do Wi-Fi no topo" url="dash.bip.marketing/easyauth-…/leads" />

## Referência

### O que a BIP cria

| Item                              | Onde ver                                   | Detalhe                                                                                      |
| --------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------- |
| Conta `easyauth-<rótulo>`         | Seletor de contas, no topo do menu lateral | BIP Lite com 1.000 envios grátis por mês. Você entra como administrador                      |
| Campos personalizados             | Configurações → Geral → Campos             | Um para cada campo extra do EasySpot que você marcou                                         |
| Remetente dos e-mails             | Configurações → Geral                      | **Email De (Nome)** com o nome da conta e o endereço padrão da BIP                           |
| Grupos                            | Configurações → Grupos                     | Para organizar campanhas, modelos de e-mail, segmentos e webhooks                            |
| 5 tópicos                         | Configurações → Tópicos                    | Newsletter, Promocional, Atualizações de Produto, Feedback do Cliente e Evento               |
| Chave de API **EasyAuth API Key** | Configurações → Chaves de API              | Escopo **Escrita de Contatos** (`leads:write`), sem expiração                                |
| Webhook                           | Dashboard da Easy Auth → **Webhooks**      | Envia nome, e-mail, telefone e os campos marcados para `https://api.bip.marketing/api/leads` |

### Campo da Easy Auth → tipo na BIP

| Campo do EasySpot  | Na BIP                                      |
| ------------------ | ------------------------------------------- |
| Nome               | **Nome** do contato                         |
| Telefone           | **Telefone** do contato, com código do país |
| E-mail             | **Email** do contato                        |
| Data de Nascimento | Campo personalizado **Data**                |
| Gênero             | Campo personalizado **String**              |
| Texto              | Campo personalizado **String**              |
| Número             | Campo personalizado **Número**              |
| Cidade             | Campo personalizado **Localização**         |

A data de nascimento vira campo **Data**: use o modo **Aniversário** para falar com o aniversariante do dia. A cidade vira **Localização**, gravada sempre como cidade: use **Dentro do raio** para alcançar visitantes de cidades próximas.

## Pronto para copiar

Em **Segmentos**, clique em **Novo Segmento** e adicione os critérios abaixo. Para datas relativas, clique no valor, ligue **Relativo** em **Modo de Data**, preencha **Tempo Relativo** em **Dias** (número negativo = no passado) e deixe **Início do dia** ligado.

### Visitantes de hoje

Quem se conectou hoje, novo ou recorrente.

| Critério   | Operador          | Valor                       |
| ---------- | ----------------- | --------------------------- |
| Atualizado | Depois ou igual a | Relativo: 0 dias (**Hoje**) |

### Quem voltou hoje

Primeira visita antes de hoje e uma nova conexão hoje. Use o grupo **Todos (AND)**.

| Critério        | Operador          | Valor                       |
| --------------- | ----------------- | --------------------------- |
| Data de Criação | Antes             | Relativo: 0 dias (**Hoje**) |
| Atualizado      | Depois ou igual a | Relativo: 0 dias (**Hoje**) |

### Sumidos há 30 dias

Quem não se conecta há mais de 30 dias.

| Critério   | Operador | Valor              |
| ---------- | -------- | ------------------ |
| Atualizado | Antes    | Relativo: -30 dias |

<Callout type="tip">
**Atualizado** também muda quando você edita o contato ou o atualiza por importação ou pela API. Numa conta que só recebe visitantes da Easy Auth, ele marca a última conexão. Se você também importa planilhas, separe os visitantes do Wi-Fi com **Primeira / Última Origem** → **Primeira Origem (Tipo)** → **Igual a** → **API**.
</Callout>

## Como medir

- Em **Contatos**, ordene por **Atualizado (Mais Recente)**: os visitantes aparecem no topo conforme se conectam.
- Crie o segmento **Visitantes de hoje**. A contagem ao vivo mostra quantas pessoas se conectaram hoje; compare dia a dia.
- Na Easy Auth, em **Webhooks**, clique em **Ver Logs**: cada envio para `https://api.bip.marketing/api/leads` aparece com **Status**, **Tópico**, **URL** e **Hora**. Em **Ver Requisição**, o **Corpo da Resposta** traz o `id` do contato na BIP.

## Perguntas frequentes

### Os visitantes que já passaram pelo Wi-Fi vêm junto?

Não. A integração traz os visitantes a partir das próximas conexões. Para trazer a base antiga, exporte na Easy Auth (**Estatísticas** → aba **Usuários** → **Download** → **Csv** ou **Excel**) e importe na BIP. Quem já estiver na BIP pelo telefone ou pelo e-mail é atualizado, sem duplicar. Nesses contatos, a **Data de Criação** é a data da importação. Veja [Importar contatos](/pt-br/importar-contatos).

### A integração já manda boas-vindas para quem se conecta?

Não. O webhook automático traz o contato e os campos; ele não envia tags, KPIs nem metadados e não dispara campanhas. Para mandar uma mensagem na hora da conexão, crie na BIP uma campanha de **Disparo por API** e, na Easy Auth, um webhook próprio que chama `POST https://api.bip.marketing/api/campaigns/trigger`. Use uma chave de API nova com **Disparo de Campanhas** e **Escrita de Contatos**: a **EasyAuth API Key** tem só **Escrita de Contatos**. Veja [API](/pt-br/api).

### Receber visitantes consome envios?

Não. Receber, guardar e segmentar contatos não conta. Só conta o e-mail ou a mensagem de WhatsApp que sai para uma pessoa. A conta nasce no BIP Lite com 1.000 envios grátis por mês; WhatsApp e domínio de envio próprio entram no plano pago. Veja [Planos e limites](/pt-br/planos-e-limites).

### Cliquei de novo em bip.marketing. A BIP cria outra conta?

Não. Cada licença da Easy Auth tem uma conta na BIP. Se ela já existe, a BIP avisa **Namespace já existe** e leva você de volta ao painel.

## Veja também

- [Bip.Marketing na Wiki da Easy Auth](https://wiki.easyauth.com.br/pt-br/bip-marketing)
- [Segmentos: os 10 critérios para filtrar contatos](/pt-br/segmentos)
- [Campanhas: única, recorrente e por API](/pt-br/campanhas)
- [API da BIP: chaves, contatos, eventos e disparos](/pt-br/api)
- [Importar contatos de uma planilha](/pt-br/importar-contatos)
- [Glossário da BIP: os termos do painel](/pt-br/glossario)