Novo
🔥 Seja o primeiro a experimentar a API de chamadas do WhatsApp Business (Beta aberto)!
arrow-icon
All Collections >
Produto >
Workflows >
Gatilhos de fluxo de trabalho

Gatilhos de fluxo de trabalho

Avatar
Joshua Lim
· 30 Jun 2025
10 minutos de leitura

Gatilho de fluxo de trabalho

Um gatilho é um evento que iniciará um fluxo de trabalho. Cada fluxo de trabalho deve começar com um gatilho e pode ter apenas um gatilho. Todos os gatilhos são definidos por condições. Um gatilho só disparará e iniciará um fluxo de trabalho quando todas as condições forem atendidas.

Comece a criar seu fluxo de trabalho selecionando o gatilho e configurando-o adequadamente.

Aqui está a lista de gatilhos disponíveis:

Gatilho

Descrição

Conversa aberta

Acionado quando uma conversa com o contato é aberta.

Conversa encerrada

Acionado quando uma conversa com o contato é encerrada.

Tag de contacto atualizado

Acionado quando uma tag especificada é adicionada ou removida do contato.

Campo de contacto atualizado

Acionado quando o campo de contato especificado é atualizado ou editado.

Atalho

Acionado quando o atalho é selecionado no módulo Caixa de entrada.

Webhook de entrada

Acionado quando um aplicativo ou serviço externo envia uma solicitação HTTP POST.

Anúncios de clique para conversar

Acionado quando um anúncio é clicado ou uma mensagem relacionada ao anúncio é recebida.

Gatilho manual

Gatilhos para um contato quando o gatilho Outra etapa do fluxo de trabalho é executada e vinculada a um fluxo de trabalho com este gatilho.

Anúncios de mensagens do TikTok

É acionado quando um anúncio do TikTok é clicado ou uma mensagem relacionada ao anúncio do TikTok é recebida.

Ciclo de vida atualizado

Acionadores para um contato quando seu estágio do ciclo de vida é atualizado.

Após o disparo ser especificado, vá para a configuração do passo . Escolha qualquer uma das etapas disponíveis.

Configurações avançadas

Cada configuração de gatilho tem um botão de alternância de Configurações avançadas na parte inferior que especifica o gatilho uma vez por contato (exceto para o gatilho manual). Isso impede que os Contatos repitam esse Fluxo de Trabalho, de modo que eles só podem passar pela jornada do Fluxo de Trabalho uma única vez.

Quando a alternância estiver LIGADA, o fluxo de trabalho não será acionado para nenhum contato que tenha se inscrito neste fluxo de trabalho antes, mesmo que a condição tenha sido definida como DESLIGADA quando isso aconteceu.

Configuração do gatilho

Cada fluxo de trabalho deve começar com um gatilho e só pode ter um único gatilho. Quando as condições de acionamento forem atendidas, o fluxo de trabalho será executado sequencialmente no contato de acionamento.

Gatilho: Conversa Aberta

Inicia o fluxo de trabalho quando uma conversa com o contato é aberta e todas as condições de acionamento são atendidas.

Configuração

A condição de acionamento para este fluxo de trabalho é limitada à origem, que identifica como a conversa foi aberta. Quando nenhuma condição for adicionada, o fluxo de trabalho será acionado sempre que uma conversa for aberta, independentemente da origem.

As fontes são as seguintes:

Fonte

Descrição

Usuário

A conversa é aberta pelo usuário (conversas de saída). Casos de uso comuns: Atualizações de novos recursos Mensagens de acompanhamento

Fluxo de trabalho

A conversa é aberta por uma etapa do fluxo de trabalho.

Contato

A conversa é aberta pelo Contato (conversas de entrada). Casos de uso comuns: Roteamento de contato Atribuição de contato

API

A conversa é aberta pela API do desenvolvedor.

Zapier

A conversa é aberta por um Zap.

Fazer

A conversa é aberta por Make.

Anúncios de clique para conversar

A conversa é aberta clicando em um anúncio.

Para cada Fonte, são permitidas no máximo 10 condições com operadores lógicos AND ou OR. Cada condição precisa ter sua própria fonte, um operador e um valor.

Variáveis de gatilho

