Principal Eddie | Conecte seu backoffice Como criar um fluxo no Eddie com API externa (via Eddie)

Como criar um fluxo no Eddie com API externa (via Eddie)

Última atualização em Aug 09, 2025

O que você vai aprender aqui?

Essa FAQ ensina, passo a passo, como usar o Eddie com o Eddie + API externa para construir um fluxo que:

  • Recebe uma entrada do usuário (ex: CEP ou número do pedido)

  • Faz uma requisição para uma API externa

  • Extrai e salva os dados retornados em variáveis

  • Retorna uma resposta formatada para a Cláudia ou direciona o fluxo para N2

Etapa 1 – Crie um novo fluxo no Eddie

  1. Acesse o Eddie e clique em “Criar um Typebot”

  2. Comece do zero (blank bot)

Etapa 2 – Defina 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 chamada cep

Etapa 3 – Configure a chamada de API

  1. Adicione um bloco do tipo HTTP Request

  2. No campo de URL, cole o endpoint da API (exemplo: https://viacep.com.br/ws/{{cep}}/json)

  3. Certifique-se de que a variável esteja entre chave ("{{}}"), como, no exemplo, {{cep}}.

  4. Método: GET

Etapa 4 – Teste 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 – Mapeie os campos de resposta

Depois que o request funcionar, extraia os dados relevantes do JSON retornado. No exemplo, ele retorna o abaixo:

Etapa 6 – Monte a resposta formatada

Crie um bloco de texto com a resposta para o cliente, usando as variáveis extraídas. Exemplo:

“O CEP {{cep}} corresponde à rua {{endereco}}, no bairro {{bairro}}, cidade de {{cidade}}/{{uf}}, DDD {{ddd}}.”

Etapa 7 – Lidando com CEPs inválidos

  1. Use um bloco condicional

  2. Verifique se a variável endereco existe:

    • Se sim, siga com a resposta

    • Se não, envie uma mensagem como, por exemplo, “Não encontramos esse CEP” e retorne para a Cláudia ou redirecione para N2

Etapa 8 – Enviando de volta para a Cláudia

  • No final do fluxo, use o bloco “Retornar para a Cloud”

  • Se o dado foi encontrado, retorne uma resposta amigável

  • Se não foi encontrado, envie um texto que sinalize que a Cláudia deve escalar para N2 (ex: “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 – Tratamento de 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).

Dica: use blocos de transformação de texto ou scripts JavaScript no Eddie, se necessário.

Conclusão

Com esse fluxo no Eddie:

  • Você automatiza buscas externas via API

  • Personaliza a resposta para o cliente

  • Escala apenas quando necessário

  • Pode replicar esse modelo para consultas de status de pedidos, rastreios, CPFs, etc.

Outros artigos que podem ser úteis