Conecta-seEntrar na plataforma

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.

Gatilhos de inícioRecurso internoConexão: Depende da origem escolhida em Quando iniciar

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

  1. 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.
  2. Em Quando iniciar, escolha execução manual/API, agendamento, mensagem de canal, Gmail, Agenda Google Google Drive ou eventos da Nuvemshop.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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ção

    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:
    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ção

    De 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ção

    Em 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ção

    Define 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ção

    Escolhe 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ção

    Define 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ção

    Dia 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ção

    Define 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ção

    Define 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ção

    Use 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ção

    Somente 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ção

    Conta 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ção

    Conta 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ção

    Conta 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 adicionais

    Expõ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ênciaTipoO que contém
<inicio.recoveryId>stringIdentificador do carrinho detectado para o bloco Recuperar carrinho.
<inicio.accountId>stringLoja conectada que originou o evento.
<inicio.checkout>jsonCarrinho abandonado recebido.
<inicio.order>jsonPedido com pagamento confirmado.
<inicio.event>jsonEvento recebido.
<inicio.subject>stringAssunto do e-mail recebido no Gmail.
<inicio.message>jsonMensagem recebida.
<inicio.text>stringTexto da mensagem.
<inicio.sender>stringIdentificador do remetente.
<inicio.channelInstanceId>stringIdentificador da conexão que recebeu a mensagem; disponível para uma entrada de canal.
<inicio.conversationId>stringIdentificador da conversa que originou a execução, quando houver uma conversa associada.
<inicio.file>jsonArquivo novo do Drive.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

Inícioprocessamentoação final
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