Início
Definir a entrada do fluxo: execução manual ou API, agendamento, mensagem de canal ou evento do Gmail, Agenda Google e Google Drive.
O que faz
Inicia o fluxo por execução manual ou API, horário programado, mensagem de canal ou evento do Gmail, Agenda Google e Google Drive. A origem selecionada define quais campos configurar e quais dados chegam às próximas etapas.
Quando usar: Use quando o seu fluxo precisar definir a entrada do fluxo: execução manual ou API, agendamento, mensagem de canal ou evento do Gmail, Agenda Google e Google Drive.
Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.
O novo fluxo já começa com Início. Escolha uma única origem em Quando iniciar. Agendamentos e eventos só disparam na versão publicada; Dados para testar simula o evento no ensaio. As saídas de mensagem, remetente, conversa e arquivo dependem da origem escolhida e podem estar ausentes em outras origens.
Antes de começar
Conexão necessária: Depende da origem escolhida em Quando iniciar.
Em Quando iniciar, escolha execução manual/API, agendamento, mensagem de canal, Gmail, Agenda Google Google Drive ou eventos da Nuvemshop.
Passo a passo
- Use o bloco Início que já vem no novo fluxo. Ele é o ponto de entrada e não precisa de uma etapa anterior. Ligue sua saída à primeira ação.
- Em Quando iniciar, escolha execução manual/API, agendamento, mensagem de canal, Gmail, Agenda Google Google Drive ou eventos da Nuvemshop.
- Para execução manual/API, defina os Campos de entrada com nome e tipo. Os valores e arquivos usados em Executar teste são dados de exemplo para essa execução.
- Para agendamento, escolha a frequência, o horário e o fuso. Começar em e Encerrar em são limites opcionais; o fluxo precisa estar publicado para disparar automaticamente.
- Para mensagens, escolha WhatsApp · Z-API ou Telegram e a conexão específica da Caixa de entrada. Somente mensagens de clientes da conexão selecionada iniciam o fluxo publicado.
- Para Gmail, Agenda Google ou Drive, conecte a conta indicada. Ajuste o filtro de e-mails, a agenda (primary por padrão) ou a pasta do Drive quando necessário.
- Para Nuvemshop, selecione Carrinho abandonado ou Pagamento confirmado e escolha a loja. No abandono, configure a espera e ligue a saída ao bloco Recuperar carrinho, usando
<start.recoveryId>. Ganho no CRM exige pagamento; entrega não confirma venda. - Em origens de evento, revise Dados para testar e execute o teste. Esse JSON simula a entrada; não substitui o evento real da versão publicada. Confira no terminal os campos disponíveis antes de referenciá-los nas próximas etapas.
- Confira o resultado e publique. Alterações no rascunho só passam a valer nos disparos automáticos após uma nova publicação.
Campos
Quando iniciar
Escolhe o que inicia o fluxo: execução manual/API, horário programado, mensagem de WhatsApp ou Telegram, novo e-mail, evento da Agenda Google ou arquivo novo do Drive. Também recebe carrinho abandonado e pagamento confirmado da Nuvemshop.
- Opções:
- Execução manual ou chamada de API · Agendamento · Mensagem recebida em um canal · Novo e-mail no Gmail · Evento criado na Agenda Google · Horário de um evento da Agenda Google · Arquivo novo no Google Drive · Carrinho abandonado na Nuvemshop · Pagamento confirmado na Nuvemshop
- Padrão:
- Execução manual ou chamada de API
Frequência
Obrigatório conforme a operaçãoDefine a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento”
- Opções:
- A cada X minutos · A cada hora · Diariamente · Semanalmente · Mensalmente · Personalizado (cron)
- Padrão:
- Diariamente
- Exemplo:
- A cada X minutos
Intervalo (minutos)
Obrigatório conforme a operaçãoDe quantos em quantos minutos o fluxo deve rodar (ex.: 15 para quatro vezes por hora).
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “A cada X minutos”
- Exemplo:
- 15
Minuto
Obrigatório conforme a operaçãoEm que minuto de cada hora o fluxo roda, de 0 a 59 (ex.: 30 roda às 8h30, às 9h30 e assim por diante).
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “A cada hora”
- Exemplo:
- 30
Horário
Obrigatório conforme a operaçãoDefine a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “Diariamente”
- Exemplo:
- 09:00
Dia da semana
Obrigatório conforme a operaçãoEscolhe uma das opções aceitas por este campo.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “Semanalmente”
- Opções:
- Segunda-feira · Terça-feira · Quarta-feira · Quinta-feira · Sexta-feira · Sábado · Domingo
- Exemplo:
- Segunda-feira
Horário
Obrigatório conforme a operaçãoDefine a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “Semanalmente”
- Exemplo:
- 09:00
Dia do mês
Obrigatório conforme a operaçãoDia do mês em que o fluxo roda, de 1 a 31 (ex.: 5 para rodar todo dia 5).
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “Mensalmente”
- Exemplo:
- 5
Horário
Obrigatório conforme a operaçãoDefine a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “Mensalmente”
- Exemplo:
- 09:00
Expressão cron
Obrigatório conforme a operaçãoDefine a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento” e o campo “Frequência” for “Personalizado (cron)”
- Exemplo:
- 0 9 * * 1-5
Fuso horário
Define a data, o horário ou a programação usada pela operação.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento”
- Opções:
- UTC · EUA - Pacífico (UTC-8) · EUA - Montanha (UTC-7) · EUA - Central (UTC-6) · EUA - Leste (UTC-5) · EUA - Alasca (UTC-9) · EUA - Havaí (UTC-10) · Canadá - Toronto (UTC-5) · Canadá - Vancouver (UTC-8) · Cidade do México (UTC-6) · São Paulo (UTC-3) · Buenos Aires (UTC-3) · Londres (UTC+0) · Paris (UTC+1) · Berlim (UTC+1) · Amsterdã (UTC+1) · Madri (UTC+1) · Roma (UTC+1) · Moscou (UTC+3) · Dubai (UTC+4) · Tel Aviv (UTC+2) · Cairo (UTC+2) · Joanesburgo (UTC+2) · Índia (UTC+5:30) · Bangcoc (UTC+7) · Jacarta (UTC+7) · Singapura (UTC+8) · China (UTC+8) · Hong Kong (UTC+8) · Seul (UTC+9) · Tóquio (UTC+9) · Perth (UTC+8) · Sydney (UTC+10) · Melbourne (UTC+10) · Auckland (UTC+12)
- Padrão:
- São Paulo (UTC-3)
- Exemplo:
- UTC
Começar em (opcional)
Data e hora no fuso selecionado. Vazio: começar após publicar.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento”
- Exemplo:
- 2026-10-19T09:00
Encerrar em (opcional)
Nenhuma nova execução começa a partir deste horário. Vazio: até você desativar.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Agendamento”
- Exemplo:
- 2026-10-30T18:00
Canal
Escolhe WhatsApp via Z-API ou Telegram. Selecione depois a conexão específica que receberá as mensagens.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Mensagem recebida em um canal”
- Opções:
- WhatsApp · Z-API · Telegram · Instagram · direct
- Padrão:
- WhatsApp · Z-API
Canal conectado
Obrigatório conforme a operaçãoUse o mesmo canal da Caixa de entrada. Somente mensagens de clientes iniciam o fluxo publicado.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Mensagem recebida em um canal”
- Exemplo:
- (escolha na lista do campo)
Loja Nuvemshop
Obrigatório conforme a operaçãoSomente os novos eventos desta loja iniciam a versão publicada.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Carrinho abandonado na Nuvemshop” ou “Pagamento confirmado na Nuvemshop”
- Exemplo:
- (escolha na lista do campo)
Esperar após detectar o abandono
O relógio começa quando a Nuvemshop disponibiliza o carrinho como abandonado. Compras concluídas interrompem a recuperação.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Carrinho abandonado na Nuvemshop”
- Opções:
- 30 minutos · 1 hora · 2 horas · 24 horas
- Padrão:
- 1 hora
- Exemplo:
- 30 minutos
Conta Google
Obrigatório conforme a operaçãoConta Gmail autorizada no workspace em que serão observados novos e-mails.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Novo e-mail no Gmail”
- Exemplo:
- (escolha a conta conectada)
Conta Google
Obrigatório conforme a operaçãoConta Google autorizada que possui a agenda observada pelo fluxo.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Evento criado na Agenda Google” ou “Horário de um evento da Agenda Google”
- Exemplo:
- (escolha a conta conectada)
Conta Google
Obrigatório conforme a operaçãoConta Google autorizada em que serão observados arquivos novos.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Arquivo novo no Google Drive”
- Exemplo:
- (escolha a conta conectada)
Agenda
Agenda principal por padrão.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Evento criado na Agenda Google” ou “Horário de um evento da Agenda Google”
- Padrão:
- primary
Verificar a cada
Consulta novos eventos após a publicação, com controle de duplicidade. Não precisa configurar banco ou senha de aplicativo.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Novo e-mail no Gmail” ou “Evento criado na Agenda Google” ou “Horário de um evento da Agenda Google” ou “Arquivo novo no Google Drive”
- Opções:
- 1 minuto · 5 minutos · 15 minutos · 1 hora
- Padrão:
- 1 minuto
Filtro de e-mails
Filtro da busca Gmail aplicado aos novos e-mails, por exemplo has:attachment. Deixe vazio para não acrescentar um filtro.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Novo e-mail no Gmail”
- Exemplo:
- has:attachment
Pasta do Drive (opcional)
ID da pasta do Google Drive a observar. Vazio permite arquivos de todo o Drive da conta selecionada.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Arquivo novo no Google Drive”
- Exemplo:
- id-do-recurso
Dados para testar
Exemplo usado somente em Executar teste. Edite o JSON para simular a mensagem ou evento recebido. A versão publicada usa os dados reais da origem.
- Quando aparece:
- Quando o campo “Quando iniciar” for “Mensagem recebida em um canal” ou “Novo e-mail no Gmail” ou “Evento criado na Agenda Google” ou “Horário de um evento da Agenda Google” ou “Arquivo novo no Google Drive” ou “Carrinho abandonado na Nuvemshop” ou “Pagamento confirmado na Nuvemshop”
- Padrão:
- {"text":"Mensagem de teste","sender":"destinatario-de-teste","message":{"text":"Mensagem de teste"}}
Campos de entrada
Adicione campos personalizados além dos campos padrão input, conversationId e files.
- Quando aparece:
- Quando o campo “Quando iniciar” for diferente de “Agendamento” ou “Mensagem recebida em um canal” ou “Novo e-mail no Gmail” ou “Evento criado na Agenda Google” ou “Horário de um evento da Agenda Google” ou “Arquivo novo no Google Drive” ou “Carrinho abandonado na Nuvemshop” ou “Pagamento confirmado na Nuvemshop”
Metadados da execução
Em campos adicionaisExpõe em <start.metadata> os metadados confiáveis da execução, injetados pelo servidor (subject, workspaceId, workflowId, executionId, entre outros).
- Padrão:
- false
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <inicio.recoveryId>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<inicio.recoveryId> | string | Identificador do carrinho detectado para o bloco Recuperar carrinho. |
<inicio.accountId> | string | Loja conectada que originou o evento. |
<inicio.checkout> | json | Carrinho abandonado recebido. |
<inicio.order> | json | Pedido com pagamento confirmado. |
<inicio.event> | json | Evento recebido. |
<inicio.subject> | string | Assunto do e-mail recebido no Gmail. |
<inicio.message> | json | Mensagem recebida. |
<inicio.text> | string | Texto da mensagem. |
<inicio.sender> | string | Identificador do remetente. |
<inicio.channelInstanceId> | string | Identificador da conexão que recebeu a mensagem; disponível para uma entrada de canal. |
<inicio.conversationId> | string | Identificador da conversa que originou a execução, quando houver uma conversa associada. |
<inicio.file> | json | Arquivo novo do Drive. |
Exemplo de uso
Objetivo: Processar os dados antes de seguir para a próxima etapa.
- Quando iniciar
- Execução manual ou chamada de API
- Campos de entrada
- Nome: pedido; tipo: texto; valor de teste: PED-123
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <inicio.recoveryId>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O fluxo não inicia sozinho
- Gatilhos só disparam com a automação publicada. Confira também se o evento aconteceu na conta conectada e se os filtros do gatilho não estão excluindo o evento.
Blocos relacionados
- AgendamentoIniciar a execução automaticamente nos dias e horários programados.
- Aguardar uma pessoaPausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
- AnotaçãoAdicionar uma anotação visual ao desenho do fluxo sem executar uma ação.
- APIExpor um endpoint HTTP legado para iniciar o fluxo; em fluxos novos, prefira o bloco Início.
- AvaliadorAvaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.
- Base de conhecimentoPesquisar semanticamente nas bases de conhecimento disponíveis.