# WorkOS + Brew

Dispare automações do Brew a partir de eventos do WorkOS de usuário, autenticação, redefinição de senha, organização, sincronização de diretório (SCIM), conexão e convite.

URL canônica: https://brew.new/pt-br/browse/integrations/workos

- Direção: Entrada de dados
- Conexão: Segredo de webhook
- Gatilhos de autenticação corporativa

## Funcionalidades disponíveis

- **Gatilhos de evento**: Dispare automações do Brew a partir de eventos do WorkOS de usuário, autenticação, organização, sincronização de diretório e conexão.

## Transforme eventos do WorkOS em e-mails úteis

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.


## O que você pode criar

- E-mails de boas-vindas: o evento user.created é disparado quando um usuário do WorkOS é provisionado. O authentication.email_verification_succeeded é disparado quando o usuário verifica o e-mail. Escolha um único gatilho para evitar boas-vindas duplicadas.
- Confirmações de redefinição de senha: o evento password_reset.succeeded é disparado quando uma redefinição é concluída. Ele é um evento de nível superior do WorkOS e não faz parte de authentication.*.
- Avisos de login: o evento authentication.magic_auth_succeeded é disparado quando um login por link mágico é concluído, e o authentication.password_failed, quando um login com senha falha. Os dois vão para o usuário, e nenhum deles expõe o endereço IP ou o user agent como tag de mesclagem.
- Onboarding de equipes: os eventos organization_membership.created e invitation.accepted são disparados quando alguém entra em uma organização, e os dois trazem role. Escolha um único gatilho para evitar boas-vindas duplicadas.
- Avisos de mudança de função: o evento organization_membership.updated é disparado quando uma participação muda, como em uma nova função.
- Usuários sincronizados pelo diretório: os eventos dsync.user.created, dsync.user.updated e dsync.user.deleted mantêm os contatos do Brew em sincronia com o seu diretório SCIM.
- Avisos de offboarding: os eventos user.deleted e organization_membership.deleted são disparados quando um usuário é excluído ou sai de uma organização.

## Eventos de organização e de conexão não disparam e-mails

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.


## Configure o WorkOS no Brew

- Abra Integrações, escolha WorkOS e selecione Gerar URL do webhook.
- No painel do WorkOS, abra Webhooks, crie um endpoint e cole a URL do Brew.
- Inscreva o endpoint nos 18 eventos compatíveis: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated e invitation.accepted. Não selecione authentication.*, que adiciona eventos de autenticação não compatíveis com o Brew.
- Copie o segredo de assinatura do endpoint, cole-o no Brew e selecione Conectar. O Brew verifica cada entrega com o cabeçalho de assinatura do WorkOS e uma tolerância de 180 segundos no timestamp.
- No WorkOS, envie um evento de teste user.created a partir do endpoint. O status no Brew muda de “Aguardando evento de teste” para “Conectado”. O Brew ignora os exemplos do WorkOS que reconhece, mas pode processar um exemplo não reconhecido como se fosse um evento real; por isso, envie o teste antes de publicar uma automação nesse gatilho.
- Ao conectar, o Brew cria gatilhos para todos os 18 eventos. Não há um botão para ativar ou desativar eventos.
- Crie uma automação, selecione o evento do WorkOS dela e envie um teste enquanto ela ainda estiver como rascunho. Só automações ativas são executadas quando chega um evento correspondente.

## Eventos do WorkOS compatíveis

O Brew é compatível com estes 18 tipos de evento:

- user.created
- user.updated
- user.deleted
- authentication.email_verification_succeeded
- authentication.password_failed
- password_reset.succeeded
- authentication.magic_auth_succeeded
- organization.created
- organization.updated
- organization.deleted
- organization_membership.created
- organization_membership.updated
- organization_membership.deleted
- dsync.user.created
- dsync.user.updated
- dsync.user.deleted
- connection.activated
- invitation.accepted

## Sincronização de contatos e personalização

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.


## Por que um evento aparece sem que um e-mail seja enviado?

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.


## Limites e solução de problemas

- O Brew não pode criar nem alterar usuários, organizações, diretórios ou conexões do WorkOS.
- Um erro 401 com timestamp_invalid:out_of_tolerance significa que o timestamp da entrega estava defasado em mais de 180 segundos. Confira se há diferença de relógio e reenvie pelo painel do WorkOS.
- Se as automações de redefinição de senha nunca dispararem, confirme que o endpoint está inscrito em password_reset.succeeded. O WorkOS nunca envia authentication.password_reset_succeeded.
- Se todas as entregas falharem na verificação de assinatura, copie o segredo atual do endpoint no WorkOS e conecte de novo. O Brew exige que o segredo tenha pelo menos 16 caracteres.
- Revise o consentimento e a finalidade de cada e-mail. Sincronizar usuários do WorkOS não autoriza envios promocionais.

## Fontes e guias de configuração

- [Guia de configuração do WorkOS](https://docs.brew.new/integrations/import/workos)
- [Crie uma automação](https://docs.brew.new/create-emails/build-an-automation)
- [Tags de mesclagem](https://docs.brew.new/create-emails/merge-tags)
- [O que você pode enviar com o Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Eventos do WorkOS](https://workos.com/docs/events)

## Relacionados

- [Todas as integrações](https://brew.new/pt-br/browse/integrations.md)
- [Criar conta](https://brew.new/pt-br/sign-up.md)
- Site: https://brew.new