# Bienvenida en una llamada: del registro al primer email

> Crea una campaña de Disparo por API en modo Inmediato con el email de bienvenida. En el registro de tu app, llama a /api/campaigns/trigger con el contacto como objeto. La BIP crea o actualiza el contacto y envía al instante. Con el reingreso desactivado, cada persona recibe la bienvenida una sola vez.

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

<UseCaseMeta effort="api" channel="email" plan="free" />

Quien crea una cuenta en tu app recibe la bienvenida en el mismo instante, con su nombre, a partir de una sola llamada de tu servidor.

<Checklist items="Una cuenta en la BIP (sirve el plan gratuito)|Acceso al servidor de tu app, donde ocurre el registro|El nombre (2 caracteres o más) y el email de quien se registra|Una clave de API con Disparo de Campañas y Escritura de leads|Recomendado: un dominio de envío propio verificado (planes de pago)" />

## Lo que vas a lograr

- La bienvenida en el instante del registro, con el nombre de pila de la persona.
- Contacto creado y email enviado en la misma llamada: sin rutinas de sincronización y sin hojas de cálculo.
- Ningún contacto duplicado: quien ya estaba en la BIP tiene su perfil actualizado.
- Una sola bienvenida por persona, aunque tu sistema llame a la API dos veces.
- Etiquetas y campos del registro en el contacto, listos para segmentar después.
- El email sale con la dirección de tu marca, si usas un dominio propio.

## Cómo funciona

<Steps items="Alguien crea una cuenta en tu app|Tu servidor llama a la BIP con los datos de la persona|La BIP crea el contacto y envía la bienvenida al instante" />

La campaña usa el **Disparo por API** en modo **Inmediato**. En la práctica:

- Tu servidor llama a `/api/campaigns/trigger` con el `lead` como objeto. La BIP busca el contacto por el email o por el teléfono. Si lo encuentra, lo actualiza; si no, lo crea. Un contacto nuevo necesita un `name` con al menos 2 caracteres.
- En el modo **Inmediato**, el envío entra en la cola en cuanto la BIP recibe la llamada. La respuesta trae `"mode": "immediate"` y el `leadId` del contacto.
- Con la **Ventana de Reingreso del Lead** desactivada (el valor predeterminado), cada contacto recibe la campaña una sola vez, para siempre. Para una bienvenida, es exactamente lo que quieres: una llamada repetida aparece con el estado **Rechazada** y no cuenta como envío.
- En BIP Lite, cada email de bienvenida procesado usa un envío del mes.

## Paso a paso

### 1. Crea el campo del plan

La misma llamada que dispara la bienvenida puede guardar datos del registro. Crea antes los campos que tu app va a enviar. Las etiquetas no necesitan preparación.

1. En **Ajustes** → **General**, ve a **Campos** y haz clic en **Añadir campo**.
2. En **Tipo de campo**, elige **Cadena**. En **Nombre del campo**, escribe _Plano_ (“plan”).
3. Haz clic en **Guardar**.

<Shot src="/img/boas-vindas-em-uma-chamada/1-es-es.png" alt="Campo personalizado Plano, de tipo Cadena, en Ajustes, pestaña General" url="dash.bip.marketing/…/settings" />

### 2. Crea la clave de API

1. En **Ajustes**, abre la pestaña **Claves de API** y haz clic en **Añadir nueva clave de API**.
2. En **Nombre**, escribe _Nimbus App — registro_.
3. En **Alcances**, activa **Disparo de Campañas** y **Escritura de leads**. Juntos, permiten crear el contacto y disparar en la misma llamada.
4. Haz clic en **Guardar** y copia la **Clave de API**. Guarda la clave en el servidor, en una variable de entorno, y nunca en el código de la app.

<Shot src="/img/boas-vindas-em-uma-chamada/2-es-es.png" alt="Nueva clave de API con los alcances Disparo de Campañas y Escritura de leads activados" url="dash.bip.marketing/…/settings?tab=api-keys" />

