> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/workflows/workflows-pt-br/readme.md).
# Workflows: Automação Avançada
Os **Workflows** são o motor de automação da Vambe. Semelhante a ferramentas como o Zapier, esta funcionalidade permite criar cadeias de "Causa e Efeito" dentro da Vambe.
**Para que servem?** Desde enviar uma mensagem de "Fora do Expediente" nos fins de semana até fazer uma pesquisa com um cliente 4 dias após uma compra no Shopify. Se acontecer "X", a Vambe fará "Y".
***
#### 1. Estrutura de um Workflow
Para criar um, vá ao menu lateral esquerdo Workflows e clique em Criar Flow.
Um fluxo é composto por três peças-chave:
1. **Trigger (Gatilho)**: O evento que inicia tudo (Ex.: "Uma etiqueta foi atribuída").
2. **Condição (Filtro)**: Regras opcionais para decidir se avança ou não (Ex.: "É fim de semana?").
3. **Ação**: O que o sistema fará (Ex.: "Enviar mensagem").
***
#### 2. Selecione seu Trigger (Gatilho)
O primeiro passo é definir o que deve acontecer para que o fluxo seja ativado. A Vambe oferece uma grande variedade de gatilhos nativos:
**Dados de Contato/Ticket:**
* **Etiqueta atribuída:** Ex.: Se marcarem alguém como "VIP".
* **Campos atualizados:** Ex.: Se o status de um pedido mudar.
* **Agente atribuído:** Quando um agente é atribuído ao ticket.
* **Lead score atribuído:** Quando a pontuação do lead muda.
* **Valor do ticket atualizado:** Quando o valor é alterado.
* **Status do ticket alterado:** Quando o ticket passa para ganho, perdido etc.
**Eventos de Funil:**
* **Entrada na etapa / Saída da etapa:** É ativado quando um ticket entra ou sai de uma etapa específica.
**CRM:**
* **Mudança de Etapa do CRM (Novo):** É ativado quando um contato muda de etapa no HubSpot, Pipedrive ou Salesforce.
**E-commerce e Agendamento (Evento Capturado):** Fundamental para Shopify/WooCommerce. É ativado quando um pedido é criado (Order Created), um carrinho é recuperado ou um agendamento é feito.
**Conversacional:**
* **Mensagem recebida em etapa humana:** Ideal para auto-respostas quando o agente não está disponível.
* **Mensagem enviada por um humano:** É ativado quando um agente envia uma mensagem.
* **NPS/CSAT respondido:** Para tomar ações de acordo com a avaliação do cliente.
* **Chamada finalizada:** Quando uma chamada com o contato termina.
* **Chamada recebida (Novo):** É ativado assim que uma chamada entra em um dos telefones de voz que você selecionar — antes de a chamada ser conectada com alguém. Veja o detalhe em [Como montar a lógica de Call Center com o nó Chamada recebida](/workflows/workflows-pt-br/como-montar-a-logica-de-call-center-com-o-no-chamada-recebida.md).
* **Conversa iniciada a partir de anúncio do WhatsApp (CTWA) (Novo):** É ativado assim que um contato escreve pelo WhatsApp a partir de um anúncio Click to WhatsApp. É escolhido no trigger **Evento capturado**. Veja o detalhe em [Reaja em Workflows quando um contato chega a partir de um anúncio do WhatsApp (CTWA)](/workflows/workflows-pt-br/reaja-em-workflows-quando-um-contato-chega-a-partir-de-um-anuncio-do-whatsapp-ctwa.md).
* **Reação a mensagem:** Quando o contato reage a uma mensagem.
* **Inatividade do contato (Novo):** É ativado quando o contato fica um tempo definido sem enviar uma mensagem.
* **Inatividade do agente (Novo):** É ativado quando o agente fica um tempo definido sem responder ao contato.
**Externos e Técnicos:**
* **Webhook:** Para receber sinais do seu próprio sistema.
* **Trigger Recorrente:** Para executar tarefas periódicas. Ex.: Toda segunda-feira às 9h.
* **Typeform respondido:** É disparado automaticamente quando um cliente conclui um formulário do Typeform.
* **Linha inserida no Google Sheets (Novo):** É ativado quando uma nova linha é adicionada em uma planilha do Google Sheets.
* **Flow ativado por IA:** É ativado quando uma função de um assistente o executa.
* **Evento de erro:** É ativado quando ocorre um erro no fluxo.
***
#### 3. Adicione Condições (Filtros)
Uma vez ativado o trigger, você pode colocar "portas" lógicas.
Tipos de condições disponíveis:
* **Condição de Horário:** "É sábado ou domingo?", "Já passou das 18:00?".
* **Condição de Metadados:** "O preço do produto é maior que $1.000.000?".
* **Condição de Canal:** "O cliente fala pelo Instagram ou WhatsApp?".
* **Avaliar com IA:** Usar inteligência artificial para decidir se o cliente cumpre um requisito complexo.
* **Condição Aleatória:** Dividir o tráfego 50/50 (teste A/B).
* **Condição por evento:** Avalia se o contato teve um evento determinado em um período de tempo. Ex.: "Teve uma conversa iniciada a partir de um anúncio do WhatsApp (CTWA) nos últimos 7 dias?" —ver [Reaja em Workflows quando um contato chega a partir de um anúncio do WhatsApp (CTWA)](/workflows/workflows-pt-br/reaja-em-workflows-quando-um-contato-chega-a-partir-de-um-anuncio-do-whatsapp-ctwa.md).
* **Condição de sequência (Novo):** Divide o fluxo conforme como um nó do tipo Sequência terminou —ver [Sequências: agrupa tentativas sem duplicar nós](/workflows/workflows-pt-br/sequencias-agrupe-as-tentativas-sem-duplicar-nos.md).
***
#### 4. Execute Ações
Por fim, defina o que a Vambe fará. Você pode encadear várias ações uma após a outra.
#### Contato / Ticket
* **Atribuir etiqueta** / **Desatribuir etiqueta**
* **Alterar etapa**
* **Atualizar campos**
* **Atribuir executivo** / **Desatribuir executivos**
* **Notificar executivos atribuídos**
* **Marcar como ganho ou perdido**
* **Fechar ticket** / **Abrir ticket**
* **Obter ou criar contato**
* **Atualizar valor do ticket**
#### Conversacional
* **Enviar mensagem com IA**
* **Parar resposta da IA**
* **Enviar modelo:** Envia uma mensagem pré-aprovada do WhatsApp. Ideal quando já se passaram mais de 24 horas desde a última mensagem do cliente.
* **Enviar modelo de e-mail:** Envia um e-mail a partir de um modelo ou redigido por um agente, com diferentes opções de destinatário.
* **Enviar arquivo**
* **Enviar mensagem de voz**
* **Criar nota**
* **Enviar pesquisa de feedback**
* **Enviar mensagem**
* **Enviar mensagem agendada**
* **Ativar chamada de IA**
* **Rejeitar chamada (Novo):** Corta a chamada recebida. Disponível apenas depois de um nó **Chamada recebida**.
* **Roteirizar chamada (Novo):** Conecta a chamada recebida com um executivo ou com IA. Só aparece se você ativou "Decidir o roteamento neste fluxo" no nó **Chamada recebida** —ver [Como montar a lógica de Call Center com o nó Chamada recebida](/workflows/workflows-pt-br/como-montar-a-logica-de-call-center-com-o-no-chamada-recebida.md).
**Destinatários e conteúdo no nó Enviar modelo de e-mail**
Ao configurar esta ação, primeiro você escolhe o canal de e-mail de onde a mensagem será enviada. Depois define o destinatário:
| Destinatário | O que faz |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **E-mail do contato** | Envia o e-mail para o endereço do cliente associado ao ticket. |
| **Cargo interno** | Envia o e-mail para todos os executivos que tiverem o cargo que você selecionar. |
| **Executivo atribuído** | Envia o e-mail para os executivos atribuídos ao ticket. |
| **Personalizado** | Você define manualmente os campos Para, CC e CCO. Só aceita endereços internos: não permite inserir o e-mail do cliente. |
Para o conteúdo, você pode escolher um **modelo** já criado ou pedir a um **agente** que redija o e-mail. Se você escolher que um agente o escreva, você define o assunto e dá instruções sobre o que a mensagem deve incluir. Você também pode escolher qual agente redige o e-mail; se deixar o campo em branco, a Vambe usa o agente atribuído à etapa em que o ticket está. Quando o workflow é executado a partir de um evento dentro de uma conversa, o agente redige o e-mail com o contexto dessa conversa.
#### CRM
* **Obter ID de deal do CRM**
* **Obter ID de contato do CRM**
* **Atribuir ID de entidade do CRM**
* **Atribuir ID de contato do CRM**
#### Geral
* **Enviar webhook**
* **Executar função de IA**
* **Criar tarefa**
* **Adicionar linha ao Google Sheets**
* **Executar código**
* **Espera**
* **Sequência (Novo):** Agrupa vários nós que são executados em ordem, com esperas e condições de saída configuráveis entre cada um — ideal para lógicas de tentativa novamente. Ver [Sequências: agrupa tentativas sem duplicar nós](/workflows/workflows-pt-br/sequencias-agrupe-as-tentativas-sem-duplicar-nos.md).
* **Cancelar fluxo agendado**
* **Parar fluxo**
**Cancelamento inteligente no nó Espera**
O nó de Espera conta com opções de cancelamento automático.
| Opção de cancelamento | Quando usá-la |
| ---------------------------------- | ----------------------------------------------------------------- |
| **Cancelar ao mudar de etapa** | Se o ticket for movido para outra etapa, a espera é interrompida. |
| **Cancelar se o contato escrever** | Se o cliente responder durante a espera, ela é cancelada. |
| **Cancelar se um agente escrever** | Se um agente intervier manualmente, o fluxo é interrompido. |
***
#### Exemplos de uso ("Receitas")
#### 1. Reativar cliente inativo sem interromper se ele já respondeu
**Trigger:** Inatividade do contato (30 min, etapa: Qualificação) **Espera:** 5 minutos → Cancelar se o contato escrever **Ação:** Enviar mensagem com IA → reativar a conversa.
***
#### 2. Agente que não responde → Reatribuição automática
**Trigger:** Inatividade do agente (4 horas) **Ação 1:** Desatribuir executivos **Ação 2:** Atribuir etiqueta Sem atendimento **Ação 3:** Atribuir executivo (balanceado) **Ação 4:** Criar nota.
***
#### 3. Pós-venda inteligente: pesquisa + oferta de recompra
**Trigger:** Evento capturado (Order Created) **Espera:** 4 dias **Ação 1:** Enviar pesquisa de feedback (NPS) **Trigger 2:** NPS/CSAT respondido **Condição:** Pontuação maior que 8? **Ação 2 (Sim):** Enviar modelo com oferta de recompra.
***
#### 4. Lead scoring automático com alerta para o melhor agente
**Trigger:** Valor do ticket atualizado **Condição:** Valor maior que $1.000.000 **Ação 1:** Alterar etapa para Prioritário **Ação 2:** Atribuir executivo sênior **Ação 3:** Criar tarefa de chamada **Ação 4:** Adicionar linha ao Google Sheets.
***
#### 5. Fechamento automático de tickets abandonados + registro
**Trigger:** Inatividade do contato (2 dias) **Ação 1:** Marcar como perdido **Ação 2:** Atribuir etiqueta Abandonado **Ação 3:** Adicionar linha ao Google Sheets **Ação 4:** Fechar ticket.
***
#### 6. Automação por mudança de etapa no CRM
**Trigger:** Mudança de Etapa do CRM **Ação 1:** Enviar modelo de boas-vindas **Ação 2:** Alterar etapa **Ação 3:** Criar tarefa de chamada de boas-vindas.
***
#### 7. Automação para clientes problemáticos: alerta e acompanhamento
**Trigger:** Etiqueta atribuída Cliente Problemático **Ação 1:** Atribuir executivo de Suporte Sênior **Ação 2:** Criar nota **Ação 3:** Enviar mensagem com IA para desescalar **Ação 4:** Adicionar linha ao Google Sheets.
***
#### 8. Entrada de leads a partir de uma planilha do Google Sheets
**Trigger:** Linha inserida no Google Sheets **Ação 1:** Obter ou criar contato **Ação 2:** Enviar modelo de boas-vindas **Ação 3:** Atribuir etiqueta **Ação 4:** Atribuir executivo (balanceado).
***
#### 9. Tentativas de contato sem duplicar nós (Novo)
**Trigger:** Etiqueta atribuída **Ação:** Sequência — Ativar chamada de IA (condição de saída: chamada atendida, esperar 1 minuto se não) × 3 tentativas **Condição de sequência:** Condição cumprida ou Finalizada? Veja o detalhe completo em [Sequências: agrupa tentativas sem duplicar nós](/workflows/workflows-pt-br/sequencias-agrupe-as-tentativas-sem-duplicar-nos.md).
***
#### 10. Roteamento de chamadas recebidas conforme a etapa (Novo)
**Trigger:** Chamada recebida (decidir o roteamento neste fluxo ativado) **Condição:** Condição de etapa — Está em uma etapa humana? **Ação (Sim):** Alterar etapa para uma etapa com IA → Roteirizar chamada **Ação (Não):** Rejeitar chamada. Veja o detalhe completo em [Como montar a lógica de Call Center com o nó Chamada recebida](/workflows/workflows-pt-br/como-montar-a-logica-de-call-center-com-o-no-chamada-recebida.md).
***
#### 11. Boas-vindas e etiquetagem de leads que chegam de um anúncio (Novo)
**Trigger:** Evento capturado — Conversa iniciada a partir de anúncio do WhatsApp (CTWA) **Ação 1:** Atribuir etiqueta Lead de campanha **Ação 2:** Atribuir executivo de vendas **Ação 3:** Enviar mensagem com IA com as boas-vindas da campanha. Veja o detalhe completo em [Reaja em Workflows quando um contato chega a partir de um anúncio do WhatsApp (CTWA)](/workflows/workflows-pt-br/reaja-em-workflows-quando-um-contato-chega-a-partir-de-um-anuncio-do-whatsapp-ctwa.md).
***
#### 12. Modo de Teste
Antes de lançar seu workflow para o público, use o Modo de Teste para simular uma conversa e ver passo a passo como os triggers são ativados e se as condições são cumpridas ou falham.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://academy.vambe.ai/workflows/workflows-pt-br/readme.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
