Gatilhos de autenticação corporativa
Conecte o WorkOS para disparar e-mails com a cara da sua marca quando um usuário é criado, verifica o e-mail, redefine a senha, entra em uma organização ou é provisionado pela sincronização de diretório. O Brew transforma 18 tipos de evento do WorkOS em gatilhos de automação.
O WorkOS continua responsável pelo SSO, pela sincronização de diretório, pelo login e pelas redefinições de senha. O Brew só escuta os eventos e cria e envia os e-mails que vêm depois deles.
Os eventos organization.created, organization.updated, organization.deleted e connection.activated não trazem destinatário. O Brew registra esses eventos em Eventos recentes como não resolvidos e não inicia nenhuma automação.
Para enviar um e-mail a uma pessoa sobre uma nova organização, use um evento que traga o endereço dela, como organization_membership.created ou invitation.accepted.
Eventos de participação, de autenticação e de diretório sem endereço de e-mail ainda podem seguir adiante quando o Brew já viu um e-mail real para o mesmo usuário, participação ou usuário de diretório do WorkOS, na conexão atual.
O Brew é compatível com estes 18 tipos de evento:
Cada evento verificado com um endereço de e-mail real cria ou atualiza um contato do Brew, identificado pelo e-mail, independentemente de alguma automação usar o evento. Quando o evento traz esses dados, o Brew preenche o nome, o sobrenome e os campos workos_user_id e workos_email_verified.
Os eventos de autenticação preenchem workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at ou workos_last_magic_auth_at. Os eventos de participação e de convite preenchem workos_organization_id e workos_org_role. Os eventos de diretório preenchem workos_directory_user_id e workos_directory_id.
Os eventos user.deleted e dsync.user.deleted definem workos_account_status como deleted, e o organization_membership.deleted o define como removed_from_org. O Brew não remove o contato.
Use o esquema de payload declarado do evento selecionado para as tags de mesclagem. Todos os eventos incluem email, firstName, lastName e createdAt, quando presentes. Os eventos de usuário acrescentam emailVerified, os de organização acrescentam organizationName, e os de participação e de convite acrescentam role. O campo createdAt é um timestamp Unix em segundos.
Os IDs de objetos do WorkOS não são tags de mesclagem, nem o endereço IP e o user agent dos eventos de autenticação.
Funcionários sincronizados pelo diretório geralmente não deram opt-in para marketing. Trate essas pessoas como destinatárias de avisos de conta e de e-mails transacionais, a menos que tenham dado opt-in separadamente.
Receber um evento e enviar um e-mail são etapas separadas. Confirme que uma automação correspondente está ativa, examine os filtros e o histórico de execuções dela e verifique a elegibilidade do destinatário e o domínio de envio. Eventos de organização e de conexão nunca iniciam automações, e um exemplo de teste do WorkOS reconhecido pelo Brew é registrado como evento de teste.