Todas as variáveis de gatilho para o gatilho Conversa aberta refletem informações relacionadas à conversa, como a primeira mensagem recebida da conversa. Saiba mais sobre as variáveis de gatilho para o gatilho Conversa aberta aqui.

Gatilho: Conversa encerrada

Adicionar condições ao gatilho de fechamento da conversa é opcional. Se nenhuma condição for adicionada, o fluxo de trabalho será acionado sempre que uma conversa for fechada, independentemente da origem.

Inicia o fluxo de trabalho quando uma conversa com o contato é encerrada e todas as condições de acionamento são atendidas.

Configuração

Existem duas condições de ativação possíveis para as Conversas Encerradas: Origem, que identifica quem encerrou a conversa, e Categoria, que identifica a classificação da conversa.

As seguintes fontes acionarão este fluxo de trabalho se fecharem uma conversa:

Fonte

Descrição

Usuário

A conversa é encerrada pelo Usuário.

Fluxo de trabalho

A conversa é encerrada por uma etapa do fluxo de trabalho.

Robô

A conversa é fechada pelo bot.

API

A conversa é encerrada pela API do desenvolvedor.

Zapier

A conversa é encerrada com um Zap.

Fazer

A conversa é encerrada por Make.

A conversa encerrada pela fusão de contatos NÃO acionará um fluxo de trabalho.

Este fluxo de trabalho também será acionado se conversas relacionadas a categorias especificadas forem fechadas. Essas categorias são determinadas na seção Notas de Encerramento da plataforma. Nos fluxos de trabalho, eles aparecerão como opções no menu suspenso de valores.

Para cada Fonte e Categoria, são permitidas no máximo 10 condições com operadores lógicos AND ou OR. Cada condição precisa ter sua própria fonte, um operador e um valor.

Variáveis de gatilho

Todas as variáveis de gatilho para o gatilho Conversa encerrada refletem informações relacionadas à conversa, como tempo de resolução da conversa, tempo da primeira resposta e o resumo de encerramento da conversa. Saiba mais sobre as variáveis de gatilho para o gatilho Conversa Fechada aqui.

Gatilho: Tag de contato atualizada

Inicia o fluxo de trabalho quando tags especificadas são adicionadas ou removidas de um contato.

Configuração

Para configurar este fluxo de trabalho, selecione uma ação que atuará como um gatilho. As opções são quando uma Tag é adicionada a um Contato ou quando uma Tag é removida do Contato.

Em seguida, selecione a(s) etiqueta(s) que serão as condições a serem atendidas para a inicialização do fluxo de trabalho.

Importar contatos com tags ou campos personalizados não aciona automaticamente os Workflows. Para ativar os fluxos de trabalho após a importação, é necessária uma ação secundária. Para obter mais informações sobre como iniciar fluxos de trabalho pós-importação, consulte nossa API de desenvolvedor ou ferramentas de integração como Make/Zapier.

Gatilho: Campo de contato atualizado

Inicia o fluxo de trabalho quando um campo de contato especificado é atualizado.

Configuração

Qualquer contato ou campo personalizado pode ser configurado como um gatilho para este fluxo de trabalho. Selecione o Campo de Contato que atuará como condição para este Gatilho. Qualquer atualização neste campo iniciará o fluxo de trabalho.

Importar contatos com tags ou campos personalizados não aciona automaticamente os Workflows. Para ativar os fluxos de trabalho após a importação, é necessária uma ação secundária. Para obter mais informações sobre como iniciar fluxos de trabalho pós-importação, consulte nossa API de desenvolvedor ou ferramentas de integração como Make/Zapier.

Gatilho: Atalho

Inicia um fluxo de trabalho selecionado no menu de atalho no módulo Caixa de entrada .

Como funciona

Atalho se refere a um fluxo de trabalho que é criado com o gatilho 'Atalho'. Esta funcionalidade permite aos utilizadores iniciar fluxos de trabalho que tenham o atalho como gatilho sem sair do módulo Caixa de entrada .

No módulo Caixa de entrada , clique no ícone de atalho na barra de ferramentas do compositor de mensagens. Isso abrirá o menu Atalhos, que mostra todos os Atalhos publicados no Espaço de Trabalho. Selecione o atalho desejado para iniciar seu fluxo de trabalho.

