Para cada
Uma etapa que percorre uma lista. As etapas de dentro rodam uma vez para cada cobrança, sobre o seu próprio documento.
Para que serve
Uma consulta traz um total: “devem a você 125.000 em 4 documentos”. Isso basta para avisar você, mas não para escrever a cada cliente sobre a sua fatura.
Para cada percorre os documentos um por um. Cada ação de dentro atua sobre o documento do item, como se o evento tivesse sido desse documento.
Como adicionar
- Clique em Adicionar uma etapa › Para cada.
- No painel, escolha em Percorre qual lista percorrer. Se a lista tiver dias, ajuste-os.
- Ajuste Até quantos itens: de 1 a 50, e 20 se você não mudar.
- Na tela, adicione as etapas dentro do quadro Em cada item.
As listas
| Lista | O que percorre | Ordem |
|---|---|---|
| Cada cobrança vencida | Faturas e orçamentos com saldo e o prazo já vencido. | Do mais atrasado ao mais recente. |
| Cada cobrança vencida do cliente | O que o cliente do evento tem vencido. | Do mais atrasado ao mais recente. |
| Cada cobrança a vencer | O que vence nos próximos dias que você escolher (1 a 30). | Do que vence antes ao que vence depois. |
Os itens são lidos ao entrar na etapa: o que ela percorre não muda no meio, mesmo que alguém pague nesse intervalo.
Cada cobrança vencida do cliente usa o cliente do evento, então só funciona com gatilhos que trazem um: orçamentos, faturas, pagamentos e clientes. Com um gatilho programado, o workflow não pode ser publicado com essa lista.
O que cada volta lê
| Variável | O que é |
|---|---|
{{item_folio}} |
O número da fatura ou do orçamento. |
{{item_cliente}} |
O nome do cliente. |
{{item_saldo}} |
O que falta pagar, na moeda do documento. |
{{item_moneda}} |
A moeda do documento. |
{{item_vence}} |
A data de vencimento. |
{{item_dias_vencido}} |
Há quantos dias está vencido. No que ainda não venceu é zero ou um número negativo. |
{{item_origen}} |
Se é uma fatura ou um orçamento. |
Estas variáveis só existem dentro da etapa. Se você as usar fora, o workflow não é publicado e o editor avisa: “A variável {{item_folio}} é de cada item: só existe dentro de “Para cada”.”
As condições de dentro também podem lê-las, por exemplo “Dias de atraso é maior ou igual a 7”.
Sobre qual documento cada ação atua
Dentro de Para cada, Enviar um e-mail ao cliente, Enviar um WhatsApp ao cliente, Criar uma tarefa e Adicionar uma nota no HubSpot usam o documento e o cliente do item, não os do evento. Enviar os dados para uma URL envia o tipo e o id do documento do item.
O que não cabe dentro
- Esperas: cada volta roda na hora, uma após a outra. Se quiser espaçar as mensagens, programe o workflow; por exemplo, toda segunda-feira.
- Outro Para cada.
- Ações de um único tipo de documento: Marcar o orçamento como expirado, Aprovar a solicitação interna e Cancelar a fatura. Uma lista mistura faturas e orçamentos.
Se algo falhar no meio
Cada volta deixa o seu próprio registro em Execuções: “Volta 1”, “Volta 2” e assim por diante. A etapa Para cada diz quantos itens percorreu.
Se uma etapa ficar tentando de novo na volta 3, ao ser retomada ela continua nessa volta. O que já saiu nas voltas 1 e 2 não se repete, e cada cliente recebe o seu e-mail uma única vez.
Um exemplo completo
“Sua segunda: o recebido, o vencido e para quem ligar”, uma das ideias que o Cord traz, termina com um “Para cada”:
- Quando isto acontecer: toda segunda-feira às 9h, depois do resumo da semana.
- Para cada: cada cobrança vencida, até 20.
- Condição, dentro: “Dias de atraso é maior ou igual a 30” e “Dias de atraso é menor ou igual a 36”: só as que passaram dos 30 dias naquela semana.
- Ação, se for atendida: criar a tarefa “Ligar para
{{item_cliente}}sobre{{item_folio}}:{{item_saldo}}com{{item_dias_vencido}}dias de atraso”. Cada cobrança pede a sua ligação uma única vez.
Limites
| Limite | Valor |
|---|---|
| Itens por execução | De 1 a 50; 20 se você não mudar |
| Para cada dentro de outro | Não é possível |
| Esperas dentro | Não é possível |
A etapa e as de dentro contam para o máximo de 30 etapas por workflow. Os limites por hora de cada ação continuam valendo: se os e-mails ao cliente chegarem ao limite, essa etapa é tentada de novo mais tarde.