### 3. Arma el email de bienvenida

1. En **Plantillas de email**, haz clic en **Nueva plantilla**.
2. Haz clic en **Ajustes** y completa **Nombre**, **Idioma** (**Español**), **Asunto** y **Vista previa**. Los textos están en [Listo para copiar](#listo-para-copiar).
3. Arma los bloques: logo, encabezado con el nombre de pila, texto con los primeros pasos, botón a la app y firma.
4. En el asunto y en el encabezado, escribe `@first` y elige `lead.firstName()`. Haz clic en cada variable y completa el **Valor de respaldo**.
5. Haz clic en **Vista previa** → **Enviar email de vista previa** para ver el email en tu bandeja de entrada.
6. Haz clic en **Guardar**.

<Shot src="/img/boas-vindas-em-uma-chamada/3-es-es.png" alt="Editor de email con la bienvenida de Nimbus App y el nombre de pila en el encabezado" url="dash.bip.marketing/…/emails-templates/…" />

### 4. Envía con el dominio de tu marca

Recomendado, en los planes de pago. La bienvenida es el primer email que la persona recibe de ti: un remitente como `ola@nimbusapp.com.br` se reconoce en la bandeja de entrada, y las respuestas llegan a un buzón que tu equipo lee.

1. En **Ajustes** → **Dominios de Email**, agrega `nimbusapp.com.br` y crea en el DNS los registros que muestra la BIP. El paso a paso completo está en [Dominio de envío propio](/es-es/dominio-de-envio).
2. Con el estado **Verificado**, ve a **Ajustes** → **General** y completa **Email De (Nombre)** y **Email De (Dirección)**.
3. Haz clic en **Guardar**.

En el plan gratuito, omite este paso: los emails salen de `no-reply@bip.marketing`, con el nombre que defines en **Email De (Nombre)**.

<Shot src="/img/boas-vindas-em-uma-chamada/4-es-es.png" alt="Dominio nimbusapp.com.br con el estado Verificado en Dominios de Email" url="dash.bip.marketing/…/settings?tab=email-domains" />

### 5. Crea la campaña de bienvenida

1. En **Campañas**, haz clic en **Nueva campaña**.
2. En **Nombre de la campaña**, escribe _Bienvenida — Nimbus App_ y elige el emoji 👋.
3. En **Tipo de Programación**, elige **Disparo por API** y, en **Modo de Disparo**, **Inmediato**.
4. Deja **Permitir Reingreso del Lead** desactivado: cada persona recibe la bienvenida una vez.
5. En **Canal**, elige **Email**. En **Nombre del remitente**, escribe _Sofia, de Nimbus App_. En **Email de envío**, quédate con **Predeterminado de la cuenta** o elige tu dominio y escribe `ola`.
6. En **Plantilla de email**, vincula la plantilla del paso 3.

<Shot src="/img/boas-vindas-em-uma-chamada/5-es-es.png" alt="Campaña con Disparo por API en modo Inmediato y el canal Email con remitente y plantilla" url="dash.bip.marketing/…/campaigns/…" />

### 6. Prueba y activa

1. Haz clic en **Guardar** → **Guardar borrador**.
2. Haz clic en **Probar campaña**, escribe tu email y haz clic en **Enviar prueba**. Si todavía no eres contacto, créate antes en **Leads** → **Crear lead**.
3. Revisa el remitente, el asunto y tu nombre en el email. La prueba no consume envíos.
4. Haz clic en **Guardar** → **Guardar y Activar** y confirma en **Activar Disparo por API**. La campaña pasa al estado **Activo** y empieza a aceptar llamadas.

<Shot src="/img/boas-vindas-em-uma-chamada/6-es-es.png" alt="Ventana Probar campaña con el email del contacto y el botón Enviar prueba" url="dash.bip.marketing/…/campaigns/…" />

### 7. Conecta el registro de la app a la BIP

1. En la campaña, abre **Integración vía API**. Los comandos ya traen el ID de la campaña, que también está al final de la dirección de la página.
2. En tu servidor, justo después de crear la cuenta del usuario, llama a `/api/campaigns/trigger` con el `lead` como objeto: `name`, `email`, las `tags` y los `fields` del registro.
3. Guarda el `leadId` de la respuesta junto con el usuario. Sirve para registrar eventos de ese contacto después.
4. No dejes que una falla en la llamada bloquee el registro: registra el error y sigue adelante.

Si tu formulario de registro no pide el nombre, empieza a pedirlo. La BIP necesita un nombre con al menos 2 caracteres para crear el contacto. El teléfono, si lo envías, siempre con `+` y código de país.

<Shot src="/img/boas-vindas-em-uma-chamada/7-es-es.png" alt="Panel Integración vía API con los comandos de disparo de la campaña de bienvenida" url="dash.bip.marketing/…/campaigns/…" />

## Listo para copiar

### Campaña

| Opción | Valor |
| --- | --- |
| **Nombre de la campaña** | 👋 Bienvenida — Nimbus App |
| **Tipo de Programación** | **Disparo por API** |
| **Modo de Disparo** | **Inmediato** |
| **Ventana de Reingreso del Lead** | **Permitir Reingreso del Lead** desactivado |
| **Canal** | **Email** |
| **Nombre del remitente** | Sofia, de Nimbus App |
| **Email de envío** | `ola@nimbusapp.com.br` (o **Predeterminado de la cuenta**) |
| **Plantilla de email** | Bienvenida · Nimbus App |

### Campo

| **Nombre del campo** | **Tipo de campo** | Valor de ejemplo |
| --- | --- | --- |
| Plano | **Cadena** | Trial |

### Email

Donde aparece `[@primer nombre]`, escribe `@first`, elige `lead.firstName()` y usa el **Valor de respaldo** de la tabla al final de esta sección.

<Copy label="Asunto">
[@primer nombre], tu cuenta de Nimbus App está lista
</Copy>

<Copy label="Vista previa">
Tres pasos para organizar la primera semana de tu equipo.
</Copy>

| Orden | Bloque | Ajuste sugerido |
| --- | --- | --- |
| 1 | **Añadir imagen** | Logo de Nimbus App, **Ancho máximo (px)** 160, centrado |
| 2 | **Añadir encabezado** | Saludo con el nombre de pila |
| 3 | **Añadir texto** | Los tres primeros pasos |
| 4 | **Añadir botón** | Una sola acción, con **Ancho** de 50 |
| 5 | **Añadir texto** | Invitación a responder |
| 6 | **Agregar Firma** | **Simple** |

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

<Copy label="Texto">
Tu cuenta de Nimbus App ya está activa. Para aprovechar bien los primeros días, empieza por aquí:

1. Crea tu primer proyecto.
2. Invita a las personas con las que trabajas.
3. Define los plazos de la semana y sigue todo en un solo panel.
</Copy>

<Copy label="Botón — Nombre">
Abrir Nimbus App
</Copy>

<Copy label="Botón — URL del enlace" code>
https://nimbusapp.com.br/entrar
</Copy>

<Copy label="Texto final">
¿Tienes alguna duda? Solo responde este email: la respuesta llega directo a nuestro equipo.
</Copy>

El texto final funciona con el dominio propio, en el que las respuestas llegan al buzón de envío. En el plan gratuito, cámbialo por:

<Copy label="Texto final (plan gratuito)">
¿Tienes alguna duda? Escríbenos a ajuda@nimbusapp.com.br.
</Copy>

| Campo de la **Firma** | Valor |
| --- | --- |
| **Predefinido** | **Simple** |
| **Nombre** | Sofia Costa |
| **Título** | Éxito del Cliente |
| **Empresa** | Nimbus App |
| **Sitio Web** | nimbusapp.com.br |

| Variable | Dónde | **Valor de respaldo** |
| --- | --- | --- |
| `lead.firstName()` | **Asunto** | Hola |
| `lead.firstName()` | Encabezado | Hola |

Todo contacto creado por la API tiene nombre, así que el respaldo casi nunca aparece.

### Remitente

| Dónde | Campo | Valor |
| --- | --- | --- |
| **Ajustes** → **General** | **Email De (Nombre)** | Nimbus App |
| **Ajustes** → **General** | **Email De (Dirección)** | `ola@nimbusapp.com.br` |
| Campaña | **Nombre del remitente** | Sofia, de Nimbus App |

### API

Reemplaza `TU_CLAVE_DE_API` por tu clave e `ID_DE_LA_CAMPAÑA` por el ID del panel **Integración vía API**.

<Copy label="curl" code>
curl -X POST https://api.bip.marketing/api/campaigns/trigger \
  -H "Content-Type: application/json" \
  -H "x-bip-api-key: TU_CLAVE_DE_API" \
  -d '{
    "campaignId": "ID_DE_LA_CAMPAÑA",
    "lead": {
      "name": "Tiago Pereira",
      "email": "tiago.pereira@exemplo.com",
      "tags": ["trial"],
      "fields": [{ "key": "Plano", "value": "Trial" }]
    }
  }'
