Bienvenida al conectarse al Wi-Fi por primera vez

EsfuerzoSin códigoCanalWhatsApp + EmailPlanLite (pago)

Quien entra a tu Wi-Fi por primera vez recibe la bienvenida en el celular mientras todavía está en el mostrador, con su nombre y la oferta de la primera visita, sin que nadie tenga que apretar un botón.

#Lo que vas a lograr

• Un mensaje de bienvenida que sale solo, en cuanto el visitante se conecta por primera vez.
• Un mensaje por persona: quien vuelve todos los días no recibe la bienvenida otra vez.
• El contacto creado o actualizado en la misma llamada, con nombre, teléfono, email y la etiqueta wifi.
• WhatsApp con plantilla aprobada o email, según lo que pida tu EasySpot.
• Cada envío rastreado en los dos lados: en las estadísticas de la campaña, en la BIP, y en los registros del webhook, en la Easy Auth.

#Cómo funciona

1. 1Crea en la BIP una campaña de Disparo por API, en modo Inmediato
2. 2Crea en la Easy Auth un webhook Al Conectar, una vez por usuario, que llama a la campaña
3. 3Cada visitante nuevo recibe la bienvenida al instante

La integración de la guía Conectar la Easy Auth a la BIP trae el contacto, pero no dispara campañas. Para responder en el momento de la conexión, conectas los dos extremos:

• en la BIP, una campaña de Disparo por API en modo Inmediato, que envía el mensaje en cuanto recibe la llamada;
• en la Easy Auth, un segundo webhook, con el tema Al Conectar, que llama a POST https://api.bip.marketing/api/campaigns/trigger con el ID de la campaña y los datos del visitante. La BIP crea o actualiza el contacto y hace el envío, todo en la misma llamada.

Dos candados garantizan un mensaje por persona:

• en la Easy Auth, Límite de llamadas por usuario en Una vez por usuario: el webhook llama a la BIP una sola vez por cada visitante;
• en la BIP, la Ventana de Reingreso del Lead desactivada, que es la opción predeterminada: cada contacto recibe la campaña una vez, para siempre.

#Paso a paso

#1. Crea la clave de API para la Easy Auth

1. En la BIP, en Ajustes, abre la pestaña Claves de API y haz clic en Añadir nueva clave de API.
2. En Nombre, escribe Easy Auth — campañas.
3. Deja Activo encendido. En Caducidad automática, deja Habilitado apagado: así el webhook no deja de funcionar en una fecha determinada.
4. En Alcances, activa Disparo de Campañas y Escritura de leads.
5. Haz clic en Guardar y copia la Clave de API. La vas a pegar en la Easy Auth en el paso 6.

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

Captura de pantalla próximamente

#2. Prepara el mensaje

Elige el canal según lo que pida tu EasySpot: teléfono para WhatsApp, email para email.

• WhatsApp: en WhatsApp, abre la pestaña Plantillas y haz clic en Crear plantilla. Arma la plantilla aurora_bienvenida_wifi con los textos de Listo para copiar, con la Categoría Marketing y el Idioma Spanish (LATAM). Haz clic en Guardar plantilla y espera el estado Aprobada.
• Email: en Plantillas de email, haz clic en Nueva plantilla y arma el email de bienvenida con los textos de Listo para copiar. Haz clic en Guardar.

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

Captura de pantalla próximamente

#3. Crea la campaña de Disparo por API

1. En Campañas, haz clic en Nueva campaña. En Nombre de la campaña, escribe Bienvenida del Wi-Fi.
2. En Tipo de Programación, elige Disparo por API y, en Modo de Disparo, Inmediato.
3. En Ventana de Reingreso del Lead, deja Permitir Reingreso del Lead desactivado. Es la opción predeterminada y es lo que quieres: cada contacto recibe la bienvenida una vez.
4. En Canal, elige WhatsApp: selecciona la Plantilla aprobada y el Número de teléfono. En Asignación de variables, haz clic en Añadir asignación de variable y vincula Cuerpo · {{1}} con first name. Para email, elige Email, completa el Nombre del remitente (Padaria Aurora) y vincula la Plantilla de email.
5. Abre Integración vía API y copia el ID de la campaña. También aparece al final de la dirección de la página.

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