O ícone de atalho será desabilitado se não houver atalhos criados e publicados no espaço de trabalho.

Se não pretender permitir que os Agentes iniciem Atalhos, desative-o nas definições de Restrições Avançadas em Definições do Utilizador do Espaço de Trabalho​.

Configuração

Você pode configurar atalhos com ícones, nomes e descrições individuais. Quando o menu Atalhos for aberto, eles serão exibidos para permitir que você identifique e selecione facilmente o atalho desejado.

Formulário de atalho

Na gaveta de configuração do gatilho de atalho, você pode optar por criar um formulário de atalho. Sempre que o atalho for acionado, o formulário será aberto. O Workflow somente será iniciado após o preenchimento do formulário pelo Usuário.

O formulário de atalho pode ser personalizado com campos de formulário para inserir dados ou comentários. Os valores preenchidos podem ser salvos como variáveis e usados no fluxo de trabalho.

Para adicionar um campo de formulário:

  1. Clique no botão + Adicionar campo de formulário .

  2. Nomeie o campo do formulário. Por exemplo, ID do pedido, motivo do reembolso.

  3. Selecione o tipo de campo. Os tipos de campo disponíveis são:

  • Texto

  • Lista (suspensa)

  • Caixa de seleção

  • Número

  • Data

  • Hora

  • Número de telefone

  • E-mail

  • URL

4. Nomeie a variável para este campo.

5. Use as variáveis de saída nas etapas do fluxo de trabalho. Saiba mais sobre as variáveis de saída aqui.

6. Defina o campo do formulário conforme necessário, alternando a opção Obrigatório para LIGADO. Isso torna obrigatório que os Agentes preencham os dados ou comentários.

Gatilho: Webhook de entrada

Inicia o fluxo de trabalho quando um evento específico ocorre em um aplicativo de terceiros e as informações são enviadas via solicitação HTTP.

Este gatilho está apenas disponível para o plano Business e acima.

Configuração

Depois de selecionar esse gatilho, um URL de webhook exclusivo é gerado automaticamente para cada um dos seus fluxos de trabalho. Você enviará solicitações HTTP POST para esta URL para eventualmente acionar o fluxo de trabalho.

Você precisará então fornecer a chave JSON em sua carga útil que corresponda ao tipo de identificador de contato. Isso permite que nosso sistema identifique qual contato ou contatos serão acionados pelo fluxo de trabalho. Tem um limite máximo de 500 caracteres.

Existem três tipos principais de identificadores de contato (como identificamos um contato):

  • ID de contacto

  • E-mail

  • Número de telefone

Você também pode armazenar os parâmetros na carga útil do webhook de entrada como variáveis para poder usá-los em outras etapas do fluxo de trabalho, dependendo do seu caso de uso.

Requisitos:

  • A chave JSON na sua carga útil deve corresponder ao texto no campo JSON na plataforma.

  • A mesma chave JSON não pode ser salva duas vezes; ela deve ser um valor definido (não um objeto ou uma matriz).

  • A chave JSON tem um limite máximo de 500 caracteres.

Você concluirá o processo salvando o valor-chave JSON em uma variável. A variável deve ser única no texto e ter um limite máximo de 30 caracteres. São permitidas no máximo 10 variáveis. Observe que somente o corpo JSON pode ser salvo.

Exemplo

Como preencher a chave JSON para salvar uma resposta para diferentes formatos de resposta:

{   
    "nome": "Jason",   
    "Códigos postais": "12345",   
    "telefone": "123123"   
}

Para salvar o número de telefone no corpo JSON acima, use $.phone como a chave JSON.

{   
    "campos_personalizados": {   
        "primeiroNome": "João",   
        "sobrenome": "Doe",   
        "localidade": "pt_GB",   
        "fuso horário": "5",   
        "gênero": "masculino",   
        "telefone": "123123",   
        "email": "zy@respond.io",   
        "clienteID": "1"  
    },   
    "criado_em": 1575618542  
}

Para salvar o número de telefone no corpo JSON acima, use $.custom_fields.phone.

{  
        "dados": {  
            "id":"1776025372480910",  
            "contatos" : [  
                {  
                    "primeiroNome":"João",  
                    "sobrenome":"Doe",  
		    "localidade": "pt_GB"  
                },  
                {  
                    "primeiroNome":"Jane",  
                    "sobrenome":"Doe",  
		    "localidade": "pt_GB"  
                }  
	    ]  
        }  
}