</Copy>

<Copy label="Respuesta" code>
{"campaignId": "ID_DE_LA_CAMPAÑA", "leadId": "ID_DEL_CONTACTO", "mode": "immediate"}
</Copy>

<Copy label="TypeScript" code>
// En el servidor de Nimbus App
const API_KEY = process.env.BIP_API_KEY ?? 'TU_CLAVE_DE_API';
const CAMPANHA_BOAS_VINDAS = 'ID_DE_LA_CAMPAÑA';

type NovoUsuario = { nome: string; email: string; telefone?: string; plano: string };
type RespostaDisparo = { campaignId: string; leadId: string; mode: 'immediate' | 'delay' };

export async function darBoasVindas(usuario: NovoUsuario): Promise<RespostaDisparo> {
  const res = await fetch('https://api.bip.marketing/api/campaigns/trigger', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-bip-api-key': API_KEY },
    body: JSON.stringify({
      campaignId: CAMPANHA_BOAS_VINDAS,
      lead: {
        name: usuario.nome, // 2 caracteres o más
        email: usuario.email,
        ...(usuario.telefone ? { phone: usuario.telefone } : {}), // con + y código de país
        tags: ['trial'],
        fields: [{ key: 'Plano', value: usuario.plano }]
      }
    })
  });
  if (!res.ok) throw new Error(`BIP ${res.status}: ${await res.text()}`);
  return res.json();
}