Captura de pantalla próximamente

#4. Prueba y activa la campaña

1. Haz clic en Guardar → Guardar borrador.
2. Haz clic en Probar campaña, escribe tu teléfono (con + y el código de país) o tu email y haz clic en Enviar prueba. Tienes que ser un contacto de la BIP: conéctate una vez al Wi-Fi antes. La prueba no consume envíos.
3. Revisa el mensaje en el celular o en la bandeja de entrada.
4. Haz clic en Guardar → Guardar y Activar y confirma en Activar Disparo por API. El estado pasa a Activo y la campaña ya acepta llamadas.

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

Captura de pantalla próximamente

#5. Copia el cuerpo del webhook de la integración

El webhook que la BIP creó en la Easy Auth ya tiene las variables correctas para los campos de tu EasySpot. Vas a reutilizar ese texto.

1. Entra al Dashboard de la Easy Auth, en app.easyauth.net, y haz clic en Webhooks en el menú lateral.
2. En el webhook con la URL https://api.bip.marketing/api/leads, haz clic en Editar Webhook.
3. En Cuerpo, copia las líneas que están dentro de las llaves. El nombre, por ejemplo, viene como "name": "{{ field('field-name.value') }}".
4. Haz clic en Ocultar edición de Webhook, sin cambiar nada en ese webhook.

app.easyauth.net

Captura de pantalla próximamente

#6. Crea el webhook de bienvenida en la Easy Auth

1. Haz clic en Agregar Webhook → Personalizado.
2. En Nombre, escribe Bienvenida → BIP. En Tema, elige Al Conectar. En Idioma, Español.
3. En Límite de llamadas por usuario, elige Una vez por usuario.
4. En Método, deja POST. En URL, pega https://api.bip.marketing/api/campaigns/trigger.
5. Si aparece Tags de Disparo, deja todas las tags desactivadas: el webhook vale para todos los visitantes.
6. En Headers, haz clic en Añadir encabezado dos veces. Completa Clave Content-Type con Valor application/json, y Clave x-bip-api-key con la clave del paso 1.
7. En Cuerpo, borra el texto que viene por defecto y pega el cuerpo de Listo para copiar. Cambia ID_DE_LA_CAMPAÑA por el ID del paso 3 y, dentro de lead, usa las líneas que copiaste en el paso 5.

app.easyauth.net

Captura de pantalla próximamente

#7. Prueba el webhook y guarda

1. Haz clic en Probar Webhook.
2. En Cargar datos de ejemplo, escribe el teléfono o el email con el que ya entraste al Wi-Fi y haz clic en Cargar. El cuerpo aparece con tus datos en lugar de las variables.
3. Haz clic en Enviar Prueba. En Respuesta, el estado 200 y el Cuerpo de la Respuesta con "mode": "immediate" muestran que la BIP hizo el envío. El mensaje llega a tu celular o a tu email.
4. Haz clic en Cerrar. Revisa que el Estado del webhook esté activado y haz clic en Guardar, arriba de la página.

app.easyauth.net

Captura de pantalla próximamente

#Listo para copiar

#Cuerpo del webhook

Ejemplo de Padaria Aurora: el EasySpot pide el nombre, el teléfono (la clave de licencia) y el email. Cambia ID_DE_LA_CAMPAÑA por el ID de tu campaña.

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

Usa siempre las líneas del cuerpo de tu integración (paso 5): coinciden con los campos de tu EasySpot. Si la clave de tu licencia es el email, por ejemplo, la línea viene como "email": "{{ key('value') }}". Si el cuerpo de la integración trae la lista fields (fecha de nacimiento, ciudad), pega la lista completa dentro de lead para mantener esos campos al día.

#Webhook en la Easy Auth

#Campaña en la BIP

#Plantilla de WhatsApp

Botón URL: https://www.exemplo.com.br/cardapio

#Email de bienvenida

Donde aparece [@primer nombre], escribe @first, elige lead.firstName() y usa cliente como Valor de respaldo.

[@primer nombre], el primer café va por nuestra cuenta ☕

Gracias por usar el Wi-Fi de Padaria Aurora. Muestra este email en la caja.

¡Qué bueno tenerte aquí, [@primer nombre]!

