> 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 **Fluxos de trabalho** são o motor de automação da Vambe. Semelhante a ferramentas como Zapier, esta funcionalidade permite criar cadeias de "Causa e Efeito" dentro da Vambe. **Para que servem?** Desde enviar uma mensagem de "Fora do Horário" nos fins de semana, até fazer uma pesquisa com um cliente 4 dias após uma compra no Shopify. Se ocorrer "X", a Vambe fará "Y". *** #### 1. Estrutura de um Fluxo Para criar um, vá até o menu lateral esquerdo de 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 rotularem alguém como "VIP". * **Campos atualizados:** Ex.: Se o status de um pedido mudar. * **Agente atribuído:** Quando um agente é atribuído ao ticket. * **Pontuação do lead atribuída:** Quando a pontuação do lead muda. * **Valor do ticket atualizado:** Quando o valor é modificado. * **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 no CRM (Novo):** É ativado quando um contato muda de etapa no HubSpot, Pipedrive ou Salesforce. Este gatilho simplifica a automação ao permitir que a Vambe reaja diretamente a movimentos no seu CRM, sem necessidade de configurar fluxos complexos na plataforma externa. Oferece opções para buscar apenas contatos já existentes na Vambe ou para criar um se não existir. Aprenda a [configurar este gatilho aqui](https://github.com/Jorgeprieto30/vambe-gitbook-docs/blob/main/workflows/como-configurar-trigger-cambio-etapa-crm.md). **E-commerce e Agendamento (Evento Capturado):** Fundamental para Shopify/WooCommerce. É ativado quando um pedido é criado (Order Created), um carrinho é recuperado ou uma consulta é agendada. **Conversacional:** * **Mensagem recebida em etapa humana:** Ideal para auto-respostas quando o agente não estiver 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. * **Ligação finalizada:** Quando uma ligação termina com o contato. * **Reação à mensagem:** Quando o contato reage a uma mensagem. * **Inatividade do contato (Novo):** É ativado quando o contato fica um tempo definido sem enviar uma mensagem. Permite configurar etapas específicas, duração e Espera Inteligente para respeitar horários úteis. * **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 preenche um formulário do Typeform. * **Linha inserida no Google Sheets (Novo):** É ativado quando uma nova linha é adicionada em uma planilha do Google Sheets. Requer autenticar uma conta Google no nó e selecionar a planilha e a aba que se deseja monitorar; a Vambe detecta automaticamente as colunas e as disponibiliza como variáveis. * **Flow ativado por IA:** É ativado quando uma função de um assistente o executa. * **Evento de erro:** É ativado quando ocorre um erro no fluxo.
**Triggers ativados por eventos externos** Alguns gatilhos, como Linha inserida no Google Sheets, são ativados a partir de um evento que ocorre fora da Vambe. Esses triggers têm duas particularidades importantes: 1. **Exigem uma conta conectada.** A autenticação é configurada diretamente no nó, onde você pode conectar uma nova conta ou gerenciar as existentes. Ao autorizar o acesso, selecione apenas as planilhas que você vai usar: se não selecionar nenhuma, a integração obtém acesso a todas. 2. **Não trazem um contato associado.** Como o evento não nasce de uma conversa, você deve adicionar uma ação de **Obter ou criar contato** imediatamente após o trigger e mapear os dados da linha (por exemplo, o telefone) para identificar o contato. Sem essa etapa, o fluxo falha ao ser executado. > A sincronização do evento externo pode levar um ou dois minutos desde que a linha é inserida até que o fluxo seja executado na Vambe. *** #### 3. Adicione Condições (Filtros) Uma vez ativado o trigger, você pode inserir "portas" lógicas. Se a condição for satisfeita (Sim), o fluxo segue um caminho; se não (Não), pode seguir outro ou parar. 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 R$ 1.000.000?". * **Condição de canal:** "O cliente fala por Instagram ou WhatsApp?". * **Avaliar com IA:** Usar inteligência artificial para decidir se o cliente atende a um requisito complexo. * **Condição aleatória:** Dividir o tráfego 50/50 (teste A/B).
*** #### 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** * **Marcar como ganho ou perdido** * **Fechar ticket** / **Abrir ticket** * **Obter ou criar contato** * **Atualizar valor do ticket** #### Conversacional * **Enviar mensagem com IA:** Gera uma mensagem usando inteligência artificial de acordo com o prompt que você definir. * **Enviar modelo:** Envia uma mensagem pré-aprovada do WhatsApp. Ideal quando já passaram mais de 24 horas desde a última mensagem do cliente. * **Enviar arquivo** * **Enviar mensagem de voz** * **Criar nota:** Deixa uma nota interna visível apenas para os agentes. * **Enviar pesquisa de feedback:** Envia uma pesquisa NPS ou CSAT diretamente ao contato. * **Enviar mensagem:** Mensagem de texto simples sem IA. * **Enviar mensagem agendada** * **Ativar ligação de IA** #### CRM * **Obter ID do deal do CRM** * **Obter ID do contato do CRM** * **Atribuir ID da entidade do CRM** * **Atribuir ID do contato do CRM** #### Geral * **Enviar webhook:** Envia um sinal para um sistema externo. * **Executar função de IA:** Ativa uma função configurada em um assistente. * **Criar tarefa** * **Adicionar linha ao Google Sheets:** Ideal para relatórios e registros externos. * **Executar código:** Para automações de alta complexidade em Python ou Javascript. Os resultados ficam disponíveis em nós posteriores por meio de `data`, `logs` e `errors`. * **Espera:** Pausa o fluxo por um tempo definido antes de continuar com a próxima ação. * **Cancelar fluxo agendado:** Cancela um fluxo que está em espera antes de ser executado. * **Parar fluxo:** Finaliza o fluxo nesse ponto. **Cancelamento inteligente no nó Espera** O nó de Espera conta com opções de cancelamento automático. Você pode ativar uma ou várias para que a espera seja interrompida se algo acontecer enquanto o fluxo estiver em pausa: | Opção de cancelamento | Quando usá-la | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | **Cancelar ao mudar de etapa** | Se o ticket for movido para outra etapa, a espera é interrompida. Evita executar ações sobre tickets que já avançaram. | | **Cancelar se o contato escrever** | Se o cliente responder durante a espera, ela é cancelada. Ideal para fluxos de reativação. | | **Cancelar se um agente escrever** | Se um agente intervier manualmente, o fluxo é interrompido. Evita que a automação interfira em conversas humanas ativas. |
*** #### 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 perguntando se o cliente ainda tem interesse."* *** #### 🚨 2. Agente que não responde → Reatribuição automática **Trigger:** Inatividade do agente (4 horas, etapa: Pendente enviar orçamento) **Ação 1:** Desatribuir executivos **Ação 2:** Atribuir etiqueta → *"Sem atendimento"* **Ação 3:** Atribuir executivo (balanceado) **Ação 4:** Criar nota → *"Cliente sem atendimento, entrar em contato imediatamente."* *** #### 🛍️ 3. Pós-venda inteligente: pesquisa + oferta de recompra **Trigger:** Evento capturado (Order Created) **Espera:** 4 dias → Cancelar ao mudar de etapa ✅ **Ação 1:** Enviar pesquisa de feedback (NPS) **Trigger 2:** NPS/CSAT respondido **Condição:** Pontuação maior que 8? **Ação 2 (Se sim):** Enviar modelo com oferta de recompra *** #### 🔥 4. Lead scoring automático com alerta ao melhor agente **Trigger:** Valor do ticket atualizado **Condição:** Valor maior que R$ 1.000.000 **Ação 1:** Alterar etapa → *"Prioritário"* **Ação 2:** Atribuir executivo → *agente sênior específico* **Ação 3:** Criar tarefa → *"Ligar para o cliente em menos de 1 hora"* **Ação 4:** Adicionar linha ao Google Sheets → registro de leads de alto valor *** #### 📋 5. Fechamento automático de tickets abandonados + registro **Trigger:** Inatividade do contato (2 dias, etapa: Inicial) **Ação 1:** Marcar como perdido **Ação 2:** Atribuir etiqueta → *"Abandonado"* **Ação 3:** Adicionar linha ao Google Sheets → Nome, telefone, etapa, data **Ação 4:** Fechar ticket *** #### 6. Automação por mudança de etapa no CRM **Trigger:** Mudança de etapa no CRM (Quando um contato entra em "Cotação aprovada" no HubSpot) **Ação 1:** Enviar modelo → *"Parabéns pela sua compra! Em breve, um membro da nossa equipe entrará em contato para coordenar os próximos passos."* **Ação 2:** Alterar etapa (na Vambe) → *"Cliente ativo"* **Ação 3:** Criar tarefa → *"Realizar ligação de boas-vindas em 24 horas."* *** #### 7. Automação para clientes problemáticos: Alerta e acompanhamento **Trigger:** Etiqueta atribuída ("Cliente Problemático") **Condição:** (Opcional, ex.: Canal = "WhatsApp" para gestão específica) **Ação 1:** Atribuir executivo → *"Agente Sênior de Suporte"* **Ação 2:** Criar nota → *"Cliente rotulado como problemático. Revisar histórico para oferecer uma solução proativa."* **Ação 3:** Enviar mensagem com IA → *"\[Mensagem criada para desescalar a situação e propor uma resolução, adaptada ao contexto]."* **Ação 4:** Adicionar linha ao Google Sheets → *"Registro de incidentes para análise e melhoria contínua."* *** #### 📄 8. Entrada de leads a partir de uma planilha do Google Sheets **Trigger:** Linha inserida no Google Sheets (planilha "Leads", aba "Formulário web") **Ação 1:** Obter ou criar contato → mapear a coluna de telefone e de nome a partir das variáveis da linha **Ação 2:** Enviar modelo → *mensagem de boas-vindas* **Ação 3:** Atribuir etiqueta → *"Lead da planilha"* **Ação 4:** Atribuir executivo (balanceado) *** #### 9. Modo de teste Antes de lançar seu workflow para o público, utilize o Modo de teste. Esta ferramenta permite simular uma conversa e ver passo a passo como os triggers são ativados e se as condições são atendidas ou falham, garantindo que sua lógica esteja perfeita antes de afetar clientes reais. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.