As chaves SMTP permitem que você conecte seu site, aplicativo ou outra ferramenta de forma segura ao SMTP de retransmissão da Brevo, para enviar transações por e-mail diretamente dos seus próprios sistemas. 

É bom saber

• Apenas o proprietário da conta ou usuários com a permissão SMTP podem acessar a página SMTP & API, criar uma nova chave SMTP ou excluir uma chave SMTP existente. Para saber mais sobre permissões de usuário e níveis de permissão, consulte nosso artigo dedicado Adicionar usuários e atribuir permissões na Brevo.
• Sempre que uma chave SMTP for criada ou excluída da conta, o proprietário da conta receberá uma notificação por e-mail, incluindo detalhes como o endereço IP e a localização.

O que é uma chave SMTP?

Para enviar e-mails transacionais do seu site ou aplicativo, você precisa definir as configurações SMTP para apontar para Brevo SMTP, usando as seguintes credenciais:

• Login SMTP: um endereço de e-mail exclusivo que serve como seu nome de usuário.
• Chave SMTP: uma chave secreta que serve como sua senha.

Onde posso encontrar minhas chaves SMTP?

Para manter as chaves SMTP seguras, as chaves recém-criadas não ficam totalmente visíveis em sua conta Brevo. Na página SMTP e API, apenas os últimos dígitos de cada chave são exibidos para que você possa identificá-las, se necessário.

Por isso, recomendamos que você armazene sua chave SMTP em um local seguro assim que a criar. Se você perder sua chave, precisará gerar uma nova, armazená-la em local seguro e substituir a chave anterior em sua configuração.

Criar uma nova chave SMTP

Para criar uma nova chave SMTP em sua conta Brevo:

1. Clique no menu suspenso da conta e selecione Settings < SMTP & API (Configurações > SMTP e API).
2. Na aba SMTP, clique em Generate a new SMTP key (Gerar uma nova chave SMTP).
3. Insira o código de verificação de 6 dígitos enviado para o e-mail da sua conta e clique em Verify (Verificar).
   💡 É bom saber

   Se você não receber o código, poderá reenviá-lo por e-mail ou SMS após 1 minuto.
4. Insira um nome para sua chave SMTP. Inclua o nome da integração no nome da chave para identificá-la facilmente.
5. Selecione a variante da chave SMTP que deseja gerar:
   • [Recomendado] Standard (Padrão): chave SMTP segura padrão, com 64 caracteres.
   • Short (Curta): chave mais curta, com 15 caracteres.
     ❗️ Importante

     A variante de chave SMTP curta só será recomendada se o seu cliente SMTP não suportar senhas longas. Observe que alguns clientes SMTP podem truncar silenciosamente o campo de senha e falhar na autenticação sem nenhuma mensagem de erro clara. Se você se deparar com uma falha de autenticação que não consegue explicar de outra forma, tente gerar uma chave curta.
6. Defina uma data de expiração de 7 dias a 1 ano ou escolha sem expiração para a chave SMTP.
   ❗️ Importante

   Escolher No expiration (Sem expiração) significa apenas que a chave não tem uma data de expiração fixa. Isso não a isenta da política de inatividade separada da Brevo:

   • Data de vencimento atingida: você receberá um lembrete por e-mail 3 dias antes e no dia em que a chave expirar.
   • 90 dias de inatividade: mesmo sem uma data de expiração definida, a chave será desativada se nenhum e-mail tiver sido enviado com êxito em 90 dias. Você receberá um lembrete por e-mail 7 dias antes e no dia em que isso acontecer.
7. Clique em Generate (Gerar). A chave SMTP completa é exibida.
   
8. Copie a chave completa e salve-a em um local seguro, como um aplicativo gerenciador de senhas ou um sistema de armazenamento interno.
   
   💡 É bom saber

   A chave completa é exibida apenas uma vez. Certifique-se de criar uma cópia segura. Essa chave é confidencial e nunca deve ser compartilhada ou publicada online.
9. Clique em OK.
   

Você criou com êxito uma nova chave SMTP.

Desativar uma chave SMTP

Se você quiser interromper temporariamente o uso de uma chave SMTP, poderá desativá-la:

