Acionadores do Firebase Authentication

É possível acionar o Cloud Functions em resposta à criação e exclusão de contas de usuário do Firebase por meio do Firebase Authentication. Por exemplo, é possível enviar um e-mail de boas-vindas para um usuário que acabou de criar uma conta no seu app. Os exemplos desta página são baseados em uma amostra que faz exatamente isso: envia e-mails de boas-vindas e de despedida após a criação e a exclusão da conta.

Para mais exemplos de casos de uso, veja O que posso fazer com o Cloud Functions?

Acionar uma função na criação de um usuário

Use o manipulador de eventos functions.auth.user().onCreate() para criar uma função que será acionada quando um usuário do Firebase for criado:

exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
  // ...
});

As contas do Firebase acionarão eventos de criação de usuários para o Cloud Functions quando:

  • um usuário cria uma conta de e-mail e uma senha;
  • um usuário faz login pela primeira vez com um provedor de identidade federado;
  • o desenvolvedor cria uma conta com o SDK Admin do Firebase;
  • um usuário faz login em uma sessão de autenticação anônima pela primeira vez.

Um evento Cloud Functions não é ativado quando um usuário faz login pela primeira vez usando um token personalizado.

Acessar os atributos do usuário

Use os dados do usuário que foram retornados para sua função e acesse a lista de atributos de usuário, disponível no objeto UserRecord recém-criado. Por exemplo, é possível ver o e-mail e o nome de exibição do usuário conforme mostrado abaixo:

const email = user.email; // The email of the user.
const displayName = user.displayName; // The display name of the user.

Acionar uma função na exclusão de um usuário

Além de acionar uma função na criação do usuário, você pode responder a eventos de exclusão de usuários. Use o manipulador de eventos functions.auth.user().onDelete() como mostrado a seguir:

exports.sendByeEmail = functions.auth.user().onDelete((user) => {
  // ...
});

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.