Para salvar o primeiro nome 'Jane' no corpo JSON acima, use $.data.contacts[1].firstName.

Gatilho: Meta Anúncios Click-to-Chat

Inicia o fluxo de trabalho quando um anúncio do Facebook é clicado ou quando uma mensagem relacionada ao anúncio é recebida.

Configuração

Depois de selecionar esse gatilho, conecte sua conta do Facebook para configurá-lo.

Após conectar-se ao Facebook, selecione a Conta de Anúncios e os anúncios relevantes aos quais você deseja que o Acionador seja vinculado.

Somente anúncios criados e gerenciados no Gerenciador de Anúncios podem ser selecionados aqui. Se você criou anúncios em um aplicativo Meta, por exemplo, Meta Business Suite ou Instagram, eles não serão listados aqui para seleção.

Seleção de anúncios

Selecione Todos os anúncios para aplicar a todos os anúncios atuais e futuros na Conta de anúncios selecionada.

  • Para ativar isto, escolha a opção “Todos os anúncios” no novo botão de controlo segmentado.

  • Quando esta opção é selecionada, o fluxo de trabalho será acionado automaticamente para todos os anúncios gerenciados na conta de anúncios selecionada, incluindo quaisquer anúncios adicionados no futuro.

Se preferir segmentar anúncios específicos, selecione a opção “Anúncios selecionados” para escolher manualmente os anúncios no menu suspenso.

Variáveis de gatilho

Quando um anúncio Meta Click-to-Chat é acionado, o respond.io recupera metadados do anúncio e armazena-os em Variáveis de Acionamento. Essas variáveis são úteis para personalizar mensagens, encaminhar leads e passar dados de campanha para ferramentas externas.

Variáveis disponíveis:

Variável

Descrição

$clicktochat.ad_timestamp

Hora em que o anúncio foi clicado

$clicktochat.ad_primeira_mensagem_recebida

Primeira mensagem enviada pelo contato

$clicktochat.ad_channel_id

ID do canal de mensagens

$clicktochat.ad_channel_type

Tipo de canal (por exemplo, Messenger, WhatsApp)

$clicktochat.ad_contact_type

Tipo de contato (por exemplo, novo ou existente)

$clicktochat.ad_id

ID do anúncio

$clicktochat.ad_nome

Nome do anúncio

$clicktochat.ad_campaign_id

ID da campanha

$clicktochat.nome_da_campanha

Nome da campanha

$clicktochat.ad_adset_id

ID do conjunto de anúncios

$clicktochat.ad_adset_name

Nome do conjunto de anúncios

$clicktochat.ad_ad_url

URL do anúncio

$clicktochat.ad_reference

String de referência anexada ao anúncio

$clicktochat.ad_status

Status do anúncio

$clicktochat.ad_objective

Objetivo da campanha (ex.: Leads, Tráfego)

$clicktochat. objetivo_de_otimização_de_anúncios

Meta de otimização definida no Gerenciador de Anúncios

$clicktochat.ad_destination_type

Tipo de destino (por exemplo, Messenger, WhatsApp)

Nota: Estas variáveis podem retornar nulo dependendo dos metadados recebidos do Meta. Eles só ficam disponíveis durante a execução do fluxo de trabalho após o anúncio ser acionado.

Como usar

Use qualquer variável nas etapas do seu fluxo de trabalho referenciando-a com um cifrão $. Por exemplo:

  • Envie uma mensagem personalizada: Olá! Obrigado por clicar no nosso anúncio $clicktochat.ad_name!

  • Adicione o nome da campanha a uma Planilha Google

  • Fluxos de trabalho de ramificação com base em campanha ou conjunto de anúncios

Acionador: Anúncios de mensagens do TikTok

Inicia o fluxo de trabalho quando um anúncio do TikTok é clicado ou quando uma mensagem relacionada ao anúncio é recebida.

Configuração

Depois de selecionar esse gatilho, conecte sua conta de anúncios do TikTok em Integrações para configurá-lo.

Após conectar-se ao TikTok, selecione a Conta de Anúncios e os anúncios relevantes aos quais você deseja que o gatilho seja vinculado.

