
Acionar e-mails

Made by Firebase
Cria e envia um e-mail com base no conteúdo de um documento gravado em uma coleção especificada do Cloud Firestore.
Como esta extensão funciona
Use essa extensão para gerar e enviar e-mails que contenham as informações dos documentos adicionados a uma coleção especificada do Cloud Firestore.
Ao adicionar um documento, você aciona essa extensão para enviar um e-mail criado a partir dos campos do documento. Os campos de nível superior do documento especificam o remetente e os destinatários do e-mail, incluindo as opções to
, cc
, e bcc
(todas compatíveis com UIDs). O campo message
do documento especifica os outros elementos do e-mail, como o assunto e o corpo, em texto simples ou HTML
Veja um exemplo básico de gravação de documento que aciona essa extensão:
admin.firestore().collection('mail').add({ to: 'someone@example.com', message: { subject: 'Hello from Firebase!', html: 'This is an <code>HTML</code> email body.', }, })
Se quiser, também é possível configurar a extensão para gerar e-mails por meio de modelos do Handlebar (em inglês). Cada modelo é um documento armazenado em uma coleção do Cloud Firestore.
Ao configurar a extensão, você precisará informar suas credenciais SMTP para o envio de e-mails. Essa extensão é destinada para uso com provedores de serviços de e-mails em massa, como o SendGrid, Mailgun etc.
Outras configurações
Antes de instalar a extensão, verifique se você configurou um banco de dados do Cloud Firestore no projeto do Firebase.
Faturamento
Para instalar uma extensão, seu projeto precisa estar no plano Blaze, com pagamento por utilização
- Um pequeno valor será cobrado de você (geralmente cerca de US$ 0,01/mês) referente aos recursos do Firebase exigidos pela extensão, mesmo se não forem usados.
- Esta extensão usa outros serviços do Firebase e do Google Cloud Platform, que têm cobranças associadas caso o nível sem custos seja excedido:
- Cloud Firestore
- Cloud Functions (ambiente de execução Node.js 10+. Consulte as perguntas frequentes)
Para usar essa extensão, você também precisa ter credenciais SMTP para envio de e-mails. Os custos associados ao uso desse serviço são de sua responsabilidade.
Como instalar a extensão
Como usar o Console do Firebase
Para instalar e gerenciar extensões, use o Console do Firebase.
Instalar usando o consoleComo usar a Firebase CLI
Para instalar e gerenciar extensões, também é possível usar a Firebase CLI:
Etapa 1: execute o comando npm (em inglês) a seguir para instalar a CLI ou atualizá-la para a versão mais recente.
npm install -g firebase-toolsNão está funcionando? Consulte a referência da Firebase CLI ou altere suas permissões do npm (em inglês).
Etapa 2: configurar um novo diretório do projeto no Firebase ou acessar um já configurado
Etapa 3: adicionar esta extensão ao seu manifesto de extensões ao ser executada
firebase ext:install firebase/firestore-send-email --local --project=projectId_or_alias
Etapa 4 (opcional): testar a extensão localmente usando o Pacote de emuladores do Firebase
firebase emulators:start
Etapa 5: implantar as extensões do seu manifesto ao projeto
firebase deploy --only extensions --project=projectId_or_alias