# Bienvenida al conectarse al Wi-Fi por primera vez

> En la BIP, crea una campaña de Disparo por API en modo Inmediato, con el reingreso desactivado. En la Easy Auth, crea un webhook Al Conectar, limitado a Una vez por usuario, que llama a /api/campaigns/trigger con los datos del visitante. Cada persona recibe la bienvenida una vez, en su primera conexión.

Fonte: https://wiki.bip.marketing/es-es/wifi-bienvenida · Atualizado: 2026-10-08

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

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.

<Checklist items="La Easy Auth conectada a la BIP (consulta la guía Conectar la Easy Auth a la BIP)|Un EasySpot que pida el teléfono (para WhatsApp) o el email (para email) del visitante|Para WhatsApp: plan de pago de la BIP, número conectado y una plantilla de Marketing aprobada|Para email: una plantilla de email lista (el plan gratuito ya envía email)|Acceso de administrador en la BIP, para crear la clave de API, y acceso a Webhooks en el Dashboard de la Easy Auth" />

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

<Steps items="Crea en la BIP una campaña de Disparo por API, en modo Inmediato|Crea en la Easy Auth un webhook Al Conectar, una vez por usuario, que llama a la campaña|Cada visitante nuevo recibe la bienvenida al instante" />

La integración de la guía [Conectar la Easy Auth a la BIP](/es-es/wifi-conectar-easy-auth) 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.

<Callout type="tip">
La clave que creó la integración, **EasyAuth API Key**, solo tiene **Escritura de leads**. Para disparar campañas, crea una clave nueva con **Disparo de Campañas** y **Escritura de leads**, y deja la de la integración como está.
</Callout>

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

<Shot src="/img/wifi-boas-vindas/1-es-es.png" alt="Clave de API Easy Auth — campañas con los alcances Disparo de Campañas y Escritura de leads" url="dash.bip.marketing/easyauth-…/settings?tab=api-keys" />

### 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](#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](#listo-para-copiar). Haz clic en **Guardar**.

<Shot src="/img/wifi-boas-vindas/2-es-es.png" alt="Plantilla aurora_bienvenida_wifi aprobada en la pestaña Plantillas de WhatsApp" url="dash.bip.marketing/easyauth-…/whatsapp?tab=templates" />

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

<Shot src="/img/wifi-boas-vindas/3-es-es.png" alt="Campaña Bienvenida del Wi-Fi con Disparo por API en modo Inmediato y la plantilla de WhatsApp asignada" url="dash.bip.marketing/easyauth-…/campaigns/…" />

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

<Shot src="/img/wifi-boas-vindas/4-es-es.png" alt="Ventana de confirmación Activar Disparo por API de la campaña de bienvenida" url="dash.bip.marketing/easyauth-…/campaigns/…" />

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

<Shot src="/img/wifi-boas-vindas/5-es-es.png" alt="Cuerpo del webhook de la integración con las variables de la Easy Auth para nombre, teléfono y email" url="app.easyauth.net" />

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

<Shot src="/img/wifi-boas-vindas/6-es-es.png" alt="Webhook Bienvenida → BIP con el tema Al Conectar, Una vez por usuario y la URL del trigger de la BIP" url="app.easyauth.net" />

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

<Callout type="warning">
El **Enviar Prueba** del webhook es un envío real: el mensaje sale y cuenta un envío. Con el reingreso desactivado, tu contacto no vuelve a recibir esta bienvenida. Para repetir la prueba, usa los datos de otra persona del equipo.
</Callout>

<Shot src="/img/wifi-boas-vindas/7-es-es.png" alt="Prueba del webhook con la respuesta 200 de la BIP y el modo immediate" url="app.easyauth.net" />

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

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

| Línea        | Qué envía                                                                        |
| ------------ | -------------------------------------------------------------------------------- |
| `campaignId` | El ID de la campaña de bienvenida, del panel **Integración vía API**             |
| `name`       | El nombre que el visitante escribió en el EasySpot                               |
| `phone`      | El teléfono de la clave de licencia, con `+` y el código de país, listo para WhatsApp |
| `email`      | El email del campo **Email** del EasySpot                                        |
| `tags`       | La etiqueta `wifi`, para separar a los visitantes del Wi-Fi en los segmentos     |

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

