Principal Como solicitar um Fluxo Controlado ao time Cloud Humans
💡

Como solicitar um Fluxo Controlado ao time Cloud Humans

Boa práticas para solicitar um Eddie ao time Cloud Humans
Tech
Por Tech and 1 outro
• 6 artigos

Como solicitar um Fluxo Controlado ao time Cloud Humans (comece por aqui)

Quando usar - Você quer automatizar uma ação da ClaudIA (consulta de status, validação, atualização cadastral) e precisa que o time Cloud Humans construa o fluxo - Você nunca solicitou um fluxo antes e quer entender o que enviar e por onde começar - Você precisa do caminho oficial de submissão para acelerar a entrega Pré-requisitos - Ter um Account Manager (AM) designado pela Cloud Humans para sua conta - Conhecer o caso de uso que você quer automatizar (com regras de negócio claras) - Ter ou conseguir a especificação técnica do sistema que será consultado (API ou Google Sheets) Sobre este artigo Este FAQ orienta sua equipe a solicitar novos Fluxos Controlados automatizados para a ClaudIA, garantindo que tudo seja enviado de forma clara, completa e padronizada. Isso evita retrabalho, acelera implementações e aumenta a assertividade das respostas da ClaudIA. O que enviar para solicitar um novo Fluxo Controlado Para solicitar um novo fluxo, sua empresa deve enviar dois pacotes de informação: 1. Descrição de negócio do fluxo - O que ele deve fazer - Quando é acionado - Quais dados o usuário deve fornecer - Regras de negócio - Exemplos de conversa desejada → Detalhes em Como especificar o fluxo (Parte 1 — Negócio) 2. Especificação técnica completa - Endpoints - Payloads - Respostas possíveis (200, 400, 404, 500) - Autenticação - Limites e demais configurações de integração → Detalhes em Especificação técnica do fluxo (Parte 2 — Tech Layer) Exemplo de fluxo bem especificado Exemplo de fluxo bem especificado :::success Com essas duas partes completas, a Cloud Humans consegue configurar o fluxo rapidamente e permitir que a ClaudIA execute ações automatizadas no seu atendimento. ::: Como submeter o pedido :::error Todas as solicitações devem ser enviadas exclusivamente por meio do Account Manager (AM) responsável pela sua conta. O AM: - Valida o pedido - Revisa se todas as informações necessárias foram incluídas - Encaminha ao time técnico da Cloud Humans para implementação ::: Sobre priorização :::info O Time de Fluxos Controlados prioriza construções de fluxos com foco em retenção de novos casos pela ClaudIA. Consulte seu AM sobre pacotes extras de Professional Service (sob custo adicional) para construção de fluxos gerais que estejam fora desse escopo. ::: Observações - Para a Parte 1 (orientações de negócio): Como especificar o fluxo (Parte 1 — Negócio) - Para a Parte 2 (especificação técnica): Especificação técnica do fluxo (Parte 2 — Tech Layer) - Para requisitos de API: Requisitos de API para utilização no Fluxo Controlado - Para requisitos de Google Sheets: Requisitos de Google Sheets para utilização no Fluxo Controlado - Para o documento modelo de especificação de API: Documento de especificação de API

Última atualização em Jun 24, 2026

Como especificar um Fluxo Controlado — Parte 1 (orientações de negócio)

