Boas-vindas em uma chamada: do cadastro ao primeiro e-mail

EsforçoAPICanalE-mailPlanoGrátis

Quem cria a conta no seu app recebe as boas-vindas no mesmo instante, com o próprio nome, a partir de uma única chamada do seu servidor.

#O que você vai conseguir

• Boas-vindas no instante do cadastro, com o primeiro nome da pessoa.
• Contato criado e e-mail enviado na mesma chamada: sem rotina de sincronização e sem planilha.
• Nenhum contato duplicado: quem já estava na BIP tem o perfil atualizado.
• Boas-vindas uma vez só por pessoa, mesmo que o seu sistema chame a API duas vezes.
• Tags e campos do cadastro no contato, prontos para segmentar depois.
• O e-mail saindo com o endereço da sua marca, se você usar domínio próprio.

#Como funciona

1. 1Alguém cria a conta no seu app
2. 2Seu servidor chama a BIP com os dados da pessoa
3. 3A BIP cria o contato e envia as boas-vindas na hora

A campanha usa o Disparo por API no modo Imediato. Na prática:

• Seu servidor chama /api/campaigns/trigger com o lead como objeto. A BIP procura o contato pelo e-mail ou pelo telefone. Se encontra, atualiza; se não encontra, cria. Contato novo precisa de name com pelo menos 2 caracteres.
• No modo Imediato, o envio entra na fila assim que a BIP recebe a chamada. A resposta traz "mode": "immediate" e o leadId do contato.
• Com a Janela de Reentrada do Lead desligada (o padrão), cada contato recebe a campanha uma vez só, para sempre. Para boas-vindas, é exatamente o que você quer: uma chamada repetida aparece como Rejeitado e não conta como envio.
• No BIP Lite, cada e-mail de boas-vindas processado usa um envio do mês.

#Passo a passo

#1. Crie o campo do plano

A mesma chamada que dispara as boas-vindas pode guardar dados do cadastro. Crie antes os campos que o seu app vai mandar. Tags não precisam de preparo.

1. Em Configurações → Geral, vá até Campos e clique em Adicionar Campo.
2. Em Tipo de Campo, escolha String. Em Nome do Campo, digite Plano.
3. Clique em Salvar.

dash.bip.marketing/…/settings

Captura de tela em breve

#2. Crie a chave de API

1. Em Configurações, abra a aba Chaves de API e clique em Adicionar Nova Chave de API.
2. Em Nome, digite Nimbus App — cadastro.
3. Em Escopos, ligue Disparo de Campanhas e Escrita de Contatos. Os dois juntos permitem criar o contato e disparar na mesma chamada.
4. Clique em Salvar e copie a Chave de API. Guarde a chave no servidor, numa variável de ambiente, e nunca no código do app.

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

Captura de tela em breve

#3. Monte o e-mail de boas-vindas

1. Em Modelos de Email, clique em Novo Modelo.
2. Clique em Configurações e preencha Nome, Idioma (Português), Assunto e Pré-visualização. Os textos estão em Pronto para copiar.
3. Monte os blocos: logo, cabeçalho com o primeiro nome, texto com os primeiros passos, botão para o app e assinatura.
4. No assunto e no cabeçalho, digite @first e escolha lead.firstName(). Clique em cada etiqueta e preencha o Valor de Fallback.
5. Clique em Pré-visualização → Enviar Email de Prévia para ver o e-mail na sua caixa de entrada.
6. Clique em Salvar.

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

Captura de tela em breve

#4. Envie com o domínio da sua marca

Recomendado, nos planos pagos. As boas-vindas são o primeiro e-mail que a pessoa recebe de você: um remetente como ola@nimbusapp.com.br é reconhecido na caixa de entrada, e as respostas chegam a uma caixa que o seu time lê.

1. Em Configurações → Domínios de Email, adicione nimbusapp.com.br e crie no DNS os registros que a BIP mostra. O passo a passo completo está em Domínio de envio próprio.
2. Com o status Verificado, vá a Configurações → Geral e preencha Email De (Nome) e Email De (Endereço).
3. Clique em Salvar.

