Construindo Fluxos

Orientações práticas sobre construção de fluxos

Por Fabrício Rissetto and 4 outros

• 8 artigos

Como enviar variáveis para fluxos do Fluxo Controlado (sem perguntar de novo ao cliente)

Quando usar - Você quer que o Fluxo Controlado aproveite dados que o cliente já deu na conversa com a ClaudIA, sem perguntar de novo - Você precisa entender quais variáveis padrão a ClaudIA envia automaticamente para o Fluxo Controlado (helpdeskId, channelType etc.) - Você quer ativar o extrator de variáveis para tornar a experiência mais fluida Pré-requisitos - Workspace do Fluxo Controlado criado e fluxo configurado - Seção interativa na ClaudIA configurada para acionar o fluxo Sobre este artigo O Fluxo Controlado tem dois mecanismos para receber dados antes mesmo de pedir ao cliente: as variáveis padrão (sempre enviadas pela ClaudIA) e o extrator de variáveis (que lê o histórico da conversa via LLM e preenche campos do fluxo). Este artigo cobre os dois — e explica como funciona o acionamento de um Fluxo Controlado pela ClaudIA. Detalhes Visão geral — campo Placeholder O campo Placeholder dos cards Input permite que o Fluxo Controlado aproveite dados já informados pelo cliente na conversa com a ClaudIA, sem precisar perguntar de novo. Basta descrever no Placeholder qual dado você quer capturar. Essa descrição funciona como um "prompt" para a ClaudIA procurar a informação no ticket/conversa e preencher a variável automaticamente. :::info Exemplo: se o Placeholder for "E-mail do usuário" e existir um e-mail no histórico, a ClaudIA o extrai (via LLM) e preenche a variável definida no fluxo. A response daquele Input não é disparada e a pergunta não se repete. ::: Variáveis padrão enviadas pela ClaudIA Estas variáveis chegam automaticamente ao fluxo, sem nenhuma configuração adicional. Todas em formato texto (string). Algumas podem vir vazias, outras sempre têm valor. | Variável | Descrição | | --- | --- | | helpdeskId | Identificador do ticket no help desk. Usado para localizar um ticket específico | | cloudChatId | Código único da conversa no CloudChat. Sempre presente | | activeIntent | Intenção (tópico) detectada na conversa atual. Se nenhuma for identificada, recebe DEFAULT | | channelType | Canal de origem: EMAIL WHATSAPP SMS CHAT FORM FACEBOOK INSTAGRAM NO_TYPE_PROVIDED | | language | Idioma detectado (pode ser nulo): pt-BR en es fr de it ja ko zh ru ar hi nl sv da fi pl tr | | createdAt | Data e hora de início da conversa | | frustrationScore | Nível de frustração calculado pela ClaudIA. 0 = sem frustração; valores maiores = maior insatisfação | | abKey | Chave de teste A/B (pode ser nula — nem toda conversa entra em A/B) | | lastUserMessages | Últimas mensagens enviadas pelo cliente desde a última resposta do agente | | messages | Histórico completo da conversa em formato texto | Formato do histórico de messages: USER: olá AGENT: Oi, eu sou a ClaudIA. Como posso te ajudar? USER: então... queria saber como fazer [...] AGENT: Entendi! Para fazer isso basta [...] Para usar essas variáveis no fluxo, basta criar um card Condition: Extrator de variáveis (do histórico) Por padrão, os Fluxos Controlados pedem ao cliente todas as informações necessárias (número do pedido, e-mail etc.). Mas muitas vezes essas informações já foram dadas antes na conversa. Pedir de novo é UX ruim. O extrator de variáveis analisa o histórico da conversa, coleta os dados necessários e os envia ao Fluxo Controlado no momento da ativação — eliminando perguntas redundantes. Características: - Verifica o fluxo do Fluxo Controlado dinamicamente para saber quais variáveis precisam ser coletadas - A extração é feita pelo GPT via prompt definido no código da ClaudIA - Os dados coletados podem ser conferidos na auditoria do Hub Como configurar (dentro do Fluxo Controlado): Para que uma variável seja extraída, é necessário: 1. Bloco input com o placeholder preenchido, descrevendo a variável (ex: "Número do pedido no formato IN-XXXXXX") 2. Condicional is set precedendo a variável, que verifica se ela já tem valor — assim você controla o que acontece se o extrator já preencheu Acionamento do Fluxo Controlado pela ClaudIA 1 — Como o Fluxo Controlado é acionado Um Fluxo Controlado é acionado pela ClaudIA via seção utilizada (detalhado em Como funciona a seção utilizada pela ClaudIA). Passo a passo: 1. Usuário envia uma mensagem 2. ClaudIA analisa as responses das seções disponíveis 3. ClaudIA aciona o Fluxo Controlado da seção com response mais adequada à mensagem do cliente 4. Se duas seções de Fluxo Controlado forem selecionadas, prevalece a de maior score 2 — Como ocultar a response da seção interativa Para que a response seja omitida, o Fluxo Controlado precisa ter acesso à primeira variável coletada no fluxo. :::info Exemplo: se a response contiver o texto "Qual o número do seu pedido?", a ClaudIA omitirá a pergunta caso o usuário já tenha informado o número do pedido. Para isso funcionar, é obrigatório preencher o Placeholder no card de coleta da variável. ::: Observações - Para aprender o passo a passo de criar um Fluxo Controlado do zero: Como lançar um novo Fluxo Controlado passo a passo - Para usar todos os botões da plataforma: Como usar as funcionalidades e botões básicos do Fluxo Controlado - Para evitar erros comuns: Como identificar e evitar falhas nos fluxos e requisições do Fluxo Controlado - Para casos em que a ClaudIA inicia direto em um fluxo: Como configurar a ClaudIA para iniciar em um Fluxo Controlado (Start with Fluxo Controlado)