1. Clique no menu suspenso da conta e selecione Settings > SMTP & API (Configurações > SMTP e API).
2. Na guia SMTP, selecione a chave SMTP que você quer excluir.
3. Clique em Deactivate SMTP key (Desativar chave SMTP).
   
4. Clique em Deactivate (Desativar) para confirmar.

Sua chave SMTP agora está desativada.

Reativar uma chave SMTP

Para reativar uma chave SMTP previamente desativada:

1. Clique no menu suspenso da conta e selecione Settings > SMTP & API (Configurações > SMTP e API).
2. Na guia SMTP, selecione a chave SMTP que você quer reativar.
3. Clique em Activate SMTP key (Ativar chave SMTP).
   
4. Clique em Activate (Ativar) para confirmar.

Sua chave SMTP está ativa novamente.

Excluir uma chave SMTP

Se sua conta foi comprometida ou você não usa mais uma integração específica, exclua a chave SMTP dela:

1. Clique no menu suspenso da conta e selecione Settings > SMTP & API (Configurações > SMTP e API).
2. Na aba SMTP, selecione a chave SMTP que você deseja excluir.
3. Clique em Delete SMTP key (Excluir chave SMTP).
   
4. Clique em Delete (Excluir) para confirmar.

Você excluiu com êxito sua chave SMTP.

Práticas recomendadas para gerenciar chaves SMTP

Trate suas chaves SMTP com o mesmo nível de segurança que uma senha. Confira algumas práticas recomendadas:

• Use uma chave SMTP diferente para cada integração. Inclua o nome da integração no nome da chave para identificá-la facilmente. Isso facilita a revogação de uma única chave caso ela seja comprometida.
• Armazene suas chaves com segurança, não em documentos, e-mails ou notas adesivas.
• Nunca exponha sua chave SMTP publicamente. Oculte ou a recorte em capturas de tela e vídeos.
• Evite compartilhar chaves por e-mail, caso sua caixa de correio seja comprometida.
• Exclua regularmente as chaves não utilizadas para minimizar os riscos de segurança.
• Mantenha suas chaves ativas em uso enviando pelo menos um e-mail através da chave a cada 90 dias, mesmo sem data de expiração definida, para evitar uma desativação inesperada. 
• Bloqueio de endereço IP ativado para que as chamadas SMTP e API de endereços IP não reconhecidos fiquem bloqueadas até que você os autorize. Para saber mais, consulte nosso artigo dedicado Autorizar e bloquear endereços IP para segurança de API e SMTP.

Solução de problemas com suas chaves SMTP

Se você estiver com problemas com suas chaves SMTP, revise as seguintes dicas de Solução de problemas antes de entrar em contato com nossa equipo de suporte.

Minha chave SMTP mostra "Expires: never" (Expira: nunca), mas recebi um aviso de inatividade

Você selecionou nenhuma data de expiração ao criar sua chave SMTP, mas ainda recebeu um e-mail avisando que a chave será desativada por inatividade.

Causas e soluções comuns

Verifique a correção

Enviei um e-mail de teste usando a chave, depois verifique na página SMTP & API que seu status é mostrado como ativo.

Se o problema persistir, entre em contato com nossa equipe de suporte e inclua os últimos dígitos da chave e a mensagem de aviso exata que você recebeu.

Recebi um e-mail de segurança "Verificar um novo IP"

Você recebeu um e-mail da Brevo pedindo para confirmar ou negar uma chamada de SMTP ou API feita a partir de um IP de endereço não reconhecido, e não tem certeza se é legítimo ou o que fazer a seguir.

Causas e soluções comuns

Verifique a correção

Acesse a página de endereços IP autorizados e confirme se o endereço IP exibe o status esperado (autorizado ou removido).

Se você continuar recebendo alertas de IP de endereço que não reconhece após mudar sua chave SMTP , entre em contato com nossa equipe de suporte.

⏭️ O que vem a seguir?

• Autorizar e bloquear endereços IP para segurança de API e SMTP
• Minha conta foi comprometida, o que devo fazer?
• Crie e gerencie suas chaves API

🤔 Dúvidas?

Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.

Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.