Personr (Pré-visualização)
Crie, verifique e recupere dados de candidatos usando o Personr. Verifique facilmente a identidade e detete fraudes complexas.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 |
| help@personr.co |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://personr.co |
| Política de privacidade | https://personr.co/legals |
| Categorias | Data |
O Personr simplifica a verificação de identidade enquanto deteta fraudes complexas, permitindo que sua empresa cumpra as regulamentações Conheça Seu Cliente (KYC) e Antilavagem de Dinheiro (AML). O conector permite criar, verificar e solicitar o status e os detalhes de um candidato.
Pré-requisitos
Você precisará do seguinte para prosseguir...
- Uma conta Personr ativa/subscrita. Se ainda não está inscrito, pode fazê-lo acedendo ou https://personr.co iniciando sessão na 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 e-mail e a senha da sua conta. A API retornará uma resposta com seu token de 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 configuraçã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 o seu primeiro candidato, siga o método abaixo.
Crie o seu primeiro candidato.
Use o Create an Applicant action, e insira os detalhes necessários, como e-mail, 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 deve corresponder ao Flow Name que você criou na plataforma.
Crie um link de verificação ou carregue documentos diretamente.
Você pode verificar um candidato de duas maneiras: fornecendo-lhe 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 o ID do Candidato que você recebeu da etapa anterior. O link de verificação permite que os candidatos carreguem seus documentos de acordo com o fluxo escolhido.
Nenhuma ação adicional é necessária para a verificação ao usar um link de verificação, o processamento é iniciado automaticamente.
Para carregar diretamente documentos para um perfil de candidato, use a Upload a Document ação e insira as informações necessárias - como ID do candidato, tipo de documento, subtipo, país do documento, nome do arquivo e o conteúdo da base64.
Depois de carregar os documentos necessários (frente e verso) para o fluxo escolhido, use a Request an Applicant Check ação para confirmar e iniciar o processamento. Isso não é necessário se você estiver usando o método de link de verificação - pois o processamento começa automaticamente.
Nota: o nome do arquivo deve incluir a extensão do 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 e subtipos de documentos, 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 ~2 minutos para serem processadas. Para recuperar o status de um candidato, use a Retrieve Applicant Status ação com o applicantId correlacionado.
Esta ação fornece uma Approved ou Rejected resposta, rótulos de rejeição e informações extraídas do documento.
Recuperar os dados de um candidato. (Opcional)
Semelhante à ação acima, Retrieve Applicant Details permite que você recupere informações adicionais sobre um candidato, usando o applicantId correlacionado.
Problemas conhecidos e limitações
As verificações não prosseguirão se a imagem estiver extremamente desfocada ou fora de foco. Suportamos os tipos de ficheiros JPEG, PNG e PDF.
Erros e soluções comuns
Ao usar a Create an Applicant ação, se você receber um erro, verifique se o Nome do Fluxo corresponde ao que você criou na plataforma.
Ao usar a Upload a Document ação para carregar uma imagem selfie (se o seu fluxo exigir), verifique se o Tipo de documento é 'SELFIE' e o Subtipo de documento é 'NULL'.
FAQ
Como são verificados os dados de um candidato?
Uma vez extraídos, os dados dos candidatos são verificados com bases de dados governamentais e comerciais examinadas, incluindo, entre outros, cadernos eleitorais, veículos, telecomunicações, óbitos e outros registos.
O que é deteção de fraude complexa ou manipulação digital?
Deteção de fraude complexa, ou deteção de manipulação digital, é o processo de verificação para ver se os documentos foram graficamente editados, falsificados ou comprados ilegitimamente on-line. Esse processo é executado em segundo plano em cada verificação e ajuda a prevenir fraudes antes que elas ocorram, protegendo empresas e indivíduos.
Você é capaz de criar um fluxo personalizado que eu possa usar para o meu negócio?
Absolutamente, cada negócio é único (assim como cada verificação). Entre em contacto com a nossa equipa, que poderá criar um fluxo personalizado à medida das suas necessidades.
Que países são suportados para uma verificação?
Verificamos documentos e indivíduos em todo o mundo, desde cartas de condução a faturas de serviços públicos, extratos bancários e até correspondência com autoridades governamentais - independentemente do idioma ou datilografia.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 | Introduza o seu Token de Portador de Autorização | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Carregar documentos para um candidato |
Carregue documentos para um candidato com uma cadeia de caracteres base64. |
| Criar candidato |
Crie um novo requerente de verificação. |
| Criar link de verificação |
Crie um link de verificação para carregar documentos facilmente. |
| Recuperar detalhes do candidato |
Recuperar os dados de um candidato. |
| Recuperar o status do candidato |
Recupere o status de verificação de um candidato e seus detalhes. |
| Solicitar verificação do candidato |
Confirme se todos os documentos foram carregados e inicie a verificação. |
Carregar documentos para um candidato
Carregue documentos para um candidato com uma cadeia de caracteres base64.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do candidato
|
applicantId | string |
ID do requerente |
|
|
Tipo de documento (ex. ID_CARD)
|
docType | string |
docType |
|
|
Subtipo de documento (ex. FRONT_SIDE)
|
docSubType | string |
docSubType |
|
|
Documento ISO do país (por exemplo, AUS)
|
docCountryISO | string |
docPaísISO |
|
|
Nome do arquivo + extensão (por exemplo, document.jpeg)
|
filename | string |
filename |
|
|
Conteúdo do arquivo (cadeia de caracteres Base64)
|
contents | string |
contents |
Criar candidato
Crie um novo requerente de verificação.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Endereço de E-mail
|
string |
|
||
|
Número de Telefone
|
phone | string |
phone |
|
|
Nome Próprio
|
nameFirst | string |
nomePrimeiro |
|
|
Apelido
|
nameLast | string |
nomeÚltimo |
|
|
Fluxo de candidatos
|
flowName | string |
Nome do fluxo |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
ID do requerente
|
response.applicantId | string |
ID do requerente |
|
e-mail
|
response.email | string |
|
|
phone
|
response.phone | string |
phone |
|
nomePrimeiro
|
response.nameFirst | string |
nomePrimeiro |
|
nomeÚltimo
|
response.nameLast | string |
nomeÚltimo |
|
Nome do fluxo
|
response.flowName | string |
Nome do fluxo |
|
Estatuto do requerente
|
response.applicantStatus | string |
Estatuto do requerente |
Criar link de verificação
Crie um link de verificação para carregar documentos facilmente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do candidato
|
applicant | string |
requerente |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
verificaçãoLink
|
response.verificationLink | string |
verificaçãoLink |
Recuperar detalhes do candidato
Recuperar os dados de um candidato.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do candidato
|
applicantId | string |
ID do requerente |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
e-mail
|
response.email | string |
|
|
phone
|
response.phone | string |
phone |
|
nomePrimeiro
|
response.nameFirst | string |
nomePrimeiro |
|
nomeÚltimo
|
response.nameLast | string |
nomeÚltimo |
|
tags
|
response.tags | array of |
tags |
|
Nome do fluxo
|
response.flowName | string |
Nome do fluxo |
|
estado
|
response.status | string |
estado |
Recuperar o status do candidato
Recupere o status de verificação de um candidato e seus detalhes.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do candidato
|
applicantId | string |
ID do requerente |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
Estatuto do requerente
|
response.applicantStatus | string |
Estatuto do requerente |
|
candidatoAçãoStatus
|
response.applicantActionStatus | string |
candidatoAçãoStatus |
|
Data de Modificação
|
response.result.Modified Date | integer |
Data de Modificação |
|
Data de criação
|
response.result.Created Date | integer |
Data de criação |
|
Criado por
|
response.result.Created By | string |
Criado por |
|
revisãoResposta
|
response.result.reviewAnswer | string |
revisãoResposta |
|
requerente
|
response.result.applicant | string |
requerente |
|
commentClient
|
response.result.commentClient | string |
commentClient |
|
Companhia
|
response.result.company | string |
Companhia |
|
comentárioModeração
|
response.result.commentModeration | string |
comentárioModeração |
|
rejectLabels
|
response.result.rejectLabels | array of string |
rejectLabels |
|
reviewRejectType
|
response.result.reviewRejectType | string |
reviewRejectType |
|
verificação
|
response.result.verification | string |
verificação |
|
_id
|
response.result._id | string |
_id |
|
extractedFirstName
|
response.extractedFirstName | string |
extractedFirstName |
|
extractedLastName
|
response.extractedLastName | string |
extractedLastName |
|
extractedBirthDate
|
response.extractedBirthDate | string |
extractedBirthDate |
|
documentoPaís
|
response.documentCountry | string |
documentoPaís |
|
extraídoStreetNum
|
response.extractedStreetNum | string |
extraídoStreetNum |
|
extraídoRua
|
response.extractedStreet | string |
extraídoRua |
|
extraídoCidade extraída
|
response.extractedCity | string |
extraídoCidade extraída |
|
extraídoEstado
|
response.extractedState | string |
extraídoEstado |
|
extractedCódigo Postal
|
response.extractedPostCode | string |
extractedCódigo Postal |
Solicitar verificação do candidato
Confirme se todos os documentos foram carregados e inicie a verificação.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do candidato
|
applicantId | string |
ID do requerente |