# Boas-vindas no Wi-Fi na hora da primeira conexão

> Na BIP, crie uma campanha de Disparo por API em modo Imediato, com a reentrada desligada. Na Easy Auth, crie um webhook Ao Conectar, limitado a Uma vez por usuário, que chama /api/campaigns/trigger com os dados do visitante. Cada pessoa recebe as boas-vindas uma vez, na primeira conexão.

Fonte: https://wiki.bip.marketing/pt-br/wifi-boas-vindas · Atualizado: 2026-10-08

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

Quem entra no seu Wi-Fi pela primeira vez recebe as boas-vindas no celular enquanto ainda está no balcão, com o próprio nome e a oferta da primeira visita, sem ninguém apertar um botão.

<Checklist items="A Easy Auth ligada à BIP (veja o guia Conectar a Easy Auth à BIP)|Um EasySpot que peça o telefone (para WhatsApp) ou o e-mail (para e-mail) do visitante|Para WhatsApp: plano pago da BIP, número conectado e um template de Marketing aprovado|Para e-mail: um modelo de e-mail pronto (o plano gratuito já envia e-mail)|Acesso de administrador na BIP, para criar a chave de API, e acesso a Webhooks no Dashboard da Easy Auth" />

## O que você vai conseguir

- Uma mensagem de boas-vindas que sai sozinha, assim que o visitante se conecta pela primeira vez.
- Uma mensagem por pessoa: quem volta todo dia não recebe as boas-vindas de novo.
- O contato criado ou atualizado na mesma chamada, com nome, telefone, e-mail e a tag `wifi`.
- WhatsApp com template aprovado ou e-mail, conforme o que o seu EasySpot pede.
- Cada envio rastreado dos dois lados: nas estatísticas da campanha, na BIP, e nos logs do webhook, na Easy Auth.

## Como funciona

<Steps items="Crie na BIP uma campanha de Disparo por API, em modo Imediato|Crie na Easy Auth um webhook Ao Conectar, uma vez por usuário, que chama a campanha|Cada visitante novo recebe as boas-vindas na hora" />

A integração do guia [Conectar a Easy Auth à BIP](/pt-br/wifi-conectar-easy-auth) traz o contato, mas não dispara campanhas. Para responder na hora da conexão, você liga as duas pontas:

- na BIP, uma campanha de **Disparo por API** em modo **Imediato**, que envia a mensagem assim que recebe a chamada;
- na Easy Auth, um segundo webhook, com o tópico **Ao Conectar**, que chama `POST https://api.bip.marketing/api/campaigns/trigger` com o ID da campanha e os dados do visitante. A BIP cria ou atualiza o contato e dispara, tudo na mesma chamada.

Duas travas garantem uma mensagem por pessoa:

- na Easy Auth, **Limitar Chamadas por Usuário** em **Uma vez por usuário**: o webhook chama a BIP uma vez só para cada visitante;
- na BIP, a **Janela de Reentrada do Lead** desligada, que é o padrão: cada contato recebe a campanha uma vez, para sempre.

<Callout type="tip">
A chave que a integração criou, **EasyAuth API Key**, tem só **Escrita de Contatos**. Para disparar campanhas, crie uma chave nova com **Disparo de Campanhas** e **Escrita de Contatos**, e deixe a da integração como está.
</Callout>

## Passo a passo

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

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_.
3. Deixe **Ativo** ligado. Em **Expiração Automática**, deixe **Habilitado** desligado: assim o webhook não para de funcionar numa data.
4. Em **Escopos**, ligue **Disparo de Campanhas** e **Escrita de Contatos**.
5. Clique em **Salvar** e copie a **Chave de API**. Você vai colá-la na Easy Auth no passo 6.

<Shot src="/img/wifi-boas-vindas/1-pt-br.png" alt="Chave de API Easy Auth — campanhas com os escopos Disparo de Campanhas e Escrita de Contatos" url="dash.bip.marketing/easyauth-…/settings?tab=api-keys" />

### 2. Prepare a mensagem

Escolha o canal pelo que o seu EasySpot pede: telefone para WhatsApp, e-mail para e-mail.

