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

[Comece por Aqui] Como Solicitar um Fluxo Eddie (Automação) para a ClaudIA

Como Solicitar um Fluxo Eddie (Automação) para a ClaudIA Este FAQ ajuda 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. Para solicitar um novo fluxo Eddie, sua empresa deve enviar: (1) A 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 e exemplos de conversa desejada. (2) A especificação tĆ©cnica completa — endpoints, payloads, respostas possĆ­veis (200/400/404/500), autenticação, limites e qualquer configuração necessĆ”ria para integração. Exemplo de fluxo bem especificado: 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. āœ” Importante: Todas as solicitaƧƵes devem ser enviadas exclusivamente por meio do Account Manager responsĆ”vel pela sua conta. Ele(a) validarĆ” o pedido, revisarĆ” se todas as informaƧƵes necessĆ”rias foram incluĆ­das e encaminharĆ” ao time tĆ©cnico da Cloud Humans para implementação. O Time de Eddie prioriza construƧƵes de fluxos com foco em retenção de novos casos pela ClaudIA. Consulte o seu AM sobre pacotes extras (sob custo adicional) de professional service para construção de fluxos gerĆ”is. FAQs Complementares a essa: šŸ“Œ PARTE 1 — Como especificar o fluxo 🧩 PARTE 2 — Especificação TĆ©cnica (Tech Layer)

Última atualização em Dec 03, 2025

šŸ“Œ PARTE 1 — Como especificar o fluxo

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 Eddie? PeƧa um fluxo quando vocĆŖ precisa 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 a necessidade de um humano. āœ“ Quando o atendimento exige consultas externas (API, ERP, CRM, Billing, etc.) - Solicitar troca do produto , Envio de fatura, Consulta de endereƧo para entrega, etc. āœ“ Quando depende de informaƧƵes dinĆ¢micas - Status de andamento da solicitação, Status de pedido. āœ“ Quando envolve validação de dados - Consulta CPF/CNPJ para fornecer informaƧƵes sensĆ­veis āœ“ Quando envolve execução de processos (ex.: gerar segunda via) - Segunda via de fatura ou boleto, Envio de Nota Fiscal. 3. Quais sĆ£o os gatilhos do fluxo? < (revisar explicação conteĆŗdo seção interativa + prints) > O fluxo do Eddie Ć© acionado quando a ClaudIA identifica um ConteĆŗdo Interativo configurado no Hub. Esse conteĆŗdo funciona como o gatilho. 1. Acesse o Hub e vĆ” em ConteĆŗdo 1. Crie ou edite um conteĆŗdo e selecione ConteĆŗdo tipo "INTERACTIVE". Ao trocar para Interativo, aparece a opção de escolher o Flow. 3. Escolha o Flow publicado no Eddie, adicione uma tag e salve. Pronto: sempre que esse conteĆŗdo for acionado, ele ativa o fluxo. Defina como a ClaudIA reconhece que deve acionar o fluxo: Exemplos: - ā€œ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? 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. (ValidaƧƵes simples evitam erros antes de chamar seu sistema.) 6. Quais sĆ£o as regras de negócio do fluxo? Explique o comportamento que Eddie deve seguir, seja ele um caminho feliz ou nĆ£o feliz?: Exemplo: - 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 qual deve ser o fim do fluxo dentre as 4 opƧƵes: - Forward to human: Encaminhar para um humano (N2). - End Flow: Encaminhar para 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). 8. Exemplo de entregĆ”vel ideal (NĆ£o existe obrigatoriedade de ferramenta para envio, nesse exemplo foi utilizado o Miro) Link: <LINK DO FLUXO>***

Última atualização em Dec 03, 2025

Requisitos de API para utilização no Eddie

šŸ“„Documento Modelo para Utilização**:** Documento de Especificação de API 1. Quais informaƧƵes da API precisamos receber? - Para configurar o Eddie com qualquer API, precisamos que a documentação forneƧa os seguintes dados. 1.1 Endpoint da API: - Base URL principal. - Endpoint especĆ­fico que serĆ” utilizado pelo Eddie. 2. Onde obter ou gerar a chave de acesso da API? 2.1 API Key: - InformaƧƵes sobre onde gerar ou acessar a chave da API. - Caso jĆ” possua a chave, basta enviĆ”-la. 2.2 A API utiliza token gerado? - 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. - Exemplo de payload recente. - Estrutura dos campos que o Eddie precisarĆ” extrair. 4. Quais parĆ¢metros precisamos para testar a API? - Exemplos de parĆ¢metros para teste: - 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 existir). 6. Erros comuns e como tratĆ”-los. A documentação deve listar os principais erros retornados pela API, com explicaƧƵes claras para que a gente consiga identificar, interpretar e corrigir corretamente em caso de falhas. Ɖ importante incluir: 1. Códigos HTTP mais comuns, como: - *400 (Bad Request), - 401 (Unauthorized), - 403 (Forbidden), - 404 (Not Found), - 409 (Conflict), - 422 (Unprocessable Entity), - 429 (Too Many Requests), - 500 (Internal Server Error).* 2. Descrição da causa provĆ”vel de cada erro, por exemplo: - 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. 3. Exemplo de resposta de erro, incluindo o formato do JSON retornado e os campos relevantes, como: - error - message - code 4. OrientaƧƵes de correção ou tratamento, como: - Gerar ou renovar o token. - Ajustar parĆ¢metros obrigatórios. - Aguardar alguns segundos antes de reenviar (em caso de 429).

Última atualização em Dec 03, 2025

Requisitos de Google Sheets para utilização no Eddie

Consultas usando Google Sheets: 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 o cliente 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 CloudHumans - Ou tornar a aba de consulta publicamente acessĆ­vel (somente leitura) āš ļø Importante: A planilha de dados fornecida serĆ” copiada e hospedada em um Google Drive, cujo domĆ­nio Ć© @cloudhumans (cuja criação e de nossa responsabilidade) e ela serĆ” compartilhada somente com os responsĆ”veis pela atualização de dados do time de vocĆŖs. Exemplo de 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, previsao. Se nenhum resultado → pedir CPF novamente. Se ainda assim nĆ£o encontrar → escalar para humano.

Última atualização em Dec 03, 2025