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

EsforçoSem códigoCanalWhatsAppPlanoLite (pago)

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.

#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

1. 1Crie na BIP a campanha da oferta, com reentrada de 7 dias
2. 2Crie na Easy Auth um webhook Ao Conectar, a partir da segunda conexão
3. 3Quem 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:

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

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

Captura de tela em breve

#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, com Tiago como exemplo da variável.
4. Clique em Salvar Template e espere o status Aprovado.

dash.bip.marketing/easyauth-…/whatsapp/templates/create

Captura de tela em breve

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

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

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

Captura de tela em breve

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

app.easyauth.net

Captura de tela em breve

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

app.easyauth.net

Captura de tela em breve

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

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

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

#Campanha na BIP

#Template de WhatsApp

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

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

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

#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
• Faz 30 dias que você não aparece: visitantes sumidos do Wi-Fi
• Conectar a Easy Auth à BIP e receber os visitantes do Wi-Fi
• Campanhas: única, recorrente e por API
• API da BIP: chaves, contatos, eventos e disparos
• Templates de WhatsApp: criar, sincronizar e usar
• Webhooks na Wiki da Easy Auth