Personr (versão prévia)

Esse conector está disponível nos seguintes produtos e regiões:

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:      – Regiões do Azure Governamental      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões do Power Apps , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Nome completo
URL	https://personr.co/contact
Email	help@personr.co

Metadados do conector
Publicador	Microsoft
Site	https://personr.co
Política de privacidade	https://personr.co/legals
Categorias	Dados

O Personr simplifica a verificação de identidade ao detectar fraudes complexas, permitindo que sua empresa esteja em conformidade com as regulamentações de KYC (Know Your Customer) e Anti-Money Laundering (AML). O conector permite que você crie, verifique e solicite o status e os detalhes de um solicitante.

Pré-requisitos

Você precisará do seguinte para continuar...

• Uma conta personr ativa/assinada. Se você não estiver inscrito no momento, poderá fazer isso acessando https://personr.co ou fazendo logon em sua conta e escolhendo um plano.

Como obter credenciais

Você precisará gerar um token de portador de autorização, que é válido por um ano. Para fazer isso, envie uma solicitação POST para https://enterprise.personr.co/api/1.1/wf/api-token-generate

O corpo deve incluir o email e a senha da sua conta. A API retornará uma resposta com o token do Portador de Autorização, como no exemplo abaixo:

{
  "status": "success",
  "response": {
    "token": "your_auth_token",
    "expires": "expiry_date_in_seconds"
  }
}

Ao inserir o token no conector durante a instalação, verifique se a palavra Portador está incluída antes do token: Bearer your_auth_token

Introdução ao conector

Para começar a verificar seu primeiro candidato, siga o método abaixo.

Crie seu primeiro candidato.

Use o Create an Applicant actione insira os detalhes necessários, como seu email, número de telefone e o fluxo pelo qual você gostaria que eles passassem. Você também pode inserir seu nome e sobrenome (opcional).

Observação: o Flow Name valor deve corresponder ao que você criou na plataforma.

Crie um link de verificação ou carregue diretamente documentos.

Você pode verificar um candidato de duas maneiras: fornecendo-lhes um link de verificação ou carregando diretamente seus documentos no formato base64.

Para gerar um link de verificação, use a Create a Verification Link ação e insira a ID do Requerente recebida da etapa anterior. O link de verificação permite que os candidatos carreguem seus documentos de acordo com o fluxo escolhido.

Nenhuma outra ação é necessária para verificação ao usar um link de verificação, o processamento é iniciado automaticamente.

---

Para carregar documentos diretamente em um perfil de candidato, use a ação Upload a Document e insira as informações necessárias , como a ID do Requerente, o Tipo de Documento, o Sub type, o País do Documento, o Nome do Arquivo e o conteúdo base64.

Depois de carregar os documentos necessários (front e back side) para o fluxo escolhido, use a ação Request an Applicant Check para confirmar e iniciar o processamento. Isso não será necessário se você estiver usando o método de link de verificação, pois o processamento é iniciado automaticamente.

Observação: o nome do arquivo deve incluir a extensão de arquivo, por exemplo: id_card.jpg Além disso, o conteúdo base64 não deve incluir o tipo de arquivo. Por exemplo: /9j/4AAQSkZJRgABAQAAAQABAAD...

Para obter mais informações sobre tipos de documentos e subtipos, consulte nossa documentação pública aqui: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd

Recupere o status de um candidato e as informações extraídas.

As verificações normalmente levam cerca de 2 minutos para serem processadas. Para recuperar o status de um requerente, use a ação Retrieve Applicant Status com a correlação de applicantId.

Essa ação fornece uma Approved resposta ou Rejected resposta, rótulos de rejeição e informações de documento extraídas.

Recupere os detalhes de um candidato. (Opcional)

Semelhante à ação acima, Retrieve Applicant Details permite que você recupere informações adicionais sobre um candidato, usando a correlação de applicantId.

Problemas e limitações conhecidos

As verificações não continuarão se a imagem estiver extremamente desfocada ou fora de foco. Damos suporte a tipos de arquivo JPEG, PNG e PDF.

Erros e soluções comuns

Ao usar a ação Create an Applicant , se você receber um erro, verifique se o Nome do Fluxo corresponde ao que você criou na plataforma.

Ao usar a ação Upload a Document para carregar uma imagem de selfie (se o fluxo exigir), verifique se o Tipo de Documento é 'SELFIE' e o SubTipo do Documento é 'NULL'.

perguntas frequentes

Como os dados de um candidato são verificados?

Uma vez extraídos, os dados do candidato são verificados com bancos de dados governamentais e comerciais vetados, incluindo, mas não se limitando ao rolo eleitoral, veículo, telecomunicação, morte e outros registros.

O que é detecção de fraude complexa ou manipulação digital?

Detecção de fraude complexa ou detecção de manipulação digital é o processo de verificação para ver se os documentos foram editados graficamente, forjados ou comprados ilegitimamente online. Esse processo é executado em segundo plano em cada verificação e ajuda a evitar fraudes antes de ocorrer - protegendo empresas e indivíduos.

Você pode criar um fluxo personalizado que posso usar para minha empresa?

Absolutamente, cada empresa é exclusiva (assim como todas as verificações). Entre em contato com nossa equipe, que poderá criar um fluxo personalizado adaptado aos seus requisitos.

Quais países têm suporte para uma verificação?

Verificamos documentos e indivíduos globalmente, desde carteiras de motorista até contas de serviços públicos, extratos bancários e até correspondência com autoridades governamentais - independentemente de linguagem ou tipação.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Token de autorização	secureString	Insira seu token de portador de autorização	Verdade

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	100	60 segundos

Ações

Carregar documentos em um solicitante	Carregue documentos em um candidato com uma cadeia de caracteres base64.
Criar Candidato	Crie um novo solicitante de verificação.
Criar link de verificação	Crie um link de verificação para carregar facilmente documentos.
Recuperar detalhes do requerente	Recupere os detalhes de um candidato.
Recuperar status do requerente	Recupere o status de verificação de um candidato e seus detalhes.
Solicitar verificação do requerente	Confirme se todos os documentos foram carregados e inicie a verificação.

Carregar documentos em um solicitante

Criar Candidato

Criar link de verificação

Recuperar detalhes do requerente

Recuperar status do requerente

Solicitar verificação do requerente