Quando usar - Você quer solicitar um novo Fluxo Controlado e está preparando a especificação de negócio - Você precisa estruturar gatilho, dados de entrada, regras de negócio e finalização - Você quer um template para enviar ao seu Account Manager Pré-requisitos - Ter lido Como solicitar um Fluxo Controlado ao time Cloud Humans (comece por aqui) - Conhecer o caso de uso e as regras de negócio que devem ser automatizadas - Acesso ao Hub para identificar conteúdos interativos existentes Sobre este artigo Este artigo é a Parte 1 da especificação de um Fluxo Controlado — focada em negócio. A Parte 2 (especificação técnica) está em Especificação técnica do fluxo (Parte 2 — Tech Layer). 1 — O que é um Fluxo Controlado? Fluxo Controlado é o módulo de automação da Cloud Humans que executa ações para a ClaudIA, como: - Consultar status de pedidos - Verificar pagamentos - Gerar boletos - Buscar dados no seu sistema - Criar chamados - Atualizar cadastros - Consultar informações sensíveis A ClaudIA identifica a intenção do usuário e aciona o Fluxo Controlado correspondente. 2 — Quando faz sentido pedir um novo fluxo Peça um fluxo quando você precisar que a ClaudIA faça algo que não pode ser respondido apenas com conteúdo e tenha impacto na resolução de casos sem necessidade de humano. - Quando o atendimento exige consultas externas (API, ERP, CRM, Billing) — ex: solicitar troca de produto, envio de fatura, consulta de endereço - Quando depende de informações dinâmicas — status de andamento, status de pedido - Quando envolve validação de dados — consulta CPF/CNPJ para fornecer informações sensíveis - Quando envolve execução de processos — segunda via de fatura/boleto, envio de NF 3 — Quais são os gatilhos do fluxo O Fluxo Controlado é acionado quando a ClaudIA identifica um Conteúdo Interativo configurado no Hub. Esse conteúdo funciona como o gatilho. Como configurar o gatilho 1. Acesse o Hub e vá em Conteúdo 2. Crie ou edite um conteúdo e selecione Conteúdo tipo "INTERACTIVE" 3. Ao trocar para Interativo, aparece a opção de escolher o Flow 4. Escolha o Flow publicado no Fluxo Controlado, adicione uma tag e salve :::success Pronto. Sempre que esse conteúdo for acionado, ele ativa o Fluxo Controlado. ::: Defina como a ClaudIA reconhece o caso Liste exemplos de intenções que devem disparar o fluxo: - "consulta de pedido" - "acompanhar entrega" - "segunda via" - "consultar assinatura" 4 — Quais dados o usuário precisa fornecer Liste todos os dados obrigatórios. Exemplos de chaves primárias: - CPF / CNPJ - E-mail - Número do pedido - Telefone - Matrícula - Data de nascimento - Código único 5 — Quais validações precisam ser feitas antes de acionar o fluxo :::info Validações simples evitam erros antes de chamar seu sistema. ::: Exemplos: - CPF deve ter 11 dígitos - Pedido deve começar com ABC- - E-mail precisa ser válido - CNPJ de 14 dígitos - Se o campo estiver vazio, solicitar novamente 6 — Quais são as regras de negócio do fluxo Explique o comportamento que o Fluxo Controlado deve seguir — caminho feliz e não feliz: Exemplo de regras de negócio - O que fazer se encontrar 1 resultado? - O que fazer se encontrar vários resultados? - O que fazer se não encontrar nenhum? - Após quantas tentativas escalar para humano? - Existe limite diário de consultas? 7 — Especifique como o fluxo deve terminar Existem 4 opções de finalização: Opções de finalização - Forward to Human — encaminhar para um humano (N2) - End Flow — encaminhar para a ClaudIA e aguardar resposta do cliente (N1) - Answer Ticket — encaminhar para a ClaudIA responder imediatamente (N1) - Close Ticket — finalizar o ticket dentro do fluxo (N1) → Para entender as diferenças: Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket 8 — Exemplo de entregável ideal :::info Não há ferramenta obrigatória para envio. O exemplo a seguir foi feito no Miro: Exemplo de fluxo no Miro ::: Observações - Para começar pelo overview: Como solicitar um Fluxo Controlado ao time Cloud Humans (comece por aqui) - Para a Parte 2 (técnica): Especificação técnica do fluxo (Parte 2 — Tech Layer) - Para entender as terminações em detalhe: Diferença entre terminações de fluxo

Última atualização em Jun 24, 2026

Quais são os requisitos de API para utilização no Fluxo Controlado