Última atualização em Jul 10, 2026

Como criar um fluxo no Fluxo Controlado com API externa

Quando usar - Você precisa conectar o Fluxo Controlado a uma API externa (status de pedido, consulta de CEP, validação de CPF etc.) - Você quer aprender o fluxo completo — input do cliente → request HTTP → mapeamento da resposta → resposta formatada - Você precisa lidar com entradas inválidas ou retornos vazios da API Pré-requisitos - Workspace do Fluxo Controlado criado - URL e método (GET/POST) da API externa que será consultada - (Se aplicável) Headers de autenticação prontos (token, API key) Sobre este artigo Este guia ensina, passo a passo, como construir um Fluxo Controlado que recebe uma entrada do usuário, faz uma requisição HTTP, extrai os dados retornados, retorna uma resposta formatada para a ClaudIA — ou direciona para N2 quando algo não dá certo. Vídeo do passo a passo Passo a passo Etapa 1 — Criar um novo fluxo no Fluxo Controlado 1. Acesse o Fluxo Controlado e clique em Criar um Typebot 2. Comece do zero (Blank bot) Etapa 2 — Definir o ponto de partida (input do usuário) 1. Crie um bloco de input de texto 2. Salve a entrada do usuário (ex: CEP) numa variável (ex: cep) Etapa 3 — Configurar a chamada de API 1. Adicione um bloco do tipo HTTP Request 2. No campo URL, cole o endpoint da API (ex: https://viacep.com.br/ws/{{cep}}/json) 3. Certifique-se de que a variável esteja entre chaves duplas: {{cep}} 4. Método: GET (ou POST conforme a API) Etapa 4 — Testar o request 1. Clique em Test Request 2. Adicione um valor real de teste (ex: 01025-020) 3. Se o teste falhar, verifique se o link começa com https:// Etapa 5 — Mapear os campos de resposta Depois que o request funcionar, extraia os dados relevantes do JSON retornado em variáveis individuais (ex: endereco, bairro, cidade, uf, ddd). Etapa 6 — Montar a resposta formatada Crie um bloco de texto com a resposta para o cliente, usando as variáveis extraídas: "O CEP {{cep}} corresponde à rua {{endereco}}, no bairro {{bairro}}, cidade de {{cidade}}/{{uf}}, DDD {{ddd}}." Etapa 7 — Lidar com entradas inválidas (CEP que não existe) 1. Use um bloco Condition 2. Verifique se a variável endereco existe: - Se sim, siga com a resposta - Se não, envie "Não encontramos esse CEP" e retorne à ClaudIA ou redirecione para N2 Etapa 8 — Devolver para a ClaudIA - No final do fluxo, use o bloco Retornar para a Cloud - Se o dado foi encontrado: retorne uma resposta amigável - Se não: envie texto sinalizando que a ClaudIA deve escalar para N2 "Não encontrei o status. Por favor, transfira." Etapa 9 — Publicar e testar com tickets reais 1. Clique em Publicar no topo da tela 2. O fluxo estará disponível para testes reais com tickets na IDS Etapa 10 — Tratar entradas com formatação incorreta Se o usuário digitar o CEP com traços, espaços ou pontos (ex: 01.025-020), use blocos intermediários para sanitizar a entrada (remover caracteres especiais). :::info Dica: use blocos de transformação de texto ou scripts JavaScript no Fluxo Controlado para sanitização customizada. ::: Conclusão :::success Com esse fluxo, você: - Automatiza buscas externas via API - Personaliza a resposta para o cliente - Escala para humano apenas quando necessário - Replica o modelo para consultas de status de pedido, rastreio, CPF etc. ::: Observações - Para fluxo via Google Sheets em vez de API: Como criar um fluxo no Fluxo Controlado acessando informações em um Google Sheets - Para evitar falhas em chamadas de API: Como identificar e evitar falhas nos fluxos e requisições do Fluxo Controlado - Para reduzir erros e aumentar retenção: Como reduzir erros de chamada do Fluxo Controlado para aumentar a retenção - Para entender as variáveis padrão enviadas pela ClaudIA: Como enviar variáveis para fluxos do Fluxo Controlado

Última atualização em Jun 24, 2026

Como criar um Fluxo Controlado acessando informações em um Google Sheets

Quando usar - Você tem dados em uma planilha Google Sheets (status de pedidos, agendamentos, saldo, elegibilidade) e quer que o Fluxo Controlado consulte direto na planilha - Você atualiza essa planilha manualmente ou via automação (dump horário do sistema, por exemplo) - Você não tem (ou não quer expor) uma API para esse caso de uso Pré-requisitos - Planilha Google Sheets com cabeçalho na primeira linha e dados estruturados - Uma conta Google (Gmail pessoal ou corporativo — não precisa ser um e-mail @cloudhumans) com acesso a essa planilha, para conectar a integração Sobre este artigo A integração Google Sheets permite que o Fluxo Controlado consulte uma planilha como se fosse uma base de dados — útil quando você precisa retornar status, valores ou flags simples sem expor uma API. Vídeo do passo a passo :::info 📌 Atualização: o vídeo acima menciona a necessidade de conectar um e-mail com domínio @cloudhumans. Isso não é mais necessário — você pode conectar qualquer conta Google (Gmail pessoal ou corporativo) que tenha acesso à planilha. ::: Exemplo de uso Vamos usar uma planilha com duas colunas: - id — código do pedido - status — situação atual (ex: "em andamento", "entregue", "atrasado") Passo a passo Etapa 1 — Criar um novo Fluxo Controlado Crie um novo Fluxo Controlado e defina o ponto de entrada com um input de texto, para que o cliente informe o número do pedido. Dê à variável um nome descritivo, como id_pedido. Etapa 2 — Conectar o Google Sheets Na aba Integrações, selecione Sheets: - Se sua conta ainda não estiver conectada, conecte sua própria conta Google (qualquer Gmail — pessoal ou corporativo) que tenha acesso à planilha. Não é mais necessário usar um e-mail @cloudhumans nem solicitar um e-mail de serviço ao time da Cloud Humans - Escolha a planilha, a aba correta e a linha de cabeçalho (geralmente 1) - Use a operação Get data - Aplique um filtro: coluna id == {{id_pedido}} Etapa 3 — Extrair a informação desejada Escolha a coluna status como saída e armazene em uma nova variável (ex: status_resposta). Etapa 4 — Retornar a resposta ao cliente Use um bloco de texto para formatar a mensagem: "Seu pedido está com o seguinte status: {{status_resposta}}." Para testar, basta clicar em Visualizar e usar um ID real (ex: 234567). Etapa 5 — Definir regras de encaminhamento para N2 Use blocos condicionais para redirecionar automaticamente: - Se status_resposta == "atrasado" → envie a conversa para N2 (atendimento humano) - Caso contrário, siga com o atendimento padrão Etapa 6 — Encerrar ou transferir o atendimento Ao final do fluxo, use o bloco Retornar para a Cloud e defina: - Nenhum → apenas encerra o fluxo com a resposta para o cliente - N2 → sinaliza que a ClaudIA deve transferir para um humano Etapa 7 — Publicar e testar com tickets reais Clique em Publicar. Só após isso o fluxo estará disponível para testes reais com a ClaudIA, inclusive no Hub / Playground. Conclusão :::success Com esse fluxo você: - Automatiza a busca de dados no Google Sheets - Evita respostas manuais e erros de digitação - Escala para humano apenas quando necessário (ex: atraso) - Replica o modelo para consulta de CPF, agendamentos, elegibilidade, e outros casos ::: Observações - Para fluxo via API externa: Como criar um Fluxo Controlado com API externa - Para transformar Google Sheets em uma API consultável: Como transformar seu Google Sheets em uma API - Para boas práticas de Google Sheets como fonte de dados: Requisitos de Google Sheets para utilização no Fluxo Controlado - Para evitar falhas em integrações: Como identificar e evitar falhas nos fluxos e requisições do Fluxo Controlado

Última atualização em Jul 01, 2026

Como configurar a ClaudIA para iniciar em um Fluxo Controlado (Start with Fluxo Controlado)

Quando usar - Você quer que toda nova conversa abra direto em um Fluxo Controlado (e não na ClaudIA conversacional) - Sua operação tem fluxos curtos e controlados (triagem inicial, coleta de leads, validação obrigatória) - Você precisa ler ou atualizar dados em sistemas externos logo no início do atendimento Pré-requisitos - Acesso de administrador ao Hub do projeto ClaudIA - Um Fluxo Controlado publicado que receberá todas as conversas - Flow ID do fluxo (encontrado na tela de publicação no Fluxo Controlado) Sobre este artigo Por padrão, a ClaudIA direciona as interações para o Fluxo Controlado apenas em casos de seções interativas. Mas é possível configurá-la para que todas as sessões sejam iniciadas diretamente em um Fluxo Controlado — útil para triagens simples (coleta de leads) ou operações automatizadas que se beneficiam de um caminho fixo no início. :::info Embora a ClaudIA seja projetada como uma IA conversacional avançada — afastando-se do conceito tradicional de "bots de árvore de decisão" — fluxos curtos e controlados podem ser muito vantajosos quando precisamos acessar sistemas externos para leitura ou atualização de dados, garantindo operações rápidas e precisas. ::: Passo a passo Etapa 1 — Acessar a configuração no Hub Na tela de configurações do Hub, localize a seção Start With Fluxo Controlado. Etapa 2 — Habilitar o redirecionamento 1. Marque o checkbox para habilitar o redirecionamento 2. Insira o Flow ID do Fluxo Controlado no campo correspondente Configuração Start with Fluxo Controlado :::success Pronto! Agora toda conversa nova começará pelo Fluxo Controlado selecionado, mantendo o equilíbrio entre automação eficiente e uma experiência de atendimento dinâmica. ::: Boas práticas :::warning - Use fluxos curtos no Start with Fluxo Controlado. Fluxos longos transformam o atendimento em "bot de árvore" e prejudicam a experiência - Sempre termine o fluxo com End Flow ou Answer Ticket para que a ClaudIA possa retomar a conversação - Teste antes de ativar em produção — toda conversa começará pelo fluxo, então qualquer bug afetará 100% dos clientes ::: Observações - Para criar um Fluxo Controlado do zero: Como lançar um novo Fluxo Controlado passo a passo - Para entender as terminações de fluxo (End Flow vs Answer Ticket): Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket - Para usar variáveis padrão (helpdeskId, channelType etc.): Como enviar variáveis para Fluxos Controlados

Última atualização em Jun 24, 2026

Como testar fluxos do Fluxo Controlado via API

Quando usar - Você quer automatizar testes de Fluxos Controlados em CI/CD ou via Postman/Insomnia - Você precisa validar interações programaticamente antes de publicar em produção - Você está integrando o Fluxo Controlado com outro sistema que precisa enviar mensagens via HTTP Pré-requisitos - Workspace do Fluxo Controlado com pelo menos um fluxo criado - API Token do Fluxo Controlado gerado (passo a passo abaixo) - Cliente HTTP (Postman, Insomnia, curl etc.) Sobre este artigo A API do Fluxo Controlado permite iniciar e continuar conversas automaticamente com fluxos criados, via chamadas HTTP. Essa funcionalidade é ideal para testes automatizados e validação de fluxos antes de publicar. Visão geral da integração A comunicação com o Fluxo Controlado é feita em duas etapas: 1. Início da conversa — cria uma nova sessão de chat 2. Continuidade da conversa — envia mensagens dentro da sessão criada As chamadas usam endpoints HTTP autenticados com token Bearer e o ID do fluxo criado no Fluxo Controlado. Passo a passo Etapa 1 — Obter o ID do fluxo Cada fluxo criado no Fluxo Controlado possui um identificador único (ID), usado para iniciar a sessão via API. Esse ID pode ser copiado: - Diretamente da URL de edição do fluxo - Ou da tela de publicação Onde encontrar o ID do fluxo Etapa 2 — Iniciar uma nova sessão de conversa Endpoint: POST https://eddieeyes.us-east-1.prd.cloudhumans.io/api/v1/typebots/ID_DO_FLUXO/startChat Headers obrigatórios: - Content-Type: application/json - Authorization: Bearer {{apiToken}} Resposta esperada: { "sessionId": "abc123xyz" } :::warning O sessionId é essencial para os próximos passos. Guarde-o assim que receber. ::: Etapa 3 — Enviar mensagens para continuar o chat Endpoint: POST https://eddieeyes.us-east-1.prd.cloudhumans.io/api/v1/sessions/{{sessionId}}/continueChat Headers: - Content-Type: application/json - Authorization: Bearer {{apiToken}} Body: { "message": "mensagem do usuário" } Resposta: objeto JSON com a próxima interação gerada pelo Fluxo Controlado com base na lógica do fluxo. Como gerar um API Token Para autenticar as chamadas via API, você precisa de um API Token. Siga os passos abaixo: Geração do API Token 1. Clique em Configurações e membros no canto superior direito da tela 2. No menu lateral, selecione Minha conta 3. Na seção API tokens, clique em Criar para gerar um novo token :::error Trate o token como uma senha — qualquer pessoa com acesso a ele pode iniciar e continuar conversas em todos os fluxos do seu workspace. Não cole em commits, logs ou Slack público. ::: Boas práticas para uso da API Armazenamento e reuso do sessionId Guarde o sessionId gerado para cada conversa. Ele é necessário para manter a continuidade da interação com o mesmo contexto. Testes antes da integração final Use Postman ou Insomnia para validar: - Endpoints - Headers - Corpo (body) e respostas Isso evita erros no ambiente de produção. Monitoramento de erros Falhas em chamadas (dados inválidos, endpoints incorretos, timeout) aparecem no Hub com sinalização de erro. Use essas informações para diagnóstico rápido. Observações - Para entender as chamadas de API que o Fluxo Controlado faz internamente: Como criar um fluxo no Fluxo Controlado com API externa - Para reduzir falhas em chamadas: Como reduzir erros de chamada do Fluxo Controlado para aumentar a retenção - Para entender requisitos de API que o Fluxo Controlado consome: Requisitos de API para utilização no Fluxo Controlado

Última atualização em Jun 24, 2026

Como configurar um fluxo de Status Page (Atlassian Statuspage e Instatus) no Fluxo Controlado

Quando usar - Você usa Statuspage by Atlassian ou Instatus para reportar status do seu produto - Você quer que o Fluxo Controlado consulte automaticamente a status page e responda ao cliente sobre instabilidades em curso - Você quer que tickets sobre instabilidade sejam encerrados automaticamente quando há uma incidência reportada (e devolvidos à ClaudIA caso contrário) Pré-requisitos - Workspace do Fluxo Controlado criado - URL da Status Page pública do produto - (Se for Atlassian Statuspage ou Instatus) o modelo pronto disponibilizado abaixo :::error A Status Page precisa ser pública (acessível sem autenticação). Páginas privadas ou que exijam credenciais não são suportadas pelo modelo. ::: Sobre este artigo Esta FAQ e os modelos foram criados exclusivamente para consultar e retornar o estado de páginas de status hospedadas no Statuspage by Atlassian e no Instatus. Não funciona com outras soluções de status page. O fluxo retorna informações úteis ao usuário: se há componentes não-operacionais, ele lista e fecha o ticket; caso contrário, devolve à ClaudIA. O que já disponibilizamos Modelos prontos para download — arquivos com fluxo configurado para importação no Fluxo Controlado. Os modelos já incluem variáveis, mensagens e scripts pré-configurados: - Download do modelo — Atlassian Statuspage - Download do modelo — Instatus :::warning Atente-se ao modelo escolhido — Atlassian Statuspage e Instatus têm formatos de API diferentes; um modelo não funciona para o outro. ::: Passo a passo Vídeo do passo a passo Etapa 1 — Baixar o modelo Acesse o arquivo .json do fluxo no Drive (links acima). Etapa 2 — Importar no Fluxo Controlado Entre no Typebot e clique em Create a Flow. Create a Flow Etapa 3 — Fazer o upload do fluxo Selecione Import a file e importe o arquivo modelo baixado. Import a file Etapa 4 — Localizar a variável STATUSPAGE_URL Abra o fluxo importado e encontre a variável STATUSPAGE_URL no editor. Variável STATUSPAGE_URL Etapa 5 — Inserir a URL real Cole, dentro das aspas, o link real da Status Page que você quer monitorar. Inserindo a URL Etapa 6 — Publicar o fluxo Quando estiver satisfeito, publique o fluxo para que ele esteja disponível para criar conteúdos interativos. :::success Pronto. Daqui em diante, todo ticket que cair nesse fluxo consulta a status page em tempo real e devolve a resposta correta — instabilidade reportada → fecha o ticket; tudo operacional → devolve à ClaudIA. ::: Limitações conhecidas :::warning - Páginas privadas ou protegidas por autenticação não podem ser lidas pelo fluxo — o modelo não implementa OAuth nem API keys - Formato dos dados — alterações profundas na API do Statuspage/Instatus ou no formato público da página podem exigir atualização do fluxo ::: Observações - Para entender HTTP Requests no Fluxo Controlado: Como criar um fluxo no Fluxo Controlado com API externa - Para usar todos os botões da plataforma: Como usar as funcionalidades e botões básicos do Fluxo Controlado - Para evitar falhas em chamadas externas: Como identificar e evitar falhas nos fluxos e requisições do Fluxo Controlado

Última atualização em Jun 24, 2026

Como abrir uma conversa paralela no Zendesk via Fluxo Controlado

Quando usar - Você usa Zendesk e quer que o Fluxo Controlado abra uma conversa paralela (Side Conversation) dentro de um ticket existente - Você precisa envolver outro time/departamento automaticamente quando o Fluxo Controlado identifica determinado caso - Você quer personalizar título, corpo e grupo de destino com variáveis do fluxo Pré-requisitos - Conta Zendesk com permissão para criar Side Conversations via API - Token de API Zendesk convertido em base64 (formato email/token:API_TOKEN) - ID do support_group que receberá a conversa paralela - helpdeskId (ID do ticket no Zendesk) disponível no Fluxo Controlado — vem da ClaudIA via variável padrão Sobre este artigo A Side Conversation é uma funcionalidade do Zendesk que permite abrir um novo canal de comunicação dentro de um ticket existente. Esse artigo mostra como disparar uma Side Conversation a partir do Fluxo Controlado usando um bloco HTTP Request — útil para envolver times de retaguarda, suporte avançado ou outras áreas conforme o caso identificado pelo fluxo. Passo a passo Fluxo com Side Conversation Etapa 1 — Adicionar bloco HTTP Request No final da ramificação do fluxo onde você quer abrir a conversa paralela, adicione um bloco do tipo HTTP Request. Etapa 2 — Configurar o método - Método: POST Etapa 3 — Configurar a URL https://conta.zendesk.com/api/v2/tickets/{{helpdeskId}}/side_conversations - Substitua conta.zendesk.com pela URL do seu Zendesk - {{helpdeskId}} é a variável do ID do ticket (vem automaticamente da ClaudIA — ver Como enviar variáveis para fluxos do Fluxo Controlado) Configuração URL Etapa 4 — Adicionar headers { "Authorization": "Bearer SEU_TOKEN_AQUI", "Content-Type": "application/json" } :::error Substitua SEU_TOKEN_AQUI pelo seu token de API Zendesk convertido em base64. Não comite o token em fluxos compartilhados publicamente. ::: Etapa 5 — Configurar o body (corpo da requisição) Use o seguinte JSON: { "message": { "subject": "Titulo", "body": "corpo", "to": [ { "support_group_id": ID_DO_GRUPO } ] } } | Campo | O que colocar | | --- | --- | | subject | Título da conversa paralela | | body | Mensagem a ser enviada | | support_group_id | ID do grupo de suporte que receberá a conversa | Você pode usar variáveis do Fluxo Controlado como {{nome}}, {{mensagem}}, {{detalhes}} etc. para personalizar. Etapa 6 — Exemplo com variáveis do Fluxo Controlado { "message": { "subject": "Novo pedido de {{nome}}", "body": "O cliente {{nome}} fez um novo pedido com os seguintes detalhes: {{detalhes}}", "to": [ { "support_group_id": 123456 } ] } } Onde adicionar no fluxo Adicione o bloco HTTP na ramificação do fluxo onde você quer que a conversa paralela seja criada (depois de uma condição que identifique o caso). Exemplo de fluxo com abertura de conversa paralela Exemplo de fluxo com abertura de conversa paralela usando API do Zendesk Observações - Para entender variáveis padrão como helpdeskId: Como enviar variáveis para fluxos do Fluxo Controlado - Para conectar o Fluxo Controlado a APIs externas em geral: Como criar um Fluxo Controlado com API externa - Para evitar falhas em chamadas: Como identificar e evitar falhas nos fluxos e requisições do Fluxo Controlado

Última atualização em Jun 24, 2026

Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket

Quando usar - Você está construindo um Fluxo Controlado e precisa escolher como ele termina - Você quer entender a diferença prática entre as 4 opções de finalização - Você está debugando um fluxo onde a finalização se comporta diferente do esperado Pré-requisitos - Conhecimento básico de construção de Fluxos Controlados - Saber a partir de onde o fluxo começa: por uma seção da ClaudIA ou direto na entrada do cliente Sobre este artigo Ao construir um Fluxo Controlado, você precisa definir como ele será encerrado. Essa escolha determina o que acontece com o atendimento depois que o Fluxo Controlado termina sua execução. Existem quatro opções de finalização, cada uma com efeitos diferentes em bubble visível ao cliente, continuidade na ClaudIA e uso de contexto anterior. Detalhes End Flow [N1] Quando este card é utilizado, o fluxo é encerrado e o atendimento é passado de volta para a ClaudIA. A bubble de texto configurada antes do End Flow é enviada para o cliente. Após o envio, a ClaudIA continua o atendimento a partir dali, sem aproveitar o contexto anterior da conversa. Por isso, é importante incluir na bubble algo como "Como posso te ajudar?" ou "Qual é a sua dúvida?", para que o cliente saiba que pode continuar interagindo. Quando usar: ideal para Fluxos Controlados ativados a partir de uma seção da ClaudIA (o atendimento já havia começado pela ClaudIA antes de entrar no Fluxo Controlado). Answer Ticket [N1] Quando este card é utilizado, a ClaudIA aproveita o contexto anterior da conversa para continuar o atendimento. Antes do Answer Ticket ser acionado, o cliente já pode ter enviado alguma mensagem — seja um "oi" que ativou um fluxo inicial, ou uma pergunta que acionou algum conteúdo. A ClaudIA usa esse histórico para seguir as respostas de forma contextualizada. :::warning A bubble de texto colocada antes do Answer Ticket não é enviada para o cliente. Ela é consumida pela ClaudIA como contexto interno. Por isso, não é obrigatório fazer uma pergunta na bubble — a ClaudIA já usa o histórico da conversa. ::: :::error É obrigatório haver uma bubble de texto antes do Answer Ticket com algum conteúdo escrito. Sem isso, o funcionamento pode quebrar e gerar erro no Fluxo Controlado. ::: Quando usar: ideal para casos em que o Fluxo Controlado inicia o atendimento (antes de qualquer interação com a ClaudIA). Close Ticket [N1] Quando este card é utilizado, o ticket é encerrado em N1 ao final da execução do Fluxo Controlado. O atendimento é considerado resolvido e finalizado. Caso o cliente envie uma nova mensagem depois do encerramento, um novo ticket será aberto. Quando usar: ideal para fluxos em que a resposta do Fluxo Controlado já é suficiente para resolver a demanda do cliente, sem necessidade de continuidade com a ClaudIA. Forward to Human [N2] Quando este card é utilizado, o ticket é escalado para um agente humano (N2). A ClaudIA encerra a sua atuação e transfere o atendimento para a equipe de suporte humano do cliente. Quando usar: ideal para fluxos que identificam casos complexos ou sensíveis que precisam de atenção humana. :::warning Sempre coloque uma bubble de texto antes do card Forward to Human [N2]. ::: Resumo comparativo | Finalização | Encerra o ticket? | Bubble vai ao cliente? | Aproveita contexto anterior? | Continua com ClaudIA? | | --- | --- | --- | --- | --- | | End Flow | Não | ✅ Sim | ❌ Não | ✅ Sim | | Answer Ticket | Não | ❌ Não (contexto interno) | ✅ Sim | ✅ Sim | | Close Ticket | ✅ Sim | ✅ Sim | — | ❌ Não | | Forward to Human | ✅ Sim (vai p/ N2) | ✅ Sim | — | ❌ Não | Observações - Para o passo a passo de criar um Fluxo Controlado do zero (incluindo escolha de finalização): Como lançar um novo Fluxo Controlado passo a passo - Para entender a interação ClaudIA + Fluxo Controlado: Como funciona a interação entre ClaudIA e o Fluxo Controlado - Para fluxos onde a ClaudIA inicia direto no Fluxo Controlado: Como configurar a ClaudIA para iniciar em um Fluxo Controlado (Iniciar com Fluxo Controlado)

Última atualização em Jun 24, 2026