Ações do construtor

Depois do gatilho, o fluxo é uma sequência de ações. Elas ficam na biblioteca que abre ao clicar no + de um nó do canvas, separadas em abas. Clicar numa ação já posicionada abre as configurações dela na lateral.

Só aparecem as ações das integrações ativadas em Joinotify → Configurações → Integrações — a de Telegram, por exemplo, só existe com a integração do Telegram ligada.

Mensagens de WhatsApp

Toda ação de WhatsApp pede o remetente (um dos números da conta) e o destinatário, que aceita um telefone ou uma variável como {{ wc_billing_phone }}.

Mensagem de modelo

A ação lista os templates aprovados da conta, com idioma, categoria e uma pré-visualização, e pede um valor para cada variável do template — texto fixo ou variável do gatilho. Desde a 2.6.0 ela cobre tudo o que a Meta oferece num template:

• Cabeçalho de imagem, vídeo ou documento — o arquivo vem de um link, de uma variável ou da biblioteca de mídia. A ação não salva sem ele, porque a Meta recusa o envio. Um documento sai com o nome do arquivo.
• Cabeçalho de localização — latitude e longitude, com nome e endereço opcionais.
• Botão de URL — a variável completa só o que vem depois do endereço fixo do botão. Para um link do próprio site, use o modificador remove_home_url ou {{ wc_first_product_review_path }} — veja Modificadores.
• Botão de copiar código de um template de marketing, preenchido com o cupom informado.
• Botão de código de um template de autenticação, que repete o código do corpo quando fica vazio.
• Oferta por tempo limitado — a expiração aceita uma data, um timestamp ou um tempo relativo como +2 days.
• Carrossel — cada cartão pede seu próprio arquivo de cabeçalho, variáveis e botões.

Os valores das variáveis saem numa linha só, como o WhatsApp exige: quebras de linha viram vírgulas e marcações HTML são removidas, para que um endereço de várias linhas ou um preço do WooCommerce não façam a Meta recusar o template.

Controle do fluxo

As esperas dependem do WP-Cron — veja Requisitos mínimos.

Condição

As condições disponíveis dependem do gatilho: status e valor do pedido, produtos comprados, forma de pagamento e de entrega, função e meta dados do usuário, campos do formulário e o que mais o gatilho registrar.

Janela de 24 horas do WhatsApp

Oferecida em todos os gatilhos desde a 2.6.0. Ela pergunta à plataforma, no momento em que o fluxo passa por ela, se a janela de um destinatário está aberta, fechada ou desconhecida (quando não foi possível perguntar). Recebe o destinatário — telefone ou variável — e o número remetente cuja janela é lida.

O uso típico é mandar texto livre no caminho "aberta" e um template aprovado no outro:

graph LR;
  A["Pedido concluído"] --> B{"Janela aberta?"};
  B -- "sim" --> C["Mensagem de texto"];
  B -- "não" --> D["Mensagem de modelo"];

Loop

Percorre uma coleção — os arquivos digitais do pedido, os itens comprados — e roda as ações do corpo uma vez por item, com as variáveis {{ loop_* }} descritas em Variáveis de texto.

Integrações com outros sistemas

As duas estão descritas em Webhooks e requisições HTTP.

Contatos

Na aba Contatos da biblioteca, desde a 2.5.0:

Elas exigem a sincronização com o Joinotify Cloud ligada e passam pela fila dela, então o fluxo nunca espera pelo Joinotify e uma falha é tentada de novo. Nenhuma das duas inicia um fluxo do Joinotify Cloud.

O contato só é o cliente ou o usuário do gatilho quando o telefone ou o e-mail digitado na ação é o dele; qualquer outro vira um lead separado. O consentimento de marketing só deve ser marcado quando o gatilho significa que a pessoa concordou — um formulário com a caixa de aceite, por exemplo —, e sai com a evidência de onde e quando.

WooCommerce

Inteligência artificial

A IA passa pelo WordPress AI Client: o provedor e as credenciais são configurados uma vez em Configurações → Conectores, no próprio WordPress, e o Joinotify usa o que estiver ali. O plugin não guarda chave de OpenAI nem de Anthropic desde a 2.3.1.

O construtor também gera um fluxo inteiro a partir de uma descrição em texto. Esse gerador nunca usa a ação Requisição HTTP.

Outros canais

Os dois exigem a integração ativada e a credencial do serviço em Configurações → Integrações.

Ações que saíram

Testar antes de ativar

O construtor envia o fluxo para um número de teste, configurado nele mesmo. Quando o WhatsApp recusa o envio, o aviso mostra o motivo que a Meta deu — janela fechada, template recusado, número inválido — em vez de um erro genérico.

A sua própria ação

Qualquer plugin pode registrar uma ação, com o formulário de configuração dela, só com PHP — veja Recursos para desenvolvedores.