Gatilhos de eventos de autenticação
Conecte o Clerk para disparar e-mails com a cara da sua marca quando alguém se cadastra, passa a fazer parte de uma organização, inicia uma assinatura do Clerk Billing ou entra na sua lista de espera. O Clerk assina cada webhook, e o Brew transforma 13 tipos de evento em gatilhos de automação.
O Clerk continua responsável pelo login, pelas organizações e pela cobrança. O Brew só escuta os eventos: ele não pode alterar usuários, criar organizações nem cobrar assinaturas.
O evento organization.created não traz nenhum endereço de e-mail. O Brew procura o ID de usuário do criador entre as identidades que já viu em eventos anteriores do Clerk, na conexão atual. Se encontrar um e-mail real, o evento segue adiante. Se não, o Brew registra o evento com um destinatário não resolvido, não cria nenhum contato e não inicia nenhuma automação.
Inscreva o endpoint também no user.created, para que o Brew conheça os endereços dos criadores. Para um e-mail que precisa chegar a uma pessoa todas as vezes, use o organizationMembership.created, que traz o endereço do membro.
O Brew é compatível com estes 13 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 o campo clerk_user_id.
O evento user.created também preenche clerk_username, clerk_image_url, clerk_signed_up_at e clerk_last_sign_in_at. Os eventos de convite e de participação preenchem clerk_organization_id, clerk_org_role e clerk_org_role_name. Os convites acrescentam clerk_org_invitation_status, e as participações acrescentam clerk_organization_name e clerk_organization_slug.
Os eventos de cobrança preenchem clerk_subscription_status e clerk_plan_name, e alguns acrescentam clerk_plan_slug, clerk_subscription_period_end ou clerk_is_trialing. O evento paymentAttempt.created preenche clerk_last_payment_attempt_status e clerk_last_payment_attempt_at. O waitlistEntry.created preenche clerk_waitlist_status.
Use o esquema de payload declarado do evento selecionado para as tags de mesclagem. Todos os eventos incluem email, firstName, lastName e createdAt. Os demais campos dependem do evento, como planName, planAmount, roleName, organizationName e grandTotalFormatted. Os campos planAmount e grandTotalAmount usam a menor unidade da moeda; em USD, por exemplo, 2000 equivale a US$ 20,00. Os timestamps usam o tempo Unix, em segundos.
Os IDs de objetos do Clerk, como os IDs de usuário, de organização e de assinatura, não são tags de mesclagem. O ID de usuário fica no contato, no campo clerk_user_id.
Uma conta no Clerk não estabelece consentimento para e-mails de marketing. Registre o consentimento no cadastro e confira-o antes de envios promocionais.
Não de forma confiável. O Brew recebe só o paymentAttempt.created, e não as atualizações posteriores da tentativa. O campo status dele pode ter o valor pending, paid ou failed, mas um pagamento que falha depois da criação da tentativa chega ao Brew como um evento não compatível. Para pagamentos em atraso, use o subscriptionItem.pastDue. Para mostrar um total no texto do e-mail, o campo grandTotalFormatted traz um valor já formatado, como $22.00.
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. Uma entrega feita com Send Example verifica o webhook, mas nunca inicia uma automação, e um evento organization.created sem um criador conhecido é registrado como não resolvido.
