# Bem-vindo de volta: oferta do dia para quem reconecta

> Na BIP, crie uma campanha de Disparo por API em modo Imediato, com Permitir Reentrada do Lead ligado e Período de Espera de 7 dias. Na Easy Auth, crie um webhook Ao Conectar, limitado A partir da segunda conexão, que chama /api/campaigns/trigger. Quem volta recebe a oferta, no máximo uma vez a cada 7 dias.

Fonte: https://wiki.bip.marketing/pt-br/wifi-bem-vindo-de-volta · Atualizado: 2026-10-08

<UseCaseMeta effort="nocode" channel="whatsapp" plan="lite" />

O cliente que voltou à loja recebe no WhatsApp, enquanto ainda está lá dentro, a oferta que só vale hoje para quem volta. Sem repetir a mesma mensagem a cada visita.

<Checklist items="A Easy Auth ligada à BIP (veja o guia Conectar a Easy Auth à BIP)|Um EasySpot que peça o telefone do visitante|Plano pago da BIP, com o WhatsApp conectado e um template de Marketing aprovado|Uma chave de API com Disparo de Campanhas e Escrita de Contatos (a chave das boas-vindas serve)|Acesso a Webhooks no Dashboard da Easy Auth" />

## O que você vai conseguir

- Uma oferta no WhatsApp para quem volta ao seu Wi-Fi, no momento da conexão.
- Só para clientes que voltam: quem entra pela primeira vez não recebe esta mensagem.
- No máximo uma oferta a cada 7 dias por pessoa, por mais que ela volte.
- O contato atualizado a cada volta, com nome, telefone e a tag `wifi`.
- A frequência de visita à vista: as voltas seguradas pela janela de 7 dias aparecem nas estatísticas.

## Como funciona

<Steps items="Crie na BIP a campanha da oferta, com reentrada de 7 dias|Crie na Easy Auth um webhook Ao Conectar, a partir da segunda conexão|Quem volta recebe a oferta do dia no WhatsApp" />

Duas regras, uma em cada ponta, decidem quem recebe:

- na Easy Auth, **Limitar Chamadas por Usuário** em **A partir da segunda conexão**: o webhook chama a BIP quando o visitante volta, e não na primeira visita;
- na BIP, **Permitir Reentrada do Lead** ligado, com **Período de Espera (Dias)** de `7`: a mesma pessoa recebe a oferta de novo só depois de 7 dias do último envio.

Veja o que acontece com Tiago Pereira, cliente da Loja Horizonte:

| Visita de Tiago                     | Easy Auth                       | BIP                                                              |
| ----------------------------------- | ------------------------------- | ---------------------------------------------------------------- |
| 1ª, segunda-feira                   | Não chama: é a primeira conexão | —                                                                |
| 2ª, quarta-feira                    | Chama a campanha                | Envia a oferta                                                   |
| 3ª, sexta-feira                     | Chama a campanha                | Segura: faltam dias para completar 7. Aparece como **Rejeitado** |
| 4ª, quinta-feira da semana seguinte | Chama a campanha                | Envia de novo: já se passaram 8 dias do último envio             |

Uma chamada que a reentrada segura não envia mensagem e não consome envio.

## Passo a passo

### 1. Tenha a chave de API para a Easy Auth

Se você já fez as [boas-vindas no Wi-Fi](/pt-br/wifi-boas-vindas), use a mesma chave, _Easy Auth — campanhas_. Se não:

1. Na BIP, em **Configurações**, abra a aba **Chaves de API** e clique em **Adicionar Nova Chave de API**.
2. Em **Nome**, escreva _Easy Auth — campanhas_. Deixe **Ativo** ligado e, em **Expiração Automática**, **Habilitado** desligado.
3. Em **Escopos**, ligue **Disparo de Campanhas** e **Escrita de Contatos**.
4. Clique em **Salvar** e copie a **Chave de API**.

A chave da integração, **EasyAuth API Key**, não serve aqui: ela só tem **Escrita de Contatos**.

<Shot src="/img/wifi-bem-vindo-de-volta/1-pt-br.png" alt="Lista de chaves de API com a chave Easy Auth — campanhas ativa e os escopos Disparo de Campanhas e Escrita de Contatos" url="dash.bip.marketing/easyauth-…/settings?tab=api-keys" />

