Como integrar a API Ekata Address Risk a um motor de decisão
Entre os serviços da Ekata está a Address Risk API, uma ferramenta útil para verificar endereços em diferentes situações. Ela pode complementar as análises tradicionais de fraude ou de risco de crédito.
Em comparação com a verificação pela API do Google Maps, a Ekata também oferece mais dados. Eles mostram como e com que frequência um endereço aparece em transações de e-commerce. Incluem a primeira e a última vez em que o endereço foi identificado, o número de estabelecimentos em que apareceu e a frequência com que foi usado com outros atributos.
Saiba mais sobre a Ekata Address Risk neste material de uma página aqui.
Obtenha uma chave de API da Ekata
Você precisa solicitar uma demonstração à Ekata. Depois, receberá uma chave de API para testes. Solicite a demonstração em:
https://ekata.com/products/address-risk-api/- Depois de criar sua conta e entrar, acesse o Dashboard e obtenha sua chave de API do Address Risk.
Crie uma fonte de dados no Decisimo Portal
- Em Data sources, selecione New e peça ao Assistente de IA para configurar o provedor. Depois, confira e aplique a proposta.
- Insira sua chave de API da Ekata no valor do parâmetro “api_key”.
- Para fazer uma avaliação adequada, a Ekata precisa dos principais campos do endereço:
- street_line_1
- city
- postal_code
- country_code
- Informe ao Assistente de IA qual é o provedor e como fazer a chamada HTTP. Confira a proposta com base nos parâmetros abaixo.
Adicione a fonte de dados Ekata Address Risk ao seu fluxo de decisão
- Se você já tem uma etapa de decisão para fontes de dados, pode incluir a chamada ao Ekata Address Risk nessa mesma etapa. O motor de decisão chamará todas as fontes dessa etapa em paralelo. As chamadas paralelas garantem o menor tempo de execução.
- Se você ainda não tem uma etapa do fluxo de decisão para dados externos, adicione uma. Conecte a etapa do fluxo de decisão e abra a janela de definição com um clique duplo. Nela, defina os atributos do seu objeto de dados que serão enviados à API do Ekata Address Risk.
-
Execute a tomada de decisão
- Faça o release do seu fluxo de decisão, publique-o em um endpoint e tome decisões com dados da API do Ekata Address Risk.
Perguntas frequentes
Quais dados de endereço devo enviar à Ekata Address Risk API?
Envie o endereço, a cidade, o código postal e o código do país. Confira se esses dados vêm da solicitação que você pretende analisar e defina como as regras vão tratar endereços ausentes ou incompletos antes do release. Dados de endereço incompletos ou desatualizados podem reduzir a utilidade das informações de risco retornadas.
Como configuro a fonte de dados da Ekata no Decisimo Portal?
Crie uma fonte de dados e peça ao AI Assistant que proponha a configuração do provedor e a chamada HTTP. Revise e aprove a proposta antes de aplicá-la. Depois, informe a chave de API da Ekata na configuração do provedor e mapeie os dados de endereço necessários. Antes de testar, confira as configurações da solicitação na documentação atual da Ekata.
Devo incluir a Ekata em uma tarefa de dados externos existente ou criar outra?
Inclua a Ekata em uma tarefa de dados externos existente se as outras fontes também forem necessárias naquele ponto do fluxo de decisão. As fontes na mesma tarefa são consultadas em paralelo, então o tempo total de espera depende da resposta mais lenta. Crie uma tarefa separada se a verificação de endereço ocorrer mais adiante no fluxo ou depender de um resultado anterior.
O que devo testar antes de fazer o release de um fluxo de decisão que usa a Ekata?
Teste endereços completos e incompletos, confirme se as regras que precisam dos dados retornados conseguem acessá-los e defina o que acontece se a chamada falhar ou não trouxer um resultado utilizável. Confira decisões representativas antes do release. Dê atenção especial a dados ausentes e erros do provedor, pois o tratamento pouco claro pode gerar decisões inconsistentes.