- **WhatsApp**: em **WhatsApp**, abra a aba **Templates** e clique em **Criar template**. Monte o template `aurora_boas_vindas_wifi` com os textos de [Pronto para copiar](#pronto-para-copiar), na **Categoria** **Marketing** e no **Idioma** **Portuguese (BR)**. Clique em **Salvar Template** e espere o status **Aprovado**.
- **E-mail**: em **Modelos de Email**, clique em **Novo Modelo** e monte o e-mail de boas-vindas com os textos de [Pronto para copiar](#pronto-para-copiar). Clique em **Salvar**.

<Shot src="/img/wifi-boas-vindas/2-pt-br.png" alt="Template aurora_boas_vindas_wifi aprovado na aba Templates do WhatsApp" url="dash.bip.marketing/easyauth-…/whatsapp?tab=templates" />

### 3. Crie a campanha de Disparo por API

1. Em **Campanhas**, clique em **Nova Campanha**. Em **Nome da Campanha**, escreva _Boas-vindas 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**, deixe **Permitir Reentrada do Lead** desligado. É o padrão e é o que você quer: cada contato recebe as boas-vindas uma vez.
4. Em **Canal**, escolha **WhatsApp**: selecione o **Template** aprovado e o **Número de telefone**. Em **Mapeamento de variáveis**, clique em **Adicionar mapeamento de variável** e ligue **Corpo · {{1}}** a **first name**. Para e-mail, escolha **Email**, preencha o **Nome do remetente** (_Padaria Aurora_) e ligue o **Modelo de E-mail**.
5. Abra **Integração via API** e copie o ID da campanha. Ele também está no fim do endereço da página.

<Shot src="/img/wifi-boas-vindas/3-pt-br.png" alt="Campanha Boas-vindas do Wi-Fi com Disparo por API em modo Imediato e o template de WhatsApp mapeado" 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) ou o seu e-mail e clique em **Enviar Teste**. Você precisa ser um contato da BIP: conecte-se uma vez ao Wi-Fi antes. O teste não consome envios.
3. Confira a mensagem no celular ou na caixa de entrada.
4. Clique em **Salvar** → **Salvar e Ativar** e confirme em **Ativar Disparo por API**. O status passa a **Ativo** e a campanha já aceita chamadas.

<Shot src="/img/wifi-boas-vindas/4-pt-br.png" alt="Janela de confirmação Ativar Disparo por API da campanha de boas-vindas" url="dash.bip.marketing/easyauth-…/campaigns/…" />

### 5. Copie o corpo do webhook da integração

O webhook que a BIP criou na Easy Auth já tem as variáveis certas para os campos do seu EasySpot. Você reaproveita esse texto.

1. Entre no Dashboard da Easy Auth, em app.easyauth.net, e clique em **Webhooks** no menu lateral.
2. No webhook com a URL `https://api.bip.marketing/api/leads`, clique em **Editar Webhook**.
3. Em **Corpo**, copie as linhas de dentro das chaves. O nome, por exemplo, vem como `"name": "{{ field('field-name.value') }}"`.
4. Clique em **Ocultar Edição de Webhook**, sem mudar nada nesse webhook.

<Shot src="/img/wifi-boas-vindas/5-pt-br.png" alt="Corpo do webhook da integração com as variáveis da Easy Auth para nome, telefone e e-mail" url="app.easyauth.net" />

### 6. Crie o webhook de boas-vindas na Easy Auth

1. Clique em **Adicionar Webhook** → **Personalizado**.
2. Em **Nome**, escreva _Boas-vindas → BIP_. Em **Tópico**, escolha **Ao Conectar**. Em **Idioma**, **Português**.
3. Em **Limitar Chamadas por Usuário**, escolha **Uma vez por usuário**.
4. Em **Método**, deixe **POST**. Em **URL**, cole `https://api.bip.marketing/api/campaigns/trigger`.
5. Se aparecer **Tags de Disparo**, deixe todas as tags desligadas: o webhook vale para todos os visitantes.
6. Em **Cabeçalhos**, clique em **Adicionar Cabeçalho** duas vezes. Preencha **Chave** `Content-Type` com **Valor** `application/json`, e **Chave** `x-bip-api-key` com a chave do passo 1.
7. 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 no passo 5.

<Shot src="/img/wifi-boas-vindas/6-pt-br.png" alt="Webhook Boas-vindas → BIP com tópico Ao Conectar, Uma vez por usuário e URL do trigger da BIP" url="app.easyauth.net" />

### 7. Teste o webhook e salve

1. Clique em **Testar Webhook**.
2. Em **Carregar dados de exemplo**, informe o telefone ou o e-mail com que você já entrou no Wi-Fi e clique em **Carregar**. O corpo aparece com os seus dados no lugar das variáveis.
3. Clique em **Enviar Teste**. Em **Resposta**, o status `200` e o **Corpo da Resposta** com `"mode": "immediate"` mostram que a BIP disparou. A mensagem chega no seu celular ou no seu e-mail.
4. Clique em **Fechar**. Confira se o **Status** do webhook está ligado e clique em **Salvar**, no topo da página.

<Callout type="warning">
O **Enviar Teste** do webhook é um disparo de verdade: a mensagem sai e conta um envio. Com a reentrada desligada, o seu contato não recebe essas boas-vindas de novo. Para repetir o teste, use os dados de outra pessoa da equipe.
</Callout>

<Shot src="/img/wifi-boas-vindas/7-pt-br.png" alt="Teste do webhook com a resposta 200 da BIP e o modo immediate" url="app.easyauth.net" />

## Pronto para copiar

### Corpo do webhook

Exemplo da Padaria Aurora: o EasySpot pede o nome, o telefone (a chave da licença) e o e-mail. Troque `ID_DA_CAMPANHA` pelo ID da sua campanha.

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

| Linha        | O que envia                                                                        |
| ------------ | ---------------------------------------------------------------------------------- |
| `campaignId` | O ID da campanha de boas-vindas, do painel **Integração via API**                  |
| `name`       | O nome que o visitante digitou no EasySpot                                         |
| `phone`      | O telefone da chave da licença, com `+` e o código do país, pronto para o WhatsApp |
| `email`      | O e-mail do campo **E-mail** do EasySpot                                           |
| `tags`       | A tag `wifi`, para você separar os visitantes do Wi-Fi nos segmentos               |

Use sempre as linhas do corpo da sua integração (passo 5): elas batem com os campos do seu EasySpot. Se a chave da sua licença é o e-mail, por exemplo, a linha vem como `"email": "{{ key('value') }}"`. Se o corpo da integração traz a lista `fields` (data de nascimento, cidade), cole a lista inteira dentro de `lead` para manter esses campos em dia.

### Webhook na Easy Auth

| Campo                            | Valor                                                                             |
| -------------------------------- | --------------------------------------------------------------------------------- |
| **Nome**                         | Boas-vindas → BIP                                                                 |
| **Tópico**                       | **Ao Conectar**                                                                   |
| **Idioma**                       | **Português**                                                                     |
| **Limitar Chamadas por Usuário** | **Uma vez por usuário**                                                           |
| **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** desligado                             |
| **Canal**                       | **WhatsApp** com o template abaixo, ou **Email** com o modelo abaixo |

### Template de WhatsApp

<WaTemplate name="aurora_boas_vindas_wifi" category="MARKETING" header="Boas-vindas à Padaria Aurora" footer="Padaria Aurora · Oferta válida hoje, no balcão" buttons="Ver cardápio">
Oi, {{1}}! Que bom ter você na Padaria Aurora. Na sua primeira visita, o café coado é por nossa conta na compra de qualquer salgado. É só mostrar esta mensagem no caixa. Bom apetite!
</WaTemplate>

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

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

### E-mail de boas-vindas

Onde aparece `[@primeiro nome]`, digite `@first`, escolha `lead.firstName()` e use `cliente` como **Valor de Fallback**.

<Copy label="Assunto">
[@primeiro nome], o primeiro café é por nossa conta ☕
</Copy>

<Copy label="Pré-visualização">
Obrigado por usar o Wi-Fi da Padaria Aurora. Mostre este e-mail no caixa.
</Copy>

<Copy label="Cabeçalho">
Que bom ter você aqui, [@primeiro nome]!
</Copy>

<Copy label="Texto">
Você acabou de entrar no Wi-Fi da Padaria Aurora. Fique à vontade: pão quentinho sai do forno a partir das 7h, todos os dias.

Para comemorar a sua primeira visita, o café coado é por nossa conta na compra de qualquer salgado. É só mostrar este e-mail no caixa, hoje.
</Copy>

<Copy label="Botão — Nome">
Ver o cardápio
</Copy>

<Copy label="Botão — URL do Link">
https://www.exemplo.com.br/cardapio
</Copy>

## Como medir

- **Na BIP**: em **Campanhas**, abra **Estatísticas da Campanha** da _Boas-vindas do Wi-Fi_. No WhatsApp, acompanhe **Enviado**, **Entregue**, **Taxa de leitura**, **Taxa de resposta** e **Erros**. No e-mail, **Processado (_N_ execuções)**, **Entregue**, **Taxa de Abertura** e **Taxa de Cliques**.
- **Quem recebeu**: em **Interações do Destinatário**, cada visitante aparece com data e status. **Rejeitado**, com o motivo **O lead já recebeu esta campanha**, é uma chamada repetida que a BIP segurou.
- **Na Easy Auth**: em **Webhooks**, clique em **Ver Logs**. Cada chamada para `https://api.bip.marketing/api/campaigns/trigger` aparece com **Status**, **Tópico**, **URL** e **Hora**. Em **Ver Requisição**, o **Corpo da Requisição** mostra os dados enviados e o **Corpo da Resposta**, o `leadId` e o `mode`.
- **Novos visitantes**: em **Estatísticas** → aba **Geral**, a Easy Auth mostra os novos e os retornantes do período. Compare os novos com os envios da campanha.
- **No caixa**: conte quantas pessoas mostraram a mensagem para ganhar o café.

Se um log mostrar erro, o **Corpo da Resposta** diz o motivo:

| Status | Mensagem                                         | O que fazer                                                                |
| ------ | ------------------------------------------------ | -------------------------------------------------------------------------- |
| 400    | `Campaign is not active`                         | Ative a campanha em **Salvar e Ativar**                                    |
| 400    | `Validation Error`                               | Confira o corpo: nome com 2 caracteres ou mais e telefone ou e-mail válido |
| 403    | `API key does not have the required permissions` | Ligue **Disparo de Campanhas** e **Escrita de Contatos** na chave          |
| 404    | `Campaign not found`                             | Confira o `campaignId` no corpo                                            |

## Variações

- **Só para quem não é assinante (Easy Auth PRO)**: no webhook, troque o tópico por **Ao Conectar Não-ISP**. Para dar boas-vindas diferentes aos assinantes, crie outra campanha e outro webhook com **Ao Conectar ISP**. Veja [Webhooks de leads e vendas](https://wiki.easyauth.com.br/pt-br/webhooks-leads).
- **Boas-vindas alguns minutos depois**: na campanha, troque o **Modo de Disparo** por **Atraso** e preencha **Atraso (Segundos)**, por exemplo `600`. A mensagem chega dez minutos depois da conexão, com o cliente já sentado.
- **WhatsApp e e-mail**: cada campanha usa um canal. Crie uma campanha para cada canal e, na Easy Auth, um webhook para cada uma, com o `campaignId` de cada campanha no corpo.
- **Oferta de volta para quem retorna**: com as boas-vindas no ar, siga para [Bem-vindo de volta: oferta do dia para quem reconecta](/pt-br/wifi-bem-vindo-de-volta).

## Perguntas frequentes

### Por que não usar o webhook que a integração já criou?

Porque ele só leva o contato para a BIP, em `https://api.bip.marketing/api/leads`, e não dispara campanhas. Deixe esse webhook como está, para todos os visitantes continuarem chegando em **Contatos**, e crie o de boas-vindas ao lado dele.

### O visitante recebe as boas-vindas toda vez que se conecta?

Não. Na Easy Auth, **Uma vez por usuário** faz o webhook chamar a BIP uma vez para cada visitante. Na BIP, com **Permitir Reentrada do Lead** desligado, cada contato recebe a campanha uma vez. Se uma chamada repetida chegar, ela aparece como **Rejeitado** nas estatísticas e a mensagem não sai.

### As boas-vindas consomem envios?

Cada mensagem que sai conta um envio do mês no BIP Lite. Criar e atualizar o contato não conta, e uma chamada que a reentrada segurou também não. Os testes feitos em **Testar Campanha** não consomem envios; o **Enviar Teste** do webhook, sim, porque é um disparo real.

### Posso mandar por WhatsApp e por e-mail ao mesmo tempo?

Sim, com duas campanhas: uma de WhatsApp e outra de e-mail, cada uma com o seu webhook na Easy Auth. O WhatsApp precisa de plano pago e do telefone do visitante; o e-mail funciona em qualquer plano, para quem informou o e-mail no EasySpot.

## Veja também

- [Conectar a Easy Auth à BIP e receber os visitantes do Wi-Fi](/pt-br/wifi-conectar-easy-auth)
- [API da BIP: chaves, contatos, eventos e disparos](/pt-br/api)
- [Campanhas: única, recorrente e por API](/pt-br/campanhas)
- [Templates de WhatsApp: criar, sincronizar e usar](/pt-br/templates-whatsapp)
- [Editor de e-mail: blocos, variáveis e preview](/pt-br/editor-de-email)
- [Bem-vindo de volta: oferta do dia para quem reconecta](/pt-br/wifi-bem-vindo-de-volta)
- [Boas-vindas no site da BIP](https://bip.marketing/pt-br/use-cases/welcome)
- [Webhooks na Wiki da Easy Auth](https://wiki.easyauth.com.br/pt-br/webhooks)