> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Acionadores e ações de fluxo de trabalho HubSpot na Flowella
> Configure acionadores e ações HubSpot do Flowella: Formulário concluído, Resposta de texto, Enviar Template WhatsApp, Enviar Mensagem e passagem a agente IA.
A Flowella integra-se diretamente no motor de fluxos de trabalho do HubSpot, oferecendo acionadores personalizados que disparam em eventos WhatsApp e ações que enviam mensagens ou entregam conversas a um agente de IA. Este guia abrange cada acionador, cada ação e os padrões mais eficazes para os combinar.
## Antes de começar
Certifique-se de que tem:
* Uma conta Flowella ligada ao seu portal HubSpot
* Pelo menos um modelo WhatsApp criado na aplicação Flowella (obrigatório para enviar mensagens)
* Acesso à ferramenta de fluxos de trabalho do HubSpot. Os fluxos de trabalho baseados em contactos requerem um plano Professional ou Enterprise
Todas as propriedades de número de telefone utilizadas nas ações de fluxo de trabalho Flowella devem ser armazenadas no formato internacional E.164, começando por `+` seguido do indicativo do país e do número nacional (por exemplo, `+447700900123`). Consulte [Formato do número de telefone](/pt/hubspot/phone-number-format) para mais detalhes.
***
## Acionadores
Quando cria um novo fluxo de trabalho baseado em contactos no HubSpot, procure **Flowella** no painel de seleção de acionadores para ver todos os acionadores disponíveis. Estes disparam sempre que ocorre um evento WhatsApp específico e inscrevem automaticamente o contacto associado no fluxo de trabalho.
| Acionador | Direção | Dispara quando | Utilização típica | Propriedades-chave para filtrar |
| ------------------------ | ------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------- |
| **Formulário concluído** | Entrada | Um contacto submete um formulário WhatsApp Flow enviado através da Flowella | Processar respostas estruturadas após um fluxo de feedback, reserva ou KYC | Form Name, Source, hs\_email, Occurred at |
| **Resposta de texto** | Entrada | Um contacto envia uma resposta de texto livre numa conversa gerida pela Flowella | Encaminhar com base em palavras-chave, capturar opt-in, detetar intenção | Message |
| **Mensagem lida** | Saída | Um contacto abre uma mensagem WhatsApp que enviou | Fazer seguimento apenas depois de a mensagem ter sido vista | Phone |
| **Mensagem enviada** | Saída | Uma mensagem WhatsApp é despachada para um contacto através da Flowella | Registar atividade de saída, iniciar um temporizador de seguimento | Phone |
### Formulário concluído (entrada)
Este acionador dispara quando um contacto preenche um formulário WhatsApp Flow enviado através da Flowella. É o acionador mais utilizado e constitui a espinha dorsal da maioria das automações Flowella.
Pode refinar este acionador com as seguintes propriedades de evento:
* **Form Name**: filtre por um formulário específico para que apenas as conclusões desse formulário acionem o fluxo de trabalho
* **hs\_email**: o endereço de e-mail do contacto no momento do evento
* **Occurred at**: a data e hora em que o formulário foi preenchido
* **Source**: a origem da submissão do formulário
**Utilização típica:** acione um fluxo de trabalho de seguimento depois de um cliente preencher um formulário de feedback, uma confirmação de reserva, um questionário KYC ou qualquer outro fluxo estruturado de recolha de dados.
### Resposta de texto (entrada)
Este acionador dispara quando um contacto envia uma resposta de texto livre numa conversa WhatsApp gerida pela Flowella.
O que torna este acionador particularmente poderoso é a capacidade de **filtrar pelo conteúdo da mensagem**. Ao configurar os critérios do acionador, adicione uma condição na propriedade **Message** utilizando operadores como “contém alguma das” para corresponder a palavras-chave ou frases específicas. Isto permite criar fluxos de trabalho que respondem de forma diferente consoante o que o contacto diz.
**Utilização típica:** encaminhar contactos com base em respostas por palavras-chave. Por exemplo, se um contacto responder “sim” a uma mensagem de confirmação, inscreva-o num fluxo de trabalho; se responder “cancelar” ou “ajuda”, inscreva-o noutro. Pode também utilizar isto para capturar consentimento de opt-in, acionar caminhos de escalonamento ou detetar intenção em respostas não estruturadas.
### Mensagem lida (saída)
Este acionador dispara quando um contacto lê (abre) uma mensagem WhatsApp enviada através da Flowella. É útil para acompanhar o envolvimento e construir lógica condicional em torno da entrega de mensagens.
**Utilização típica:** iniciar uma sequência de seguimento apenas depois de confirmar que o contacto viu a sua mensagem inicial, ou sinalizar contactos que não tenham lido uma mensagem dentro de um determinado período.
### Mensagem enviada (saída)
Este acionador dispara quando uma mensagem WhatsApp é enviada com sucesso para um contacto através da Flowella. Confirma o despacho a partir da plataforma Flowella, e não a receção pelo contacto. É mais útil como acionador para envios que tiveram origem fora de um fluxo de trabalho HubSpot, como uma resposta enviada por um agente a partir da caixa de entrada Flowella ou uma resposta Flow automatizada, uma vez que um fluxo de trabalho já tem conhecimento das mensagens que ele próprio enviou.
**Utilização típica:** registar atividade de mensagens de saída, atualizar propriedades do CRM para registar que uma mensagem foi despachada, ou iniciar um temporizador para ações de seguimento.
### Utilizar “Atrasar até ao evento” com acionadores Flowella
Uma das funcionalidades mais poderosas de combinar a Flowella com o HubSpot é a ação **Atrasar até ocorrer um evento**. Isto permite que um fluxo de trabalho seja colocado em pausa e aguarde por qualquer evento Flowella antes de continuar.
Por exemplo, pode construir um fluxo de trabalho que:
1. Envia um formulário WhatsApp Flow a um contacto
2. É colocado em pausa utilizando **Atrasar até ao evento** definido para o evento Flowella (estes aparecem no seletor como **Flowella: WhatsApp Forms Integration: Form Completed** e assim por diante)
3. Ramifica consoante os critérios do evento tenham sido cumpridos dentro da janela de tempo escolhida
Isto cria um verdadeiro padrão de pedido-resposta dentro da sua automação. Se o evento não ocorrer dentro do período de atraso, o fluxo de trabalho ramifica para um caminho alternativo, como enviar um lembrete ou escalar para um membro da equipa.
Pode utilizar este padrão com qualquer evento Flowella:
* **Aguardar Form Completed**: pausar até o contacto terminar um WhatsApp Flow e, em seguida, processar as suas respostas
* **Aguardar Text Reply**: pausar até o contacto responder e, em seguida, ramificar com base no conteúdo da mensagem
* **Aguardar Message Read**: pausar até o contacto abrir a mensagem e, em seguida, decidir se faz seguimento ou se espera mais
## Ações
Além dos acionadores, a Flowella disponibiliza quatro ações de fluxo de trabalho personalizadas. Estas aparecem no painel de ações quando adiciona um passo a qualquer fluxo de trabalho HubSpot baseado em contactos.
### Enviar Modelo WhatsApp
Esta ação envia uma mensagem de modelo WhatsApp pré-aprovada a um contacto. Os modelos são criados e geridos na aplicação Flowella e incluem tanto modelos de mensagem padrão como modelos interativos WhatsApp Flow (formulários).
| Campo | Descrição |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Número de telefone do contacto**\*(obrigatório)\* | Selecione a propriedade do contacto HubSpot que contém o número de telefone WhatsApp do destinatário. Deve estar no formato internacional (por exemplo, `+447700900000`). |
| **Nome do modelo**\*(obrigatório)\* | Escolha a partir de um menu pendente de modelos criados na aplicação Flowella. Inclui tanto modelos de mensagem padrão como modelos Flow (formulários interativos). |
| **E-mail do contacto** | Mapeie opcionalmente o endereço de e-mail do contacto. A Flowella pode utilizá-lo para correspondência, enriquecimento e análise. |
| **Variável de modelo 1 a 5** | Mapeie propriedades de contacto ou empresa do HubSpot para as variáveis de personalização definidas no seu modelo. Por exemplo, se o seu modelo incluir `{{1}}` para o primeiro nome, mapeie a Variável de Modelo 1 para a propriedade Primeiro Nome. |
**Pontos-chave:**
* Os modelos Flow (formulários interativos) são selecionados exatamente da mesma forma que os modelos de mensagem padrão, e a Flowella trata da conversão automaticamente.
* Pode mapear até cinco variáveis de modelo utilizando qualquer token de dados HubSpot, incluindo propriedades do contacto inscrito, propriedades da empresa e dados de ações anteriores do fluxo de trabalho.
* Se uma variável de modelo obrigatória não for mapeada, o envio pode falhar para esse contacto.
* Esta ação é ideal para confirmações de reserva, pedidos de feedback, lembretes de renovação, notificações de marcações e qualquer outra mensagem estruturada ou em modelo.
### Enviar Mensagem WhatsApp
Esta ação envia uma mensagem WhatsApp direta a um contacto. Ao contrário da ação de modelo, permite compor uma mensagem em tempo real dentro do fluxo de trabalho e suporta vários tipos de multimédia.
| Campo | Descrição |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Tipo de mensagem**\*(obrigatório)\* | Escolha entre: Mensagem de texto, Documento, Imagem, Vídeo ou Áudio. |
| **Número de telefone do destinatário**\*(obrigatório)\* | Selecione a propriedade do contacto HubSpot que contém o número de telefone WhatsApp do destinatário. |
| **Texto da mensagem** | Para mensagens de texto, introduza o conteúdo da mensagem. Personalize-a utilizando qualquer token de dados HubSpot clicando no painel de tokens de dados. Os tokens disponíveis incluem propriedades do contacto inscrito, registos associados, dados de acionador e evento, e resultados de ações anteriores do fluxo de trabalho. |
**Pontos-chave:**
* As mensagens de texto podem ser totalmente personalizadas com conteúdo dinâmico, como o primeiro nome do contacto, o valor de um negócio ou um número de referência de ticket.
* As mensagens multimédia (imagem, vídeo, áudio, documento) permitem enviar conteúdo rico diretamente através do WhatsApp como parte de um fluxo de trabalho automatizado.
* Esta ação é particularmente útil para mensagens de seguimento que não requerem um modelo pré-aprovado, como mensagens de agradecimento personalizadas ou respostas contextuais acionadas por lógica anterior do fluxo de trabalho.
### Enviar Resposta WhatsApp
Esta ação envia uma mensagem WhatsApp com aspeto pessoal que **funciona mesmo quando a janela de atendimento ao cliente de 24 horas tiver fechado**. Utilize-a em vez de **Enviar Mensagem WhatsApp** quando o fluxo de trabalho pode ser executado horas ou dias depois da última mensagem de entrada do cliente.
| Campo | Descrição |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Número de telefone do destinatário**\*(obrigatório)\* | Selecione a propriedade do contacto HubSpot que contém o número de telefone WhatsApp do destinatário. Deve estar no formato internacional (por exemplo, `+447700900000`). |
| **Mensagem**\*(obrigatório)\* | O corpo da mensagem. Personalize-o com tokens de dados HubSpot (contacto, empresa, negócio, ticket ou resultados de ações anteriores). |
| **Ignorar se a janela estiver fechada** | Quando marcada, a ação **não faz nada** se a janela de 24 horas tiver fechado. Utilize isto se apenas pretender contactar contactos ainda numa conversa ativa. |
**Como funciona:**
* **Dentro da janela de 24 horas** — a sua mensagem é enviada como um texto WhatsApp livre normal.
* **Fora da janela** — a Flowella envolve a sua mensagem no [modelo de reabertura](/pt/settings/reply-templates) ativo (variável `{{3}}`). O primeiro nome do contacto (`{{1}}`) e o nome do seu negócio (`{{2}}`) são preenchidos automaticamente. Uma conversa de modelo Utility é aberta (normalmente \~\$0,045 por envio, dependendo do país — consulte [Preços e categorias de conversa](/pt/account/pricing-and-conversation-categories)).
**Quando utilizar em vez de Enviar Mensagem WhatsApp:**
* Sequências de reativação, retenção e sucesso do cliente que possam ser executadas após 24 h de silêncio.
* Seguimentos aos acionadores de **Formulário concluído** quando o fluxo de trabalho inclui longos atrasos.
* Qualquer envio em que pretenda que uma ação HubSpot “simplesmente funcione” independentemente do estado da janela.
**Dica:** ramifique a partir da propriedade de contacto `whatsapp_window_open_until` (sincronizada pela Flowella na entrada) se precisar de lógica diferente para janelas abertas vs. fechadas antes desta ação ser executada.
### Atribuir a Customer Agent
Esta ação atribui uma conversa a um HubSpot Breeze Customer Agent, iniciando uma conversa alimentada por IA diretamente dentro do canal WhatsApp da Flowella.
| Campo | Descrição |
| -------------------------------------- | ---------------------------------------------------------------------------- |
| **Agente a atribuir**\*(obrigatório)\* | Selecione qual o Breeze Customer Agent que deve tratar da conversa. |
| **Registo a atribuir** | Escolha o tipo de registo a atribuir, como “Conversas: Todas as associadas”. |
Quando atribui uma conversa a um Breeze Customer Agent através desta ação, o agente de IA começa a responder ao contacto diretamente no WhatsApp através do canal Flowella. Isto significa que os seus clientes recebem respostas inteligentes e contextuais sem sair da conversa WhatsApp em que já estão.
Esta ação é particularmente valiosa para:
* **Suporte pós-formulário**: depois de um cliente submeter um formulário de pedido de informações, o agente de IA pode responder a perguntas de seguimento de imediato
* **Atendimento fora de horas**: encaminhar conversas WhatsApp para um agente de IA quando a sua equipa não está disponível
* **Triagem e escalonamento**: deixar o agente de IA tratar das perguntas iniciais e apenas escalar para um humano quando necessário
* **Pedidos de informações sobre produtos e serviços**: fornecer respostas imediatas a partir da sua base de conhecimento sem necessitar de um agente em direto
***
## Padrões de fluxo de trabalho
Aqui estão quatro padrões comuns que combinam acionadores Flowella, atrasos e ações de forma eficaz.
### Padrão 1: Enviar e esperar
O padrão central para qualquer interação baseada em formulário.
Adicione uma ação **Enviar Modelo WhatsApp** com um modelo Flow de formulário.
Adicione uma ação **Atrasar até ao evento**: Flowella: Form Completed.
Adicione uma ação **Ramificar**: se os critérios do evento foram ou não cumpridos.
Adicione uma ação **Ramificar**: se os critérios do evento foram ou não cumpridos.
Se os critérios foram cumpridos: processe os dados do formulário, atualize as propriedades do CRM e acione os próximos passos.
Se os critérios não foram cumpridos: envie um lembrete ou escale para um membro da equipa.
***
### Padrão 2: Encaminhamento baseado em palavras-chave
Encaminhe contactos para o fluxo de trabalho certo com base no que respondem.
Utilize **Flowella: Text Reply** em que a propriedade Message contém palavras-chave como “reservar” ou “marcar”.
Adicione uma ação **Enviar Modelo WhatsApp** com o seu modelo Flow de reserva.
Adicione um **Atrasar até ao evento** definido para Flowella: Form Completed, depois ramifique e processe as respostas.
Adicione um **Atrasar até ao evento** definido para Flowella: Form Completed, depois ramifique e processe as respostas.
***
### Padrão 3: Feedback com seguimento inteligente
Recolha feedback e tome ações diferentes consoante a classificação.
Adicione uma ação **Enviar Modelo WhatsApp** com o seu modelo Flow de feedback.
Adicione um **Atrasar até ao evento** definido para Flowella: Form Completed.
Adicione um **Atrasar até ao evento** definido para Flowella: Form Completed.
Utilize uma **ramificação Se/então** com base na propriedade de classificação:
* Classificação alta: envie uma mensagem de agradecimento com uma ligação de avaliação
* Classificação baixa: crie um ticket e atribua a um Customer Agent para recuperação assistida por IA
Utilize uma **ramificação Se/então** com base na propriedade de classificação:
* Classificação alta: envie uma mensagem de agradecimento com uma ligação de avaliação
* Classificação baixa: crie um ticket e atribua a um Customer Agent para recuperação assistida por IA
***
### Padrão 4: Transferência conversacional para IA
Entregue respostas de entrada diretamente a um agente de IA.
Utilize **Flowella: Text Reply** para captar qualquer mensagem recebida.
Adicione uma ação **Enviar Mensagem WhatsApp** para confirmar que recebeu a mensagem.
Adicione uma ação **Atribuir a Customer Agent**. O Breeze Customer Agent passa então a tratar da conversa nativamente no WhatsApp.
***
## Variáveis de data e hora
O HubSpot armazena propriedades de data e data-hora como **milissegundos de epoch**. Quando mapeia uma dessas propriedades para uma variável de modelo Flowella, a Flowella apresenta o valor como **`dd.MM.yyyy HH:mm`** no fuso horário do destinatário — por exemplo, `27.06.2026 14:30`.
Isto aplica-se em três locais:
* **Enviar Modelo WhatsApp** — qualquer `Template Variable n` mapeado para uma propriedade de data ou data-hora do HubSpot.
* **Enviar Mensagem WhatsApp** — a mesma formatação é aplicada a tokens de data inline utilizados no corpo da mensagem.
* **Cargas úteis legadas de tokens `variable_*`** — integrações de API mais antigas que enviam valores de epoch sem metadados de tipo explícitos são detetadas e apresentadas de forma idêntica.
Os tokens de data de marcação injetados a partir de aplicações HubSpot externas (por exemplo, ferramentas de agendamento que escrevem uma propriedade “próxima marcação”) são agora apresentados com o mesmo padrão `dd.MM.yyyy HH:mm`. Se anteriormente via números de epoch em bruto na mensagem entregue, não precisa de fazer nada — está corrigido ao nível da plataforma.
Se precisar de um formato diferente, crie uma **propriedade calculada do HubSpot** que formate a data como texto (por exemplo, `27 de junho de 2026 às 14:30`) e mapeie-a para a variável de modelo. A Flowella trata as propriedades de texto literalmente.
## Dicas e melhores práticas
**Utilize o formato internacional de número de telefone.** Armazene sempre os números de telefone WhatsApp no formato E.164 (por exemplo, `+44` para o Reino Unido, `+1` para os EUA). A Flowella exige isto para entregar mensagens com sucesso.
**Dê nomes claros aos seus modelos.** Ao criar modelos na aplicação Flowella, utilize nomes descritivos que sejam fáceis de identificar no menu pendente do HubSpot. “Confirmação de Reserva Restaurante” é mais claro do que “Modelo 1”.
**Combine acionadores com atrasos para maior fiabilidade.** O padrão “enviar e esperar” garante que o seu fluxo de trabalho lida com contactos responsivos e não responsivos de forma elegante, em vez de depender apenas de acionadores.
**Utilize o acionador Resposta de Texto para encaminhamento conversacional.** Ao filtrar pelo conteúdo da mensagem, pode construir interfaces conversacionais leves sem um chatbot completo. Uma simples correspondência por palavras-chave pode encaminhar contactos para o fluxo de trabalho certo com mínima fricção.
**Teste primeiro com audiências pequenas.** Ao criar novos fluxos de trabalho, comece por inscrever um pequeno grupo de teste antes de implementar em toda a sua lista de contactos. Isto ajuda a apanhar cedo problemas com variáveis de modelo, formatação de números de telefone ou lógica de ramificação.