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

EsforçoSem códigoCanalWhatsApp + E-mailPlanoLite (pago)

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.

#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

1. 1Crie na BIP uma campanha de Disparo por API, em modo Imediato
2. 2Crie na Easy Auth um webhook Ao Conectar, uma vez por usuário, que chama a campanha
3. 3Cada visitante novo recebe as boas-vindas na hora

A integração do guia Conectar a Easy Auth à BIP 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.

#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.

dash.bip.marketing/easyauth-…/settings?tab=api-keys

Captura de tela em breve

#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, 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. Clique em Salvar.

dash.bip.marketing/easyauth-…/whatsapp?tab=templates

Captura de tela em breve

#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.

dash.bip.marketing/easyauth-…/campaigns/…

Captura de tela em breve

#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.

dash.bip.marketing/easyauth-…/campaigns/…

Captura de tela em breve

#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.

app.easyauth.net

Captura de tela em breve

#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. Troque ID_DA_CAMPANHA pelo ID do passo 3 e, dentro de lead, use as linhas que você copiou no passo 5.

app.easyauth.net

Captura de tela em breve

#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.

app.easyauth.net

Captura de tela em breve

#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.

{
  "campaignId": "ID_DA_CAMPANHA",
  "lead": {
    "name": "{{ field('field-name.value') }}",
    "phone": "+{{ key('raw-full') }}",
    "email": "{{ field('field-email.value') }}",
    "tags": ["wifi"]
  }
}

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

#Campanha na BIP

#Template de WhatsApp

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

#E-mail de boas-vindas

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

[@primeiro nome], o primeiro café é por nossa conta ☕

Obrigado por usar o Wi-Fi da Padaria Aurora. Mostre este e-mail no caixa.

Que bom ter você aqui, [@primeiro nome]!

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.

Ver o cardápio

https://www.exemplo.com.br/cardapio

#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:

#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.
• 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.

#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
• API da BIP: chaves, contatos, eventos e disparos
• Campanhas: única, recorrente e por API
• Templates de WhatsApp: criar, sincronizar e usar
• Editor de e-mail: blocos, variáveis e preview
• Bem-vindo de volta: oferta do dia para quem reconecta
• Boas-vindas no site da BIP
• Webhooks na Wiki da Easy Auth