Gatilhos
Todo fluxo começa por um gatilho: o evento do site que faz o fluxo rodar. Você escolhe o gatilho ao criar o fluxo, em Joinotify → Adicionar novo fluxo, e ele decide quais variáveis de texto e quais condições ficam disponíveis no resto do fluxo.
Um gatilho só aparece quando a integração dele está ativada em Joinotify → Configurações → Integrações. Alguns têm opções próprias, que aparecem ao clicar no nó do gatilho no canvas — por exemplo, limitar o fluxo a um status de pedido ou a um único produto digital.
O identificador entre parênteses é o gancho do WordPress por trás do gatilho. É o que aparece no
hook do payload e o que as extensões usam; os parâmetros que cada um entrega estão em
Recursos para desenvolvedores.
WooCommerce
Pedidos
| Gatilho | Quando dispara |
|---|---|
Novo pedido (woocommerce_new_order) | Um pedido é criado, com qualquer status |
Pagamento confirmado (woocommerce_payment_complete) | Uma vez por pedido, quando o gateway confirma o pagamento ou o pedido sai de um status não pago para "processando" ou "concluído" |
Pedido concluído (woocommerce_order_status_completed) | O status muda para "concluído" |
Status de um pedido alterado (woocommerce_order_status_changed) | Qualquer mudança de status — ou só a do status escolhido nas opções do gatilho |
Pedido totalmente reembolsado (woocommerce_order_fully_refunded) | O pedido é reembolsado por inteiro |
Pedido parcialmente reembolsado (woocommerce_order_partially_refunded) | Parte do pedido é reembolsada |
"Novo pedido (Processando)" virou "Pagamento confirmado" na 2.7.0
O gatilho antigo rodava toda vez que o pedido entrava em "processando" — inclusive quando alguém o devolvia para esse status à mão — e não rodava para pedidos que iam direto para "concluído", como os de produtos virtuais. O novo roda uma vez por pedido, no momento em que o pagamento é confirmado. Fluxos salvos, arquivos importados e modelos passam para o novo gatilho sozinhos na atualização; nada precisa ser refeito.
Produtos digitais
| Gatilho | Quando dispara |
|---|---|
Acesso ao produto digital concedido (woocommerce_grant_product_download_permissions) | O WooCommerce libera o download para o cliente |
Arquivo digital baixado (woocommerce_download_product) | O cliente baixa de fato um arquivo do pedido |
Os dois podem ser limitados a um único produto digital nas opções do gatilho.
Entrega de produto digital
Para entregar os arquivos por WhatsApp, use Acesso ao produto digital concedido. Os links de download só existem a partir desse momento — em gatilhos anteriores as variáveis de download vêm vazias. Para mandar um arquivo por mensagem, combine com a ação Loop.
Clientes
| Gatilho | Quando dispara |
|---|---|
Conta de cliente criada (woocommerce_created_customer) | O WooCommerce cria uma conta de cliente |
A conta pode nascer na página Minha conta, no checkout (clássico ou em blocos) ou na
página de confirmação do pedido, e o gatilho pode ser limitado a um desses lugares. Ele roda
no fim da requisição, porque o checkout só grava o telefone de faturamento depois que o
WooCommerce avisa que a conta existe — assim {{ wc_customer_phone }} já vem preenchido.
Nesse gatilho ficam disponíveis as condições Função do usuário e Meta dados do usuário. O gatilho Novo registro de usuário do WordPress continua rodando para essas mesmas contas; use um ou outro para não mandar duas boas-vindas.
Estoque
| Gatilho | Quando dispara |
|---|---|
Produto com estoque baixo (woocommerce_low_stock) | Uma venda leva o produto ao limite de estoque baixo configurado no WooCommerce |
Produto esgotado (woocommerce_no_stock) | Uma venda zera o estoque do produto |
Produto de volta ao estoque (woocommerce_product_back_in_stock) | Um produto sem estoque ou em encomenda volta a ter estoque — uma vez por retorno |
Aviso de reposição enviado (woocommerce_customer_stock_notification) | Uma vez para cada cliente que o WooCommerce avisa que o produto voltou |
Os dois primeiros disparam no mesmo momento em que o WooCommerce manda os e-mails de estoque, e servem para avisar a equipe. Produto de volta ao estoque roda uma vez só quando uma variação e o produto variável voltam juntos.
Aviso de reposição enviado é o que fala com o cliente: ele acompanha as notificações de volta ao estoque do próprio WooCommerce, com o e-mail dela ligado ou desligado. Um cliente que se inscreveu sem estar logado é encontrado pela conta registrada com o mesmo e-mail, quando existe.
As variáveis de pedido não existem nesses gatilhos
Conta criada e estoque não têm pedido. Desde a 2.7.0 as variáveis de pedido nem são oferecidas neles — use as de cliente e de produto, descritas em Variáveis de texto.
WooCommerce Subscriptions
| Gatilho | Quando dispara |
|---|---|
Nova assinatura criada (woocommerce_checkout_subscription_created) | Uma assinatura nasce no checkout |
Assinatura é ativada (woocommerce_subscription_status_active) | A assinatura passa a "ativa" |
Pagamento da renovação recebido (woocommerce_subscription_payment_complete) | Uma renovação é paga |
Pagamento da renovação falhou (woocommerce_subscription_payment_failed) | Uma renovação falha |
Renovação da assinatura expirou (woocommerce_subscription_status_expired) | A assinatura chega ao fim |
Assinatura cancelada (woocommerce_subscription_status_cancelled) | A assinatura é cancelada |
WordPress
| Gatilho | Quando dispara |
|---|---|
Novo registro de usuário (user_register) | Um usuário se registra |
Login do usuário (wp_login) | Um usuário faz login |
Solicitação de redefinição de senha (retrieve_password) | O usuário pede o link de redefinição |
Recuperação de senha do usuário (password_reset) | O usuário conclui a redefinição |
Post tem status alterado (transition_post_status) | Um post muda de status |
Formulários
| Gatilho | Integração |
|---|---|
Formulário enviado (elementor_pro/forms/new_record) | Elementor |
Formulário enviado (wpforms_process_complete) | WPForms |
Pagamento processado pelo PayPal (wpforms_paypal_standard_process_complete) | WPForms |
Os campos do formulário chegam pela variável {{ field_id=[ID_DO_CAMPO] }} — veja
Variáveis de texto.
Flexify Checkout
| Gatilho | Quando dispara |
|---|---|
| Captura de leads via modal | O visitante deixa o contato no modal de captura |
| Captura de leads via checkout | O visitante deixa o contato no checkout |
| Carrinho abandonado | O carrinho é dado como abandonado |
| Carrinho abandonado é recuperado | O cliente volta e conclui a compra |
| Pedido abandonado | Um pedido é dado como abandonado |
| Carrinho perdido | O carrinho é dado como perdido |
Os ganchos ficam em Flexify_Checkout/Recovery_Carts/* e o tempo de cada etapa é configurado no
próprio Flexify Checkout.
Um gatilho que não está aqui
Qualquer plugin pode registrar um gatilho próprio, com a integração e as variáveis dele, só com PHP — veja Recursos para desenvolvedores.