Somente anúncios criados e gerenciados no Gerenciador de Anúncios do TikTok podem ser selecionados aqui.

Seleção de anúncios

Selecione Todos os anúncios para aplicar a todos os anúncios atuais e futuros na Conta de anúncios selecionada.

  • Para ativar isto, escolha a opção “Todos os anúncios” no novo botão de controlo segmentado.

  • Quando esta opção é selecionada, o fluxo de trabalho será acionado automaticamente para todos os anúncios gerenciados na conta de anúncios selecionada, incluindo quaisquer anúncios adicionados no futuro.

Se preferir segmentar anúncios específicos, selecione a opção “Anúncios selecionados” para escolher manualmente os anúncios no menu suspenso.

Variáveis de gatilho

Quando uma interação com um anúncio TikTok aciona o fluxo de trabalho, o respond.io recupera metadados sobre o anúncio e armazena-os em Variáveis de gatilho. Essas variáveis podem ser usadas em todo o fluxo de trabalho para personalização, lógica de roteamento e integração com ferramentas externas (por exemplo, Planilhas Google).

Variáveis disponíveis:

Variável

Descrição

$tiktokmessagingad.ad_timestamp

Hora em que o anúncio foi clicado

$tiktokmessagingad.ad_primeira_mensagem_recebida

Primeira mensagem enviada pelo contato

$tiktokmessagingad.ad_channel_id

ID do canal de mensagens

$tiktokmessagingad.ad_channel_type

Tipo de canal (por exemplo, TikTok)

$tiktokmessagingad.ad_contact_type

Tipo de contato (por exemplo, novo ou existente)

$tiktokmessagingad.ad_id

ID do anúncio

$tiktokmessagingad.ad_name

Nome do anúncio

$tiktokmessagingad.ad_campaign_id

ID da campanha

$tiktokmessagingad. nome_da_campanha_de_anúncio

Nome da campanha

$tiktokmessagingad.ad_adgroup_id

ID do grupo de anúncios

$tiktokmessagingad.ad_adgroup_name

Nome do grupo de anúncios

$tiktokmessagingad. estado_de_operação_do_ad

Status de operação do anúncio

$tiktokmessagingad.ad_estado_secundário

Status secundário do anúncio

Nota: Nem todas as variáveis podem estar disponíveis para todas as interações com anúncios. Essas variáveis podem retornar nulo se as informações não forem fornecidas pelo TikTok.

Como usar

Use essas variáveis em qualquer etapa do fluxo de trabalho referenciando-as com um cifrão $. Por exemplo:

  • Adicione uma etiqueta: $tiktokmessagingad.ad_campaign_name

  • Atualizar um campo personalizado

  • Passar metadados para aplicativos externos via solicitação HTTP ou Planilhas Google

Gatilho: Gatilho manual

O gatilho manual não funciona sozinho. Ele só pode ser executado por meio da etapa Acionar outro fluxo de trabalho.

Saiba mais sobre o passo Trigger Another Workflow aqui.

Se você estiver conectando dois ou mais fluxos de trabalho usando a etapa Acionar Outro Fluxo de Trabalho, poderá usar o Gatilho Manual nos fluxos de trabalho conectados ao fluxo de trabalho original. Isso significa que os fluxos de trabalho conectados funcionarão apenas quando um Contato entrar no fluxo de trabalho com a etapa Acionar outro fluxo de trabalho.

Configuração

O Gatilho Manual pode ser utilizado apenas com a etapa Acionar outro fluxo de trabalho.

Digamos que o Fluxo de Trabalho A seja criado com o Acionador Manual e esteja conectado ao Fluxo de Trabalho B. O Fluxo de Trabalho A só será acionado quando o Fluxo de Trabalho B for publicado, e um Contato entrará no Fluxo de Trabalho A por meio da Etapa Acionar Outro Fluxo de Trabalho.

Gatilho: Ciclo de vida atualizado

O gatilho de atualização do ciclo de vida inicia um fluxo de trabalho sempre que o estágio do ciclo de vida de um contato muda. Isso permite que você automatize ações com base na progressão do contato em seus estágios de vendas, como qualificação de leads, acompanhamentos ou esforços de retenção de clientes.

Configuração

Habilitar ciclo de vida nas configurações