No plano gratuito, pule este passo: os e-mails saem de no-reply@bip.marketing, com o nome que você define em Email De (Nome).

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

Captura de tela em breve

#5. Crie a campanha de boas-vindas

1. Em Campanhas, clique em Nova Campanha.
2. Em Nome da Campanha, digite Boas-vindas — Nimbus App e escolha o emoji 👋.
3. Em Tipo de Agendamento, escolha Disparo por API e, em Modo de Disparo, Imediato.
4. Deixe Permitir Reentrada do Lead desligado: cada pessoa recebe as boas-vindas uma vez.
5. Em Canal, escolha Email. Em Nome do remetente, digite Sofia, do Nimbus App. Em Email de envio, fique com Padrão da Conta ou escolha o seu domínio e digite ola.
6. Em Modelo de E-mail, ligue o modelo do passo 3.

dash.bip.marketing/…/campaigns/…

Captura de tela em breve

#6. Teste e ative

1. Clique em Salvar → Salvar Rascunho.
2. Clique em Testar Campanha, digite o seu e-mail e clique em Enviar Teste. Se você ainda não é contato, crie-se antes em Contatos → Criar Contato.
3. Confira o remetente, o assunto e o seu nome no e-mail. O teste não consome envios.
4. Clique em Salvar → Salvar e Ativar e confirme em Ativar Disparo por API. A campanha passa ao status Ativo e começa a aceitar chamadas.

dash.bip.marketing/…/campaigns/…

Captura de tela em breve

#7. Ligue o cadastro do app à BIP

1. Na campanha, abra Integração via API. Os comandos já vêm com o ID da campanha, que também está no fim do endereço da página.
2. No seu servidor, logo depois de criar a conta do usuário, chame /api/campaigns/trigger com o lead como objeto: name, email, as tags e os fields do cadastro.
3. Guarde o leadId da resposta junto do usuário. Ele serve para registrar eventos desse contato depois.
4. Não deixe uma falha na chamada travar o cadastro: registre o erro e siga em frente.

Se o seu formulário de cadastro não pede o nome, passe a pedir. A BIP precisa de um nome com pelo menos 2 caracteres para criar o contato. Telefone, se mandar, sempre com + e código do país.

dash.bip.marketing/…/campaigns/…

Captura de tela em breve

#Pronto para copiar

#Campanha

#Campo

#E-mail

Onde aparece [@primeiro nome], digite @first, escolha lead.firstName() e use o Valor de Fallback da tabela do fim desta seção.

[@primeiro nome], sua conta no Nimbus App está pronta

Três passos para organizar a primeira semana do seu time.

Que bom ter você aqui, [@primeiro nome]!

Sua conta no Nimbus App já está ativa. Para aproveitar bem os primeiros dias, comece por aqui:


Crie o seu primeiro projeto.
Convide quem trabalha com você.
Defina os prazos da semana e acompanhe tudo num painel só.

Abrir o Nimbus App

https://nimbusapp.com.br/entrar

Ficou com alguma dúvida? É só responder este e-mail: a resposta chega direto ao nosso time.

O texto final funciona com o domínio próprio, em que as respostas chegam à caixa de envio. No plano gratuito, troque por:

Ficou com alguma dúvida? Escreva para ajuda@nimbusapp.com.br.

Todo contato criado pela API tem nome, então o fallback raramente aparece.

#Remetente

#API

Troque SUA_CHAVE_DE_API pela sua chave e ID_DA_CAMPANHA pelo ID do painel Integração via API.

curl -X POST https://api.bip.marketing/api/campaigns/trigger \
  -H "Content-Type: application/json" \
  -H "x-bip-api-key: SUA_CHAVE_DE_API" \
  -d '{
    "campaignId": "ID_DA_CAMPANHA",
    "lead": {
      "name": "Tiago Pereira",
      "email": "tiago.pereira@exemplo.com",
      "tags": ["trial"],
      "fields": [{ "key": "Plano", "value": "Trial" }]
    }
  }'

{"campaignId": "ID_DA_CAMPANHA", "leadId": "ID_DO_CONTATO", "mode": "immediate"}