// Justo después de crear la cuenta: el registro termina aunque la BIP no responda
export async function aoCriarConta(usuario: NovoUsuario) {
  try {
    const { leadId } = await darBoasVindas(usuario);
    // guarda el leadId junto con el usuario para registrar eventos después
    return leadId;
  } catch (erro) {
    console.error('Boas-vindas não disparadas', erro);
    return null;
  }
}
</Copy>

## Cómo medir

En **Campañas**, abre **Estadísticas de la campaña** (con el ícono de gráfico en la lista o en la parte superior de la campaña).

- **Procesado (_N_ ejecuciones)**: cuántas bienvenidas procesó la BIP. Compáralo con el número de registros de tu app en el mismo período.
- **Entregado**, **Tasa de apertura** y **Tasa de clics**: cuántos emails llegaron, se abrieron y generaron un clic.
- **Enlaces más clicados**: cuántas personas abrieron la app desde el botón.
- **Interacciones del destinatario**: filtra por **Rechazada** para ver las llamadas repetidas, con el motivo **El lead ya ha recibido esta campaña**. Filtra por **Error** para ver los emails que no se pudieron enviar.

Para contar cuántos contactos llegaron por la integración, crea un segmento con **Primera / Última fuente** → **Primera fuente (Tipo)** → API. Suma **Fecha de creación** para ver solo los registros de un período.

## Variaciones

### WhatsApp en lugar del email