Certifique-se de que o recurso Ciclo de vida esteja habilitado nas configurações do seu espaço de trabalho. Se o recurso Ciclo de vida não estiver habilitado, você precisará ativá-lo antes de configurar este Gatilho.

Selecione Estágio(s) do Ciclo de Vida

Depois de selecionar este gatilho, escolha o(s) estágio(s) do ciclo de vida que iniciarão o fluxo de trabalho.

  • Todos os estágios: Aciona o fluxo de trabalho sempre que o estágio de um contacto é atualizado, independentemente do estágio específico.

  • Estágios específicos: aciona o fluxo de trabalho apenas quando o estágio de um contacto é atualizado para um ou mais estágios selecionados. Você pode selecionar um ou vários Estágios, conforme necessário.

Configurar configurações avançadas (opcional) deve ser corrigido para 'Configurar Configurações Avançadas (opcional)'.

  • Acionar quando limpo: Ative esta configuração para acionar o fluxo de trabalho quando o estágio do ciclo de vida de um contato for limpo, sem deixar nenhum estágio atribuído.

  • Acionar uma vez por contacto: quando ativado, isto garante que o fluxo de trabalho é acionado apenas uma vez para cada contacto, mesmo que entre novamente na fase selecionada.

Utilize o nosso modelo do Google Sheets para captar dados importantes e acompanhar as taxas de conversão com a Etapa de atualização do ciclo de vida.

Perguntas frequentes e resolução de problemas

Por que meus anúncios Click-to-Chat não estão aparecendo no acionador de anúncios Click-To-Chat?

Se seu anúncio Click-to-Chat não estiver aparecendo como esperado, provavelmente é devido a configurações específicas em sua configuração de anúncio que não estão alinhadas com os tipos suportados. Aqui está o que verificar:

  • Canais suportados: Certifique-se de que o canal que está a utilizar é suportado. Atualmente, respond.io suporta

    • Plataforma WhatsApp Business (API)

    • API do WhatsApp Cloud

    • Instagram

    • Mensageiro do Facebook deve ser corrigido para Messenger do Facebook.

  • Estado do anúncio: Certifique-se de que o seu anúncio está definido paraAtivo ou Pausado.

  • Objetivo da campanha: Verifique se o objetivo do seu anúncio corresponde a um dos tipos suportados.

    • Nome do objetivo do meta ads anterior: BRAND_AWARENESS, LINK_CLICKS, CONVERSÕES, MENSAGENS, TRÁFEGOe ALCANCE.

    • Novo nome do objetivo dos meta anúncios (beta): OUTCOME_ENGAGEMENT, OUTCOME_AWARENESS, OUTCOME_TRAFFIC, OUTCOME_LEADSe OUTCOME_SALES.

  • Meta de otimização: As metas de otimização do seu anúncio são uma das seguintes: CONVERSÕES_OFFSITE, CONVERSAS, IMPRESSÕES ou CLIQUES_DE_LINK.

  • Tipo de destino: Os tipos de destino do seu anúncio são um dos seguintes: APPLINKS_AUTOMATIC, INSTAGRAM_DIRECT, MESSENGER, APP ou WHATSAPP.

Compartilhar este artigo
Telegram
Facebook
Linkedin
Twitter

Artigos relacionados 👩‍💻

Passo: Atualizar ciclo de vida
Saiba mais sobre as melhores práticas, casos de uso e como funciona ao implementar a etapa de atualização do ciclo de vida.
Etapa: Enviar evento da API de conversões
Saiba mais sobre a configuração, como ela funciona, práticas recomendadas e muito mais ao implementar a etapa Enviar evento da API de conversões.
Como evitar loops de fluxo de trabalho
Saiba como evitar laços de fluxo de trabalho que causam repetições desnecessárias, sobrecarga do sistema e atrasos.
Etapa: Enviar evento de funil inferior do TikTok
Aprenda sobre as melhores práticas, casos de uso e como funciona ao implementar a etapa de envio de eventos do funil inferior do TikTok.
Passo: Adicionar linha do Google Sheets
Saiba mais sobre a configuração, as melhores práticas e os casos de uso para implementar o Passo Adicionar Linha de Planilhas Google.

Não consegue encontrar o que você está procurando? 🔎