### 2. Crie o template da oferta

1. Em **WhatsApp**, abra a aba **Templates** e clique em **Criar template**.
2. Em **Nome (minúsculo)**, escreva `horizonte_oferta_de_volta`. Em **Categoria**, **Marketing**. Em **Idioma**, **Portuguese (BR)**.
3. Preencha o cabeçalho, o corpo, o rodapé e o botão com os textos de [Pronto para copiar](#pronto-para-copiar), com `Tiago` como exemplo da variável.
4. Clique em **Salvar Template** e espere o status **Aprovado**.

<Shot src="/img/wifi-bem-vindo-de-volta/2-pt-br.png" alt="Template horizonte_oferta_de_volta com a pré-visualização da oferta de volta" url="dash.bip.marketing/easyauth-…/whatsapp/templates/create" />

### 3. Crie a campanha com reentrada de 7 dias

1. Em **Campanhas**, clique em **Nova Campanha**. Em **Nome da Campanha**, escreva _Oferta de volta do Wi-Fi_.
2. Em **Tipo de Agendamento**, escolha **Disparo por API** e, em **Modo de Disparo**, **Imediato**.
3. Em **Janela de Reentrada do Lead**, ligue **Permitir Reentrada do Lead** e preencha **Período de Espera (Dias)** com `7`. Sem isso, cada cliente receberia a oferta uma vez só, para sempre.
4. Em **Canal**, escolha **WhatsApp**. Selecione o **Template** `horizonte_oferta_de_volta` e o **Número de telefone**.
5. Em **Mapeamento de variáveis**, clique em **Adicionar mapeamento de variável** e ligue **Corpo · {{1}}** a **first name**.
6. Abra **Integração via API** e copie o ID da campanha.

<Shot src="/img/wifi-bem-vindo-de-volta/3-pt-br.png" alt="Campanha Oferta de volta do Wi-Fi com Disparo por API e Permitir Reentrada do Lead ligado com 7 dias" url="dash.bip.marketing/easyauth-…/campaigns/…" />

### 4. Teste e ative a campanha

1. Clique em **Salvar** → **Salvar Rascunho**.
2. Clique em **Testar Campanha**, digite o seu telefone com `+` e o código do país e clique em **Enviar Teste**. O teste não consome envios.
3. Confira a mensagem no celular.
4. Clique em **Salvar** → **Salvar e Ativar** e confirme em **Ativar Disparo por API**.

<Shot src="/img/wifi-bem-vindo-de-volta/4-pt-br.png" alt="Mensagem de teste da oferta de volta com o primeiro nome preenchido" url="dash.bip.marketing/easyauth-…/campaigns/…" />

### 5. Crie o webhook a partir da segunda conexão

1. No Dashboard da Easy Auth, em app.easyauth.net, clique em **Webhooks**. No webhook com a URL `https://api.bip.marketing/api/leads`, clique em **Editar Webhook**, copie as linhas do **Corpo** e clique em **Ocultar Edição de Webhook**, sem mudar nada.
2. Clique em **Adicionar Webhook** → **Personalizado**.
3. Em **Nome**, escreva _Oferta de volta → BIP_. Em **Tópico**, escolha **Ao Conectar**. Em **Idioma**, **Português**.
4. Em **Limitar Chamadas por Usuário**, escolha **A partir da segunda conexão**.
5. Em **Método**, deixe **POST**. Em **URL**, cole `https://api.bip.marketing/api/campaigns/trigger`.
6. Se aparecer **Tags de Disparo**, deixe todas as tags desligadas.
7. Em **Cabeçalhos**, clique em **Adicionar Cabeçalho** duas vezes: **Chave** `Content-Type` com **Valor** `application/json`, e **Chave** `x-bip-api-key` com a chave do passo 1.
8. Em **Corpo**, apague o texto que vem pronto e cole o corpo de [Pronto para copiar](#pronto-para-copiar). Troque `ID_DA_CAMPANHA` pelo ID do passo 3 e, dentro de `lead`, use as linhas que você copiou.

<Shot src="/img/wifi-bem-vindo-de-volta/5-pt-br.png" alt="Webhook Oferta de volta → BIP com tópico Ao Conectar e A partir da segunda conexão" url="app.easyauth.net" />

### 6. Teste o webhook e salve

1. Clique em **Testar Webhook**.
2. Em **Carregar dados de exemplo**, informe o telefone com que você já entrou no Wi-Fi e clique em **Carregar**.
3. Clique em **Enviar Teste**. Em **Resposta**, o status `200` e o **Corpo da Resposta** com `"mode": "immediate"` confirmam o disparo.
4. Clique em **Fechar**. Confira se o **Status** do webhook está ligado e clique em **Salvar**, no topo da página.

O **Enviar Teste** é um disparo de verdade: a oferta chega no seu celular e conta um envio. Pelos próximos 7 dias, a reentrada segura novas ofertas para o seu contato.

<Shot src="/img/wifi-bem-vindo-de-volta/6-pt-br.png" alt="Teste do webhook com o corpo carregado com dados reais e a resposta 200 da BIP" url="app.easyauth.net" />

## Pronto para copiar

### Corpo do webhook

Exemplo da Loja Horizonte: o EasySpot pede o nome e o telefone, que é a chave da licença. Troque `ID_DA_CAMPANHA` pelo ID da campanha da oferta.

<Copy label="Corpo do webhook (Easy Auth)" code>
{
  "campaignId": "ID_DA_CAMPANHA",
  "lead": {
    "name": "{{ field('field-name.value') }}",
    "phone": "+{{ key('raw-full') }}",
    "tags": ["wifi"]
  }
}
</Copy>

Dentro de `lead`, use as linhas do corpo da sua integração: elas trazem as variáveis certas para o seu EasySpot. O telefone precisa estar lá, porque é para ele que o WhatsApp vai.

### Webhook na Easy Auth

| Campo                            | Valor                                                                             |
| -------------------------------- | --------------------------------------------------------------------------------- |
| **Nome**                         | Oferta de volta → BIP                                                             |
| **Tópico**                       | **Ao Conectar**                                                                   |
| **Idioma**                       | **Português**                                                                     |
| **Limitar Chamadas por Usuário** | **A partir da segunda conexão**                                                   |
| **Método**                       | **POST**                                                                          |
| **URL**                          | `https://api.bip.marketing/api/campaigns/trigger`                                 |
| **Tags de Disparo**              | Todas desligadas                                                                  |
| **Cabeçalhos**                   | `Content-Type`: `application/json` · `x-bip-api-key`: a chave com os dois escopos |

### Campanha na BIP

| Opção                           | Valor                                                                   |
| ------------------------------- | ----------------------------------------------------------------------- |
| **Tipo de Agendamento**         | **Disparo por API**                                                     |
| **Modo de Disparo**             | **Imediato**                                                            |
| **Janela de Reentrada do Lead** | **Permitir Reentrada do Lead** ligado, **Período de Espera (Dias)** `7` |
| **Canal**                       | **WhatsApp**, template `horizonte_oferta_de_volta`                      |
| **Mapeamento de variáveis**     | **Corpo · {{1}}** → **first name**                                      |

### Template de WhatsApp

<WaTemplate name="horizonte_oferta_de_volta" category="MARKETING" header="Que bom ver você de novo" footer="Loja Horizonte · Oferta válida hoje, na loja" buttons="Ver novidades">
Oi, {{1}}! Que bom ter você de volta na Loja Horizonte. Hoje, quem volta ganha 10% de desconto em qualquer peça da loja. É só mostrar esta mensagem no caixa até o fim do dia.
</WaTemplate>

Botão **URL**: `https://www.exemplo.com.br/novidades`

| Variável na campanha | Campo do contato | Valor de exemplo |
| -------------------- | ---------------- | ---------------- |
| **Corpo · {{1}}**    | **first name**   | Tiago            |

## Como medir

- **Na BIP**: abra **Estatísticas da Campanha** da _Oferta de volta do Wi-Fi_. Acompanhe **Enviado**, **Entregue**, **Taxa de leitura**, **Taxa de resposta** e **Erros**.
- **Quem volta na mesma semana**: em **Interações do Destinatário**, filtre por **Rejeitado**. O motivo **O lead está dentro da janela de reentrada** mostra quem voltou ao Wi-Fi antes de completar 7 dias do último envio. São os seus clientes mais frequentes.
- **Na Easy Auth**: em **Webhooks**, clique em **Ver Logs**. Cada volta aparece como uma chamada para `https://api.bip.marketing/api/campaigns/trigger`, com **Status**, **Tópico**, **URL** e **Hora**. Em **Ver Requisição**, o **Corpo da Resposta** traz o `leadId` e o `mode`.
- **Retornantes**: em **Estatísticas** → aba **Geral**, a Easy Auth mostra os novos e os retornantes do período. Compare os retornantes com os envios da campanha.
- **No caixa**: conte quantas pessoas mostraram a mensagem para usar o desconto.

Se um log mostrar `403` com `API key does not have the required permissions`, ligue **Disparo de Campanhas** e **Escrita de Contatos** na chave. Com `400` e `Campaign is not active`, ative a campanha em **Salvar e Ativar**.

## Variações

- **Uma oferta por dia, não por semana**: use **Período de Espera (Dias)** `1`. O cliente recebe no máximo uma oferta a cada 24 horas.
- **Só a partir da terceira visita**: em **Limitar Chamadas por Usuário**, escolha **A partir da terceira conexão** para premiar quem já virou freguês.
- **Troque a oferta sem criar outro template**: crie em **Configurações** → **Geral** → **Campos** um campo _Oferta do dia_, do tipo **String**. Escreva o template com uma segunda variável ("Hoje, quem volta ganha {{2}}.") e mapeie **Corpo · {{2}}** a **"Oferta do dia" field value**. No corpo do webhook, dentro de `lead`, acrescente `"fields": [{ "key": "Oferta do dia", "value": "10% de desconto em qualquer peça" }]`. Para mudar a oferta, edite só esse valor no webhook e clique em **Salvar**. Se o corpo da integração já trouxer uma lista `fields`, acrescente o item nela.
- **Assinantes do provedor (Easy Auth PRO)**: troque o tópico por **Ao Conectar ISP** para mandar a oferta de volta só para assinantes, como um upgrade de plano. Veja [Webhooks de leads e vendas](https://wiki.easyauth.com.br/pt-br/webhooks-leads).

## Perguntas frequentes

### O cliente recebe a oferta toda vez que volta?

Não. Ele recebe na volta e, depois, só quando já se passaram 7 dias do último envio. As voltas no meio aparecem como **Rejeitado** nas estatísticas, sem mensagem e sem consumir envio.

### Quem entra pela primeira vez recebe a oferta?

Não. Com **A partir da segunda conexão**, a Easy Auth não chama a BIP na primeira visita. Para falar com quem chega, use as [boas-vindas no Wi-Fi](/pt-br/wifi-boas-vindas).

### Como mudo a oferta?

Um template aprovado não muda de texto. Crie um template novo e, na campanha, clique em **Pausar Campanha para Editar**, troque o **Template**, refaça o **Mapeamento de variáveis** e ative de novo em **Salvar e Ativar**. Enquanto a campanha está pausada, as chamadas da Easy Auth voltam com erro e ninguém recebe. Para trocar a oferta todo dia, use a variação com o campo _Oferta do dia_.

### Posso usar junto com as boas-vindas?

Sim. São duas campanhas e dois webhooks na Easy Auth: **Uma vez por usuário** chama as boas-vindas e **A partir da segunda conexão** chama a oferta de volta. A mesma chave de API serve para os dois.

## Veja também

- [Boas-vindas no Wi-Fi na hora da primeira conexão](/pt-br/wifi-boas-vindas)
- [Faz 30 dias que você não aparece: visitantes sumidos do Wi-Fi](/pt-br/wifi-sumidos-30-dias)
- [Conectar a Easy Auth à BIP e receber os visitantes do Wi-Fi](/pt-br/wifi-conectar-easy-auth)
- [Campanhas: única, recorrente e por API](/pt-br/campanhas)
- [API da BIP: chaves, contatos, eventos e disparos](/pt-br/api)
- [Templates de WhatsApp: criar, sincronizar e usar](/pt-br/templates-whatsapp)
- [Webhooks na Wiki da Easy Auth](https://wiki.easyauth.com.br/pt-br/webhooks)