Principal Como solicitar um Eddie ao time Cloud Humans
💡

Como solicitar um Eddie 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 Eddie 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 automatizados Eddie 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 Eddie 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 Eddie 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 Eddie - Para requisitos de Google Sheets: Requisitos de Google Sheets para utilização no Eddie - Para o documento modelo de especificação de API: Documento de especificação de API

Última atualização em May 21, 2026

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

Quando usar - Você quer solicitar um novo fluxo Eddie 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 Eddie 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 Eddie — 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 Eddie? Eddie é 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 Eddie 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 Eddie é 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 Eddie, adicione uma tag e salve :::success Pronto. Sempre que esse conteúdo for acionado, ele ativa o fluxo Eddie. ::: 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 Eddie 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 Eddie 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 May 21, 2026

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

Quando usar - Você está preparando a especificação técnica de um fluxo Eddie 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 Eddie 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 Eddie 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 Eddie 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 Eddie ao time Cloud Humans (comece por aqui) - Se preferir Google Sheets em vez de API: Requisitos de Google Sheets para utilização no Eddie - Para construir o fluxo já com API consumida pelo Eddie: Como criar um fluxo no Eddie com API externa

Última atualização em May 21, 2026

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

Quando usar - Você quer usar Google Sheets como fonte de dados para um fluxo Eddie (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 Eddie 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 Eddie e o que sua empresa precisa fornecer para que o time Cloud Humans configure a integração. 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 8. Permissões de acesso - Dar acesso ao service account da Cloud Humans - Ou tornar a aba de consulta publicamente acessível (somente leitura) Importante sobre hospedagem da planilha :::warning A planilha de dados fornecida será copiada e hospedada em um Google Drive cujo domínio é @cloudhumans (criação e responsabilidade nossa). Ela será compartilhada apenas com os responsáveis pela atualização de dados do seu time. ::: 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 Eddie ao time Cloud Humans (comece por aqui) - Para usar API em vez de Sheets: Requisitos de API para utilização no Eddie - Para construir o fluxo já com Sheets consumido pelo Eddie: Como criar um fluxo no Eddie 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 Eddie

Última atualização em May 21, 2026