Passar para o conteúdo principal

Configurando Emails Whitelabel com SendGrid

Use seus próprios templates de email personalizados integrando o SendGrid com Awaz para comunicação com a sua marca.

Atualizado há mais de 2 semanas

Visão Geral

Você pode personalizar totalmente os e-mails automáticos enviados pela sua plataforma Whitelabel integrando sua conta SendGrid. Isso faz com que todos os e-mails gerados pelo sistema — como redefinição de senha, convites e verificação de e-mail — reflitam a identidade da sua marca.

Ao final deste guia, você saberá como:

✔ Conectar sua própria conta SendGrid
✔ Criar e ativar templates personalizados para cada e-mail do sistema
✔ Atribuir cada template ao respectivo gatilho na plataforma
✔ Usar variáveis dinâmicas para personalização


Guia Passo a Passo

Passo 1 – Crie ou Faça Login na Sua Conta SendGrid

  • Acesse sendgrid.com e faça login ou crie uma conta.

  • Complete as etapas de verificação do domínio e remetente, se solicitado.
    Isso garante que seus e-mails sejam autenticados e menos propensos a cair na caixa de spam.


Passo 2 – Autenticar seu domínio

(Obrigatório para Entregabilidade)

Antes que sua plataforma possa enviar e-mails de forma confiável em seu nome, é necessário verificar o domínio de envio através do SendGrid. Essa etapa é fundamental para garantir a entrega bem-sucedida das mensagens.

Siga os passos abaixo:

  1. No painel do SendGrid, vá em Settings > Sender Authentication

  2. Clique em Get Started na seção Domain Authentication

  3. Selecione seu provedor de DNS (ex.: GoDaddy, Cloudflare, Namecheap, etc.)

  4. Insira o domínio de envio (ex.: suaempresa.com)

  5. O SendGrid irá gerar diversos registros CNAME e TXT

➡️ Copie cada registro incluindo:

  • Tipo (CNAME ou TXT)

  • Host

  • Valor

Acesse o gerenciador de DNS do seu provedor de domínio e crie um novo registro DNS para cada item fornecido.

Após adicionar todos os registros, volte ao SendGrid e clique em Verify

✅ Quando a verificação for concluída, você verá um check verde ao lado do seu domínio, confirmando que ele foi autenticado com sucesso.

📌 Importante:
A autenticação de domínio é obrigatória para que seus e-mails sejam aceitos pela maioria das caixas de entrada. Sem ela, seus templates personalizados podem falhar no envio ou cair na pasta de spam.

Além disso, certifique-se de que as configurações de Domain Authentication e de Single Sender Verification estejam alinhadas e utilizem o mesmo domínio.

Se houver uma inconsistência entre os dois (por exemplo, autenticar suaempresa.com mas usar [email protected] como remetente), seus e-mails podem falhar no envio.

Para evitar problemas: autentique o mesmo domínio que será usado como remetente dos e-mails.


Passo 3 – Crie Sua API Key no SendGrid

  1. No menu à esquerda, vá em Settings > API Keys.

  2. Clique em Create API Key.

  3. Nomeie sua chave (ex.: "Whitelabel Platform").

  4. Selecione Full Access.

  5. Clique em Create & View e copie sua API key.


Passo 4 – Cole a API Key na Sua Plataforma

  1. No dashboard Whitelabel, acesse Settings > Integrations > SendGrid.

  2. Cole sua API Key no campo API KEY.

  3. Preencha From Name e From Email.

  4. Ative a chave ligando o botão Enable.


Passo 5 – Visualize Todos os Templates Necessários

No painel de integração, há um dropdown chamado Template.
São os e-mails gerados pelo sistema que exigem um template dinâmico exclusivo:

  • 📧 Instruções de Verificação de E-mail

  • ✅ E-mail Verificado

  • 💳 Carteira Recarregada

  • 👥 Convite para Entrar na Equipe

  • 🔐 Esqueci Minha Senha

  • 🔓 Senha Recuperada

💡 Nota: Você precisará criar um template dinâmico no SendGrid para cada um desses.


Passo 6 – Crie Seus Templates Dinâmicos no SendGrid

  • No SendGrid, vá em Email API > Dynamic Templates.

  • Clique em Create a Dynamic Template e dê um nome apropriado (ex.: "Instruções de Verificação de E-mail").

  • Após criar, clique no template e depois em Add Version.

  • Escolha começar do zero ou selecione um layout pré-projetado para personalizar.


Passo 7 – Personalize o Template

No editor, atualize o assunto, preheader e o corpo completo do e-mail.
Adicione sua marca, logo, mensagens e estilo de layout. Use as variáveis dinâmicas abaixo para que nomes, links e outros conteúdos sejam inseridos automaticamente pelo sistema.

Use as variáveis conforme o e-mail do sistema:

📧 Instruções de Verificação de E-mail

  • {{logoImage}} – Logo da sua empresa

  • {{name}} – Nome do destinatário

  • {{url}} – Link para verificação do e-mail

E-mail Verificado

  • {{name}} – Nome do destinatário

💳 Carteira Recarregada

  • {{value}} – Valor adicionado à carteira

  • {{url}} – Link para página de cobrança

👥 Convite para Entrar na Equipe

  • {{company_name}} – Nome da sua empresa

  • {{url}} – Link do convite

🔐 Esqueci Minha Senha

  • {{name}} – Nome do usuário

  • {{url}} – Link para redefinição de senha

🔓 Senha Recuperada

  • {{name}} – Nome do usuário

💡 Dica: Para tornar links dinâmicos, insira {{url}} dentro de botões ou tags de âncora (ex.: “Verificar E-mail” ou “Redefinir Senha”) durante o design do template. Isso garante que cada usuário receba um link único e funcional.


Passo 8 – Ative o Template e Obtenha Seu ID

  • Quando seu design estiver pronto, clique em Save.

  • Na lista de templates, entre no template criado e ative a versão atual.

  • Localize e copie o Template ID.


Passo 9 – Cole o Template ID na Plataforma

  • Na sua plataforma, selecione o e-mail do sistema correspondente no dropdown Template.

  • Cole o Template ID correto no campo Template ID.

  • Clique em Save Updates.

🚨 Repita este processo para os 6 e-mails do sistema.

💡 Dica: Certifique-se de que o botão de integração esteja ativado (ON).


Checklist Final

✅ Conta SendGrid criada e verificada
✅ API Key criada e adicionada na plataforma
✅ 6 templates dinâmicos criados no SendGrid
✅ Cada template possui uma versão com design e variáveis personalizadas
✅ IDs dos templates colados nos campos corretos na plataforma
✅ Chave de integração ativada (ON)


Precisa de ajuda?

Temos muitos recursos para te apoiar!

📺 Vídeos Tutoriais: Assista a guias passo a passo
🔑 Login / Cadastro: Acesse o Awaz.ai
📖 Central de Ajuda: Visite nossa base de conhecimento
📧 E-mail de Suporte: [email protected]

👩‍💻 Ainda tem dúvidas? Nossa equipe de suporte está pronta para ajudar você!

Respondeu à sua pergunta?