En los planes de pago, con un número conectado, crea la campaña con el **Canal** **WhatsApp** y envía el `phone` en el `lead`, con `+` y código de país. La respuesta de la persona llega a la app WhatsApp Business.

<WaTemplate name="nimbus_boas_vindas" category="MARKETING" footer="Nimbus App · nimbusapp.com.br" buttons="Abrir Nimbus App">
¡Hola, {{1}}! Tu cuenta de Nimbus App está lista. Empieza creando tu primer proyecto e invita a las personas con las que trabajas. ¿Tienes dudas? Solo responde este mensaje.
</WaTemplate>

Botón **URL** fijo: `https://nimbusapp.com.br/entrar`. Muestra de `{{1}}`: Tiago.

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

### Avisa al equipo en el mismo envío

Las campañas de email aceptan hasta 3 webhooks. Crea el webhook en el menú **Webhooks** y vincúlalo en la sección **Webhooks** de la campaña: los datos del nuevo registro van a tu CRM o al canal del equipo en el mismo envío de la bienvenida. El webhook enviado junto con el email no cuenta como envío extra. Consulta [Webhooks](/es-es/webhooks).

### Sin integración: bienvenidas diarias

Sin acceso al servidor de la app, usa una campaña **Recurrente** con **Frecuencia** **Diario** y el reingreso desactivado, vinculada a un segmento como este:

| Criterio | Operador | Valor |
| --- | --- | --- |
| Fecha de creación | Después o igual a | Relativo: `-1` Días, **Inicio del día** |

Cada contacto nuevo recibe la bienvenida una vez, en la primera ejecución después de su llegada. Mantén la ventana corta: en BIP Lite, cada ejecución de una campaña **Recurrente** descuenta de la capacidad el conteo completo del segmento, incluso a quien ya la recibió. Consulta [Campañas](/es-es/campanas) y [Planes y límites](/es-es/planes-y-limites).

<PlanOnly plan="full">
En BIP Full, un flujo con el disparador **Lead creado** continúa la conversación después de la bienvenida: un nodo **Temporizador** espera algunos días y un nodo **Enviar email** envía el siguiente consejo.
</PlanOnly>

## Preguntas frecuentes

### ¿El contacto se duplica si la persona ya estaba en la BIP?

No. La BIP reconoce a la persona por el email o por el teléfono y actualiza el mismo perfil: el nombre pasa a ser el del registro, las etiquetas nuevas se suman y los campos enviados se actualizan.

### Si mi sistema llama dos veces, ¿la persona recibe dos emails?

No, con la **Ventana de Reingreso del Lead** desactivada. La segunda llamada aparece con el estado **Rechazada** en las estadísticas, con el motivo **El lead ya ha recibido esta campaña**, y no cuenta como envío.

### ¿Necesito un dominio propio?

No. En el plan gratuito, las bienvenidas salen de `no-reply@bip.marketing`, con el nombre que defines en **Email De (Nombre)**. En los planes de pago, el [dominio de envío propio](/es-es/dominio-de-envio) pone la dirección de tu marca en el remitente y hace que las respuestas te lleguen a ti.

### ¿Puedo llamar a la API directo desde la app o el navegador?

No. La clave quedaría visible para cualquier persona. Llama a la API desde tu servidor, justo después de crear la cuenta.

## Ver también

- [Recupera carritos abandonados por email o WhatsApp](/es-es/carrito-abandonado)
- [API de la BIP: claves, contactos, eventos y disparos](/es-es/api)
- [Campañas: únicas, recurrentes y por API](/es-es/campanas)
- [Editor de email: bloques, variables y vista previa](/es-es/editor-de-email)
- [Dominio de envío propio](/es-es/dominio-de-envio)
- [Webhooks: lleva cada envío a tu sistema](/es-es/webhooks)
- [Bienvenida en el sitio de la BIP](https://bip.marketing/es-es/use-cases/welcome)
- [La BIP para SaaS](https://bip.marketing/es-es/solutions/saas)