Pular para o conteúdo principal
Uma execução de workflow é a principal unidade de medida no Brain Studio. Ela é contada uma única vez, quando o workflow começa, independentemente de quanto tempo ele dure, de quantas mensagens troque com o usuário ou de terminar bem ou falhar.

​
Conceitos-chave

​
Workflows vs Tools

Workflow

Projetado para conversar com usuários. Contém nós de mensagem (texto, imagens, botões) e nós de lógica (código, API, condicionais).

Tool

Projetada para executar operações técnicas. Contém apenas nós de lógica. Não conversa, apenas processa.
Apenas os workflows somam execuções. Uma Tool nunca conta como execução: não importa se ela é usada por um workflow, por um Agente de IA ou se você a chama diretamente via API.

​
Workflow filho

Um workflow filho é um workflow que outro workflow chama. Ele inicia sua própria execução, então soma separadamente do workflow que o chamou.

​
O que conta como uma execução?

A regra é simples: cada workflow que começa = uma execução.

​
Conta como execução

  • Cada workflow que começa, por qualquer canal (WhatsApp, Instagram, web etc.), via API ou via webhook
  • Cada workflow filho que outro workflow chama
  • O workflow que falha no meio: a execução conta quando começa, não quando termina

​
Não conta como execução

  • As Tools, tanto as que um workflow ou Agente de IA usa quanto as que você chama diretamente via API
  • Os testes feitos no Tester do Brain Studio
  • As mensagens que o usuário envia enquanto o workflow está em andamento
  • O envio de um template ou campanha de WhatsApp, que é cobrado como mensagem de template
Os testes feitos enviando mensagens a um número de WhatsApp real ou ao sandbox contam como execuções, assim como o tráfego de produção.

​
Mesma execução ou execução nova

Enquanto o workflow está em andamento, tudo o que acontece dentro dele é a mesma execução, e retomá-la não é cobrado de novo:
  • Um nó Pergunta aguarda a resposta do usuário.
  • O usuário abre um link de pagamento, paga e volta à conversa.
  • Um nó falha e o workflow segue pelo seu ramo de erro.
Há uma execução nova quando outro workflow começa:
  • O usuário volta a escrever depois que o workflow terminou.
  • O usuário volta a escrever depois que a espera do workflow expirou.
  • Um workflow chama um workflow filho.

​
O que está incluído no custo?

​
Incluído em uma execução

  • Mensagens ilimitadas enquanto o workflow está em andamento
  • Todos os nós que rodam dentro do workflow
  • O uso de Tools (Workflow → Tool)

​
Cobrado separadamente

  • Tokens do modelo de IA: O processamento de linguagem natural é cobrado de acordo com o uso do modelo (GPT-4, Claude, etc.). Vale para o Agente de IA, o AI Router e as Tarefas de IA.
  • KYC: As verificações de identidade têm um custo independente por validação realizada. Além disso, o app de biometria do marketplace é construído com workflows: cada workflow que começa dentro do app soma sua própria execução.
  • Assinatura eletrônica: Cada processo de assinatura é cobrado individualmente.
  • Pagamentos: Cada transação tem sua própria tarifa e só é cobrada quando é concluída com sucesso.
  • Templates de WhatsApp: São cobrados como mensagem de template de acordo com sua categoria e o país de destino.
  • Conversas: As mensagens do canal têm cobrança própria, que não altera a contagem de execuções.
A loja (Shop) não tem cobrança própria: ver o catálogo e montar o carrinho não soma execuções nem outros custos.
A regra é a mesma para todas as empresas: o workflow principal e cada workflow filho sempre contam, e nenhuma configuração por empresa muda isso. O que muda é a forma de pagamento. Os planos self-service descontam as execuções do pacote do plano e, quando ele acaba, da carteira de créditos. Os clientes SMB e Enterprise têm um pacote mensal e pagam o que exceder esse pacote no fechamento do mês. Consulte Preços.

​
Exemplos práticos

Um usuário cumprimenta, escolhe opções em um menu com botões e faz uma pergunta. São seis mensagens, e cada resposta passa por um nó Pergunta que aguarda o usuário dentro da mesma execução.Total: 1 execução
Seu workflow “Suporte” atende o usuário → chama 3 Tools (validar usuário, consultar histórico, criar ticket) → chama o workflow filho “Pesquisa de satisfação”.Total: 2 execuções (as Tools não somam; o workflow filho sim)
Seu workflow de abertura de conta usa o app de biometria do marketplace. O app inicia seus próprios workflows, por exemplo um que valida a identidade e outro que monta o relatório.Total: 3 execuções (1 do workflow principal + 2 do app), mais a validação de identidade, que é cobrada à parte. A quantidade depende de quantos workflows o app inicia.
Você envia 1.000 templates de WhatsApp e 120 pessoas respondem com um botão que inicia seu workflow de atendimento.Total: 120 execuções. Os 1.000 templates não são execuções: são cobrados como mensagens de template.
Um usuário pede um cartão de crédito e o workflow pergunta sua renda mensal. O usuário não responde, a espera expira e, dois dias depois, ele volta a escrever.Total: 2 execuções. Se tivesse respondido antes de a espera expirar, seria 1.
O workflow consulta um pedido em uma API externa que não responde. O workflow segue pelo ramo de erro do nó e pede ao usuário que tente mais tarde.Total: 1 execução. A execução conta quando começa, então falhar não a desconta.
Um usuário entra em contato 3 vezes no mesmo dia:
  • 9h00 - Pergunta sobre o saldo
  • 14h00 - Solicita um relatório
  • 18h00 - Pede para atualizar os dados
Total: 3 execuções (cada conversa inicia um novo workflow)
Seu sistema externo chama um workflow via API cada vez que um pedido é criado, e o workflow envia ao comprador um template de confirmação. No dia são criados 50 pedidos.Total: 50 execuções, mais os 50 templates, que são cobrados à parte

​
Obtendo um ID de execução

Quando uma execução começa, o Brain Studio gera um identificador único (executionId). Esse ID se mantém durante toda a execução, inclusive quando o workflow aguarda o usuário e depois é retomado. Cada workflow filho e cada Tool têm seu próprio executionId; para agrupar uma cadeia completa, use o ID da execução raiz do relatório de execuções. Você pode acessá-lo a partir de qualquer nó usando:

​
Resumo

No Brain Studio você paga por cada workflow que começa, não por cada etapa do processo. Conversas longas, mensagens e Tools não somam execuções.
Dividir um workflow grande em vários workflows filhos organiza o projeto e facilita a manutenção, mas cada filho soma sua própria execução. Leve isso em conta ao projetar seus workflows.

​
Artigos relacionados

Como funciona o faturamento

Conceitos-chave sobre o faturamento no nível da organização no Jelou.

Preços

Detalhes de preços para conversas, campanhas e assentos do Connect.

Sua Primeira Tool

Crie sua primeira Tool do zero e publique-a para reutilizá-la em seus workflows.

Workflows com IA

Configure um Agente de IA que coleta dados dos seus usuários.

Variáveis de Contexto

Acesse o executionId e outras variáveis disponíveis durante a execução.