Quando usar - Você está preparando a especificação técnica de um Fluxo Controlado que consome API externa - Você precisa saber quais informações sua documentação de API deve conter para acelerar a integração - Você quer um checklist dos campos, autenticação e tratamento de erros mínimos Pré-requisitos - Ter lido a Parte 2 — Especificação Técnica - Documentação técnica da API a ser consultada (preferencialmente atualizada) Sobre este artigo Para configurar o Fluxo Controlado com qualquer API, precisamos que a documentação forneça um conjunto mínimo de dados. Este artigo descreve o que enviar ao seu Account Manager, para que o time técnico da Cloud Humans consiga integrar a API rapidamente. :::info Documento modelo: Documento de Especificação de API — preencha-o conforme orientação e submeta ao seu AM. ::: Detalhes 1 — Endpoint da API - Base URL principal - Endpoint específico que será utilizado pelo Fluxo Controlado 2 — Onde obter ou gerar a chave de acesso API Key - Informações sobre onde gerar ou acessar a chave da API - Caso já possua a chave, basta enviá-la com segurança Token gerado dinamicamente Se a API exigir token gerado via outro endpoint, precisamos: - Endpoint responsável pela geração do token - Credenciais necessárias - Formato do retorno esperado 3 — Documentação da API A documentação deve estar atualizada e conter: - Descrição dos endpoints - Métodos suportados (GET, POST, PUT, DELETE) - Exemplo de payload recente - Estrutura dos campos que o Fluxo Controlado precisará extrair 4 — Parâmetros para teste Exemplos de parâmetros para testar a integração: - E-mail - CPF - Número de pedido - Outros identificadores usados pela API 5 — Exemplos de documentação ideal Uma documentação ideal deve conter: - Base URL + endpoints detalhados - Método (GET, POST, PUT, DELETE) - Headers necessários - Exemplo de request (JSON) - Exemplo de response (JSON) - Explicação campo a campo - Fluxo de autenticação (se houver) 6 — Erros comuns e como tratá-los A documentação deve listar os principais erros retornados pela API, com explicações claras para conseguirmos identificar, interpretar e corrigir. Códigos HTTP mais comuns | Código | Significado | | --- | --- | | 400 | Bad Request | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | | 409 | Conflict | | 422 | Unprocessable Entity | | 429 | Too Many Requests | | 500 | Internal Server Error | Descrição da causa provável Para cada erro: - Parâmetros inválidos ou ausentes - Falha de autenticação ou token expirado - Excesso de requisições (rate limit) - Endpoint temporariamente indisponível - Erro interno do servidor da API Exemplo de resposta de erro JSON retornado e os campos relevantes (error, message, code etc.). Orientações de correção Como tratar: - Gerar ou renovar o token - Ajustar parâmetros obrigatórios - Aguardar alguns segundos antes de reenviar (em caso de 429) Observações - Para o documento modelo de especificação: Documento de especificação de API - Para entender o fluxo de solicitação como um todo: Como solicitar um Fluxo Controlado ao time Cloud Humans (comece por aqui) - Se preferir Google Sheets em vez de API: Requisitos de Google Sheets para utilização no Fluxo Controlado - Para construir o fluxo já com API consumida pelo Fluxo Controlado: Como criar um Fluxo Controlado com API externa

Última atualização em Jun 24, 2026

Quais são os requisitos de Google Sheets para utilização no Fluxo Controlado

Quando usar - Você quer usar Google Sheets como fonte de dados para um Fluxo Controlado (sem precisar de API) - Você está preparando a especificação técnica e precisa saber o que fornecer ao AM - Você quer um template de instrução sobre como o Fluxo Controlado deve buscar e tratar os dados da planilha Pré-requisitos - Ter lido a Parte 2 — Especificação Técnica - Conta Google com permissão sobre a planilha - (Recomendado) Planilha já estruturada com cabeçalho na primeira linha Sobre este artigo Este artigo descreve quando faz sentido usar Google Sheets como fonte de dados para o Fluxo Controlado e quais informações ajudam a estruturar a integração. Esses itens não são mais obrigatórios para configurar a planilha, mas servem como referência para uma configuração bem-feita. Quando usar Google Sheets Recomendado para cenários como: - Catálogos simples - Tabelas de referência - Status de pedidos/suporte sincronizados manualmente - Listas de elegibilidade - Preços, regras, tabelas de devolução O que a sua empresa precisa fornecer 1. Link da planilha 2. Indicação das abas relevantes 3. Nome e tipo das colunas importantes 4. Filtros / lógicas de busca - Ex: Buscar pelo CPF na coluna A - Ex: Buscar pelo número do pedido na coluna C 5. Regras de validação - Ex: CPF precisa ter 11 dígitos - Ex: Campo status deve ser um dos valores: novo, em andamento, concluído 6. Comportamento esperado quando houver: - 1 resultado - Múltiplos resultados - Nenhum resultado 7. Organização dos dados — incluir exemplos Importante sobre hospedagem da planilha :::info A hospedagem da planilha em um Google Drive de domínio @cloudhumans não é mais obrigatória — você pode manter a planilha no seu próprio Drive. ::: :::warning Atenção: para que o time da Cloud Humans consiga atuar em casos de debug, é obrigatório conceder permissão de acesso a alguém do nosso time na planilha. ::: Exemplo de estrutura da planilha Estrutura da planilha Formato de instrução (modelo ideal) Buscar na aba "Pedidos" o registro em que a coluna "CPF" = valor informado pelo usuário. Retornar: pedido, status, previsão. Se nenhum resultado → pedir CPF novamente. Se ainda assim não encontrar → escalar para humano. Observações - Para o overview do processo de solicitação: Como solicitar um Fluxo Controlado ao time Cloud Humans (comece por aqui) - Para usar API em vez de Sheets: Requisitos de API para utilização no Fluxo Controlado - Para construir o fluxo já com Sheets consumido pelo Fluxo Controlado: Como criar um Fluxo Controlado acessando informações em um Google Sheets - Se você quiser transformar a planilha em uma API HTTP: Como transformar seu Google Sheets em uma API consultável pelo Fluxo Controlado

Última atualização em Jun 24, 2026