| Campo                              | Valor                                                                              |
| ---------------------------------- | ---------------------------------------------------------------------------------- |
| **Nombre**                         | Bienvenida → BIP                                                                   |
| **Tema**                           | **Al Conectar**                                                                    |
| **Idioma**                         | **Español**                                                                        |
| **Límite de llamadas por usuario** | **Una vez por usuario**                                                            |
| **Método**                         | **POST**                                                                           |
| **URL**                            | `https://api.bip.marketing/api/campaigns/trigger`                                  |
| **Tags de Disparo**                | Todas desactivadas                                                                 |
| **Headers**                        | `Content-Type`: `application/json` · `x-bip-api-key`: la clave con los dos alcances |

### Campaña en la BIP

| Opción                            | Valor                                                                         |
| --------------------------------- | ----------------------------------------------------------------------------- |
| **Tipo de Programación**          | **Disparo por API**                                                           |
| **Modo de Disparo**               | **Inmediato**                                                                 |
| **Ventana de Reingreso del Lead** | **Permitir Reingreso del Lead** desactivado                                   |
| **Canal**                         | **WhatsApp** con la plantilla de abajo, o **Email** con la plantilla de email de abajo |

### Plantilla de WhatsApp

<WaTemplate name="aurora_bienvenida_wifi" category="MARKETING" header="Te damos la bienvenida a Padaria Aurora" footer="Padaria Aurora · Oferta válida hoy, en el mostrador" buttons="Ver el menú">
¡Hola, {{1}}! Qué bueno tenerte en Padaria Aurora. En tu primera visita, el café de filtro va por nuestra cuenta al comprar cualquier bocado salado. Solo muestra este mensaje en la caja. ¡Buen provecho!
</WaTemplate>

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

| Variable en la campaña | Campo del lead | Valor de ejemplo |
| ---------------------- | -------------- | ---------------- |
| **Cuerpo · {{1}}**     | **first name** | Marina           |

### Email de bienvenida

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

<Copy label="Asunto">
[@primer nombre], el primer café va por nuestra cuenta ☕
</Copy>

<Copy label="Vista previa">
Gracias por usar el Wi-Fi de Padaria Aurora. Muestra este email en la caja.
</Copy>

<Copy label="Encabezado">
¡Qué bueno tenerte aquí, [@primer nombre]!
</Copy>

<Copy label="Texto">
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.
</Copy>

<Copy label="Botón — Nombre">
Ver el menú
</Copy>

<Copy label="Botón — URL del enlace">
https://www.exemplo.com.br/cardapio
</Copy>

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

| Estado | Mensaje                                          | Qué hacer                                                                    |
| ------ | ------------------------------------------------ | ---------------------------------------------------------------------------- |
| 400    | `Campaign is not active`                         | Activa la campaña con **Guardar y Activar**                                  |
| 400    | `Validation Error`                               | Revisa el cuerpo: nombre con 2 caracteres o más y teléfono o email válido    |
| 403    | `API key does not have the required permissions` | Activa **Disparo de Campañas** y **Escritura de leads** en la clave          |
| 404    | `Campaign not found`                             | Revisa el `campaignId` del cuerpo                                            |

## 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](https://wiki.easyauth.com.br/es/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](/es-es/wifi-bienvenido-de-nuevo).

## 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](/es-es/wifi-conectar-easy-auth)
- [API de la BIP: claves, contactos, eventos y disparos](/es-es/api)
- [Campañas: únicas, recurrentes y por API](/es-es/campanas)
- [Plantillas de WhatsApp: crear, sincronizar y usar](/es-es/plantillas-whatsapp)
- [Editor de email: bloques, variables y vista previa](/es-es/editor-de-email)
- [Bienvenido de nuevo: la oferta del día para quien regresa](/es-es/wifi-bienvenido-de-nuevo)
- [Caso de bienvenida en el sitio de la BIP](https://bip.marketing/es-es/use-cases/welcome)
- [Webhooks en la Wiki de la Easy Auth](https://wiki.easyauth.com.br/es/webhooks)