Bienvenida en una llamada: del registro al primer email

EsfuerzoAPICanalEmailPlanGratis

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.

#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

1. 1Alguien crea una cuenta en tu app
2. 2Tu servidor llama a la BIP con los datos de la persona
3. 3La 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.

dash.bip.marketing/…/settings

Captura de pantalla próximamente

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

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

Captura de pantalla próximamente

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

dash.bip.marketing/…/emails-templates/…

Captura de pantalla próximamente

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

dash.bip.marketing/…/settings?tab=email-domains

Captura de pantalla próximamente

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

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

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

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

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

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#Listo para copiar

#Campaña

#Campo

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

[@primer nombre], tu cuenta de Nimbus App está lista

Tres pasos para organizar la primera semana de tu equipo.

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

Tu cuenta de Nimbus App ya está activa. Para aprovechar bien los primeros días, empieza por aquí:


Crea tu primer proyecto.
Invita a las personas con las que trabajas.
Define los plazos de la semana y sigue todo en un solo panel.

Abrir Nimbus App

https://nimbusapp.com.br/entrar

¿Tienes alguna duda? Solo responde este email: la respuesta llega directo a nuestro equipo.

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:

¿Tienes alguna duda? Escríbenos a ajuda@nimbusapp.com.br.

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

#Remitente

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

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" }]
    }
  }'

{"campaignId": "ID_DE_LA_CAMPAÑA", "leadId": "ID_DEL_CONTACTO", "mode": "immediate"}

// 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;
  }
}

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

Botón URL fijo: https://nimbusapp.com.br/entrar. Muestra de {{1}}: 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.

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

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 y Planes y límites.

#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 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
• API de la BIP: claves, contactos, eventos y disparos
• Campañas: únicas, recurrentes y por API
• Editor de email: bloques, variables y vista previa
• Dominio de envío propio
• Webhooks: lleva cada envío a tu sistema
• Bienvenida en el sitio de la BIP
• La BIP para SaaS