// No servidor do Nimbus App
const API_KEY = process.env.BIP_API_KEY ?? 'SUA_CHAVE_DE_API';
const CAMPANHA_BOAS_VINDAS = 'ID_DA_CAMPANHA';

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 ou mais
        email: usuario.email,
        ...(usuario.telefone ? { phone: usuario.telefone } : {}), // com + e código do 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();
}
// Logo depois de criar a conta: o cadastro termina mesmo se a BIP não responder
export async function aoCriarConta(usuario: NovoUsuario) {
  try {
    const { leadId } = await darBoasVindas(usuario);
    // guarde o leadId junto do usuário para registrar eventos depois
    return leadId;
  } catch (erro) {
    console.error('Boas-vindas não disparadas', erro);
    return null;
  }
}

#Como medir

Em Campanhas, abra Estatísticas da Campanha (pelo ícone de gráfico na lista ou no topo da campanha).

• Processado (N execuções): quantas boas-vindas a BIP processou. Compare com o número de cadastros do seu app no mesmo período.
• Entregue, Taxa de Abertura e Taxa de Cliques: quantos e-mails chegaram, foram abertos e levaram a um clique.
• Links mais clicados: quantas pessoas abriram o app pelo botão.
• Interações do Destinatário: filtre por Rejeitado para ver as chamadas repetidas, com o motivo O lead já recebeu esta campanha. Filtre por Erro para ver os e-mails que não puderam ser enviados.

Para contar quantos contatos chegaram pela integração, crie um segmento com Primeira / Última Origem → Primeira Origem (Tipo) → API. Junte Data de Criação para ver só os cadastros de um período.

#Variações

#WhatsApp no lugar do e-mail

Nos planos pagos, com um número conectado, crie a campanha com o Canal WhatsApp e mande o phone no lead, com + e código do país. A resposta da pessoa chega no app WhatsApp Business.

Botão URL fixo: https://nimbusapp.com.br/entrar. Amostra de {{1}}: Tiago.

#Avise o time no mesmo envio

Campanhas de e-mail aceitam até 3 webhooks. Crie o webhook no menu Webhooks e ligue-o na seção Webhooks da campanha: os dados do novo cadastro vão para o seu CRM ou para o canal do time no mesmo envio das boas-vindas. O webhook enviado junto com o e-mail não conta como envio extra. Veja Webhooks.

#Sem integração: boas-vindas diárias

Sem acesso ao servidor do app, use uma campanha Recorrente com Frequência Diário e a reentrada desligada, ligada a um segmento como este:

Cada contato novo recebe as boas-vindas uma vez, na primeira execução depois da chegada. Mantenha a janela curta: no BIP Lite, cada execução de uma campanha Recorrente desconta da capacidade a contagem inteira do segmento, inclusive de quem já recebeu. Veja Campanhas e Planos e limites.

#Perguntas frequentes

#O contato fica duplicado se a pessoa já estava na BIP?

Não. A BIP reconhece a pessoa pelo e-mail ou pelo telefone e atualiza o mesmo perfil: o nome passa a ser o do cadastro, as tags novas são somadas e os campos enviados são atualizados.

#Se o meu sistema chamar duas vezes, a pessoa recebe dois e-mails?

Não, com a Janela de Reentrada do Lead desligada. A segunda chamada aparece como Rejeitado nas estatísticas, com o motivo O lead já recebeu esta campanha, e não conta como envio.

#Preciso de domínio próprio?

Não. No plano gratuito, as boas-vindas saem de no-reply@bip.marketing, com o nome que você define em Email De (Nome). Nos planos pagos, o domínio de envio próprio põe o endereço da sua marca no remetente e faz as respostas chegarem até você.

#Posso chamar a API direto do app ou do navegador?

Não. A chave ficaria visível para qualquer pessoa. Chame a API do seu servidor, logo depois de criar a conta.

#Veja também

• Recupere carrinhos abandonados por e-mail ou WhatsApp
• API da BIP: chaves, contatos, eventos e disparos
• Campanhas: única, recorrente e por API
• Editor de e-mail: blocos, variáveis e preview
• Domínio de envio próprio
• Webhooks: leve cada envio para o seu sistema
• Boas-vindas no site da BIP
• BIP para SaaS