Acabas de conectarte al Wi-Fi de Padaria Aurora. Estás en tu casa: el pan sale calentito del horno desde las 7 h, todos los días.

Para celebrar tu primera visita, el café de filtro va por nuestra cuenta al comprar cualquier bocado salado. Solo muestra este email en la caja, hoy.

Ver el menú

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

#Cómo medir

• En la BIP: en Campañas, abre Estadísticas de la campaña de Bienvenida del Wi-Fi. En WhatsApp, sigue Enviado, Entregado, Tasa de lectura, Tasa de respuesta y Errores. En email, Procesado (N ejecuciones), Entregado, Tasa de apertura y Tasa de clics.
• Quién la recibió: en Interacciones del destinatario, cada visitante aparece con fecha y estado. Rechazada, con el motivo El lead ya ha recibido esta campaña, es una llamada repetida que la BIP frenó.
• En la Easy Auth: en Webhooks, haz clic en Ver registros. Cada llamada a https://api.bip.marketing/api/campaigns/trigger aparece con Estado, Tema, URL y Hora. En Ver solicitud, el Cuerpo de la Solicitud muestra los datos enviados y el Cuerpo de la Respuesta, el leadId y el mode.
• Visitantes nuevos: en Estadísticas → pestaña General, la Easy Auth muestra los nuevos y los recurrentes del período. Compara los nuevos con los envíos de la campaña.
• En la caja: cuenta cuántas personas mostraron el mensaje para llevarse el café.

Si un registro muestra un error, el Cuerpo de la Respuesta dice el motivo:

#Variaciones

• Solo para quien no es suscriptor (Easy Auth PRO): en el webhook, cambia el tema por Al conectar No-ISP. Para dar una bienvenida distinta a los suscriptores, crea otra campaña y otro webhook con Al conectar ISP. Consulta Webhooks de leads y ventas.
• Bienvenida unos minutos después: en la campaña, cambia el Modo de Disparo por Retraso y completa Retraso (Segundos), por ejemplo 600. El mensaje llega diez minutos después de la conexión, con el cliente ya sentado.
• WhatsApp y email: cada campaña usa un canal. Crea una campaña por canal y, en la Easy Auth, un webhook para cada una, con el campaignId de cada campaña en el cuerpo.
• Oferta para quien regresa: con la bienvenida funcionando, sigue con Bienvenido de nuevo: la oferta del día para quien regresa.

#Preguntas frecuentes

#¿Por qué no usar el webhook que la integración ya creó?

Porque solo lleva el contacto a la BIP, en https://api.bip.marketing/api/leads, y no dispara campañas. Deja ese webhook como está, para que todos los visitantes sigan llegando a Leads, y crea el de bienvenida a su lado.

#¿El visitante recibe la bienvenida cada vez que se conecta?

No. En la Easy Auth, Una vez por usuario hace que el webhook llame a la BIP una vez por cada visitante. En la BIP, con Permitir Reingreso del Lead desactivado, cada contacto recibe la campaña una vez. Si llega una llamada repetida, aparece como Rechazada en las estadísticas y el mensaje no sale.

#¿La bienvenida consume envíos?

Cada mensaje que sale cuenta un envío del mes en BIP Lite. Crear y actualizar el contacto no cuenta, y una llamada que el reingreso frenó tampoco. Las pruebas de Probar campaña no consumen envíos; el Enviar Prueba del webhook sí, porque es un envío real.

#¿Puedo enviar por WhatsApp y por email al mismo tiempo?

Sí, con dos campañas: una de WhatsApp y otra de email, cada una con su propio webhook en la Easy Auth. WhatsApp necesita un plan de pago y el teléfono del visitante; el email funciona en cualquier plan, para quien dejó su email en el EasySpot.

#Ver también

• Conecta la Easy Auth a la BIP y recibe a los visitantes del Wi-Fi
• API de la BIP: claves, contactos, eventos y disparos
• Campañas: únicas, recurrentes y por API
• Plantillas de WhatsApp: crear, sincronizar y usar
• Editor de email: bloques, variables y vista previa
• Bienvenido de nuevo: la oferta del día para quien regresa
• Caso de bienvenida en el sitio de la BIP
• Webhooks en la Wiki de la Easy Auth