Abler API (1.0.0)

Download OpenAPI specification:Download

Introdução

Clientes abler podem utilizar nossa API para integrar suas aplicações.

Casos de uso

Os casos de uso mais comuns dos clientes abler, incluem:

  • Consultorias de RH e Headhunters

    • Ao ganhar um negócio em seu CRM, cadastrar automaticamente um cliente na abler;
    • Ao ganhar um negócio em seu CRM, iniciar o cadastro de um processo seletivo na abler;
    • Ao mover um candidato para a etapa "Contratação", cadastrar o candidato em um software de folha de pagamento;
    • Ao mover um candidato para a etapa "Contratação", criar uma nova fatura no ERP com dados da negociação referente ao processo seletivo; E muito mais!
  • RHs corporativos

    • Ao mover um candidato para a etapa "Contratação", cadastrar o candidato em um software de folha de pagamento;
    • Ao mover um candidato para a etapa "Contratação", cadastrar o candidato em um software de admissão;
    • Ao receber uma candidatura, cadastrar o candidato em seu WhatsApp ou ferramenta de e-mail marketing;
    • Ao finalizar o processo de admissão na abler, cadastrar o candidato em um software de folha de pagamento; E muito mais!

Recursos

  • Clientes
    • Buscar, cadastrar, atualizar e deletar clientes;
  • Vagas
    • Buscar, cadastrar, atualizar e deletar vagas;
    • Buscar e cadastrar candidatos;
  • Webhook
    • Buscar, cadastrar, atualizar e deletar inscrições em webhooks;

Autenticação

O primeiro passo para iniciar a integração com a Abler é gerar o token de acesso. Você consegue obter o token da seguinte forma:

  1. Acesse a conta da empresa na plataforma Abler;
  2. Clique em "Configurações" na página de início. Se você estiver usando o novo ATS, clique em "Empresa" e precisará efetuar login novamente;
  3. Na aba Dados da sua empresa, vá para o fim da página até chegar em "Integrações";
  4. Crie o token e use ele na sua aplicação como descrito abaixo.

Como usar o token

Em toda requisição que realizar, envie no header da requisição:

Authorization: Bearer {COLOQUE_O_TOKEN_AQUI}

ATENÇÃO: Este token não expira. Insira-o em um lugar seguro dentro da aplicação, tais como gerenciadores de secrets ou arquivos .env. Não insira o token diretamente em seu código-fonte.

Clientes

Rotas relacionadas aos clientes de sua empresa

Buscar

Busca de clientes

Authorizations:
BearerToken
query Parameters
include
string
Enum: "address" "customer_contacts"

"Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/customers?include=address,customer_contacts"

per_page
string

Registros por página

page
string

Página

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Criar

Criar cliente

Authorizations:
(BearerTokenAuthToken)
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "customer": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Buscar pelo id

Busca de clientes pelo id

Authorizations:
BearerToken
query Parameters
include
string
Enum: "address" "customer_contacts"

"Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/customers?include=address,customer_contacts"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Atualizar

Atualizar cliente

Authorizations:
(BearerTokenAuthToken)
query Parameters
include
any

"Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/customers?include=address,customer_contacts"

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "customer": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Excluir

Excluir cliente

Authorizations:
(BearerTokenAuthToken)
query Parameters
include
any

"Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/customers?include=address,customer_contacts"

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "customer": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Vagas

Rotas relacionadas as vagas de sua empresa

Buscar

Busca de vagas

Authorizations:
BearerToken
query Parameters
q
string

Busca por query string

created_at_from
string <DD/MM/YYYY>

Busca data de criação da vaga

created_at_to
string <DD/MM/YYYY>

Busca data de criação da vaga

forward_at_from
string <DD/MM/YYYY>

Busca data de encaminhamento da vaga

forward_at_to
string <DD/MM/YYYY>

Busca data de encaminhamento da vaga

finished_at_from
string <DD/MM/YYYY>

Busca data de fechamento da vaga

finished_at_to
string <DD/MM/YYYY>

Busca data de fechamento da vaga

released
string
Enum: true false

Flag para ver se a vaga está publicada ou não

statuses
string
Enum: "customer_request" "draft" "waiting_approval" "ready_for_publish" "published" "stopped" "forwarded_by_customer" "finished" "canceled"

Status da vaga

include
string
Enum: "pipeline" "address" "team" "level_of_interest" "area_of_interests" "vacancies_benefits" "vacancies_benefits.benefit" "vacancies_languages" "vacancies_languages.language" "complementary_formations" "vacancy_admission_info" "customer" "approvers" "analysts"

Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/vacancies?include=address,team

per_page
string

Registros por página

page
string

Página

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Criar

Criar vaga

Authorizations:
(BearerTokenAuthToken)
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "vacancy": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

Buscar pelo id

Busca de vaga pelo id

Authorizations:
BearerToken
path Parameters
id
required
integer

Vacancy id

query Parameters
include
string
Enum: "pipeline" "address" "team" "level_of_interest" "area_of_interests" "vacancies_benefits" "vacancies_benefits.benefit" "vacancies_languages" "vacancies_languages.language" "complementary_formations" "approvers" "analysts"

Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/vacancies?include=address,team

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Atualizar pelo id

Atualizar vaga

Authorizations:
BearerToken
path Parameters
id
required
integer

Vacancy id

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "vacancy": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

Deletar pelo id

Deletar vaga pelo id

Authorizations:
BearerToken
path Parameters
id
required
integer

ID da Vaga

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Buscar candidato

Busca candidato da vaga pelo id

Authorizations:
BearerToken
path Parameters
id
required
integer

ID da vaga

candidate_id
required
integer

ID do candidato

query Parameters
include
string
Value: "candidates_pipelines"

"Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/vacancies/1/candidates?include=candidates_pipelines"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Adicionar candidatura

Adicionar candidatura

Authorizations:
(BearerTokenAuthToken)
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "candidate": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Buscar candidatos

Busca candidatos da vaga

Authorizations:
BearerToken
path Parameters
id
required
integer

ID da vaga

candidate_id
required
integer

ID do candidato

query Parameters
per_page
string

Registros por página

page
string

Página

name
string

Filtrar os candidatos pelo nome

email
string

Filtrar os candidatos pelo e-mail

include
string
Value: "candidates_pipelines"

"Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/vacancies/1/candidates?include=candidates_pipelines"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Coleções

Rotas relacionadas a coleções da empresa

Beneficios

Busca de beneficios

Authorizations:
BearerToken
query Parameters
q
string

Busca por termos no campo nome

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Cidades

Busca de cidades

Authorizations:
BearerToken
query Parameters
q
string

Busca por termo nome

state_id
string

Busca id de estado

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Tipo de deficiência

Busca de tipo de deficiência

Authorizations:
BearerToken
query Parameters
q
string

Busca por termo nome

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Estados

Busca de estados

Authorizations:
BearerToken
query Parameters
q
string

Busca por termo nome e abreviação

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Clientes

Busca de clientes

Authorizations:
BearerToken
query Parameters
q
string

Busca por termo razão social e nome fantasia

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Contatos

Busca de contatos

Authorizations:
BearerToken
query Parameters
q
string

Filtrar os contatos por query string

customer_id
integer

Filtrar os contatos pelo ID do cliente

include
string
Enum: "customer" "vacancies" "access_role"

"Quando um relacionamento precisar estar presente no dado serializado do cliente, apenas inclua usando esse parâmetro. Envie o include separado por vírgula para retornar mais que um. Exemplo: api.abler.com.br/v1/collections/customer_contacts?include=address,customer_contacts"

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Usuários

Busca de usuários da empresa

Authorizations:
BearerToken
query Parameters
q
string

Busca por termo nome

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Equipes

Busca de equipes

Authorizations:
BearerToken
query Parameters
q
string

Busca por termo nome

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Enum

Rotas relacionadas a enums da empresa

CNH

Busca de CNH

Authorizations:
BearerToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Tipo de requisição

Busca de tipo de requisição

Authorizations:
BearerToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Tipo de contrato

Busca de tipo de contrato

Authorizations:
BearerToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Licença

Busca de licença

Authorizations:
BearerToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Valor de benefícios

Busca de valor de benefícios

Authorizations:
BearerToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Periodicidade de benefícios

Busca de periodicidade de benefícios

Authorizations:
BearerToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Webhook

Você pode se inscrever em um dos eventos disponíveis e a Abler notificará quando este evento for disparado

  1. Use os endpoints de webhook_subscription para registrar seu endpoint;
  2. Quando o evento for disparado, a Abler irá enviar um POST para o endpoint registrado naquele evento.
Em seguida serão exibidos a lista de eventos disponíveis.

vacancy_created Webhook

Request Body schema: application/json

Informação sobre o evento de criação de Vaga

vacancy_id
integer
event
string
Value: "vacancy_created"

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "event": "vacancy_created"
}

vacancy_updated Webhook

Request Body schema: application/json

Informação sobre o evento de atualização da vaga

vacancy_id
integer
event
string
Value: "vacancy_updated"

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "event": "vacancy_updated"
}

vacancy_deleted Webhook

Request Body schema: application/json

Informação sobre o evento de exclusão da vaga

vacancy_id
integer
event
string
Value: "vacancy_deleted"

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "event": "vacancy_deleted"
}

candidature_created Webhook

Request Body schema: application/json

Informação sobre o evento de criação de candidatura

vacancy_id
integer
candidate_id
integer
event
string
Value: "candidature_created"

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "candidate_id": 0,
  • "event": "candidature_created"
}

candidature_updated Webhook

Request Body schema: application/json

Informação sobre o evento de atualização de candidatura

vacancy_id
integer
candidate_id
integer
event
string
Value: "candidature_updated"

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "candidate_id": 0,
  • "event": "candidature_updated"
}

candidature_disqualified Webhook

Request Body schema: application/json

Informação sobre o evento de desqualificação de candidato

vacancy_id
integer
candidate_id
integer
event
string
Value: "candidature_disqualified"
disqualified_at
datetime

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "candidate_id": 0,
  • "event": "candidature_disqualified",
  • "disqualified_at": null
}

candidature_requalified Webhook

Request Body schema: application/json

Informação sobre o evento de requalificação de candidato

vacancy_id
integer
candidate_id
integer
event
string
Value: "candidature_requalified"

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "candidate_id": 0,
  • "event": "candidature_requalified"
}

candidate_hired Webhook

Request Body schema: application/json

Informação sobre o evento de contratação de candidato

vacancy_id
integer
candidate_id
integer
event
string
Value: "candidate_hired"
title
string
salary
float
contracting_regime
string
Enum: "aprendiz" "avaliacao_psicologica" "clt" "contrato_hibrido" "estagiario" "freelancer" "intermitente" "periodo_determinado" "pj" "profissional_independente_contrato_societario" "staff" "temporario" "terceiro"
requisition_type
string
Enum: "administracao_contrato" "alocacao" "banco_talentos" "expansao" "hunting" "reposicao" "substituicao"
license
string
name_substituted
string
cpf_substituted
string
contract_time
string
reason_of_demand
string
candidate_name
string
candidate_cpf
string
candidate_email
string
candidate_cell_phone
string <(00) 00000-0000>
candidate_pis
string
candidate_birthday
string <YYYY-MM-DD>
initial_date
date <YYYY-MM-DD>
address
string <Cidade/Sigla Estado>
cost_center
string
working_journey
string
additional_info
string
benefits
string
exclusive_pcd
boolean
team_name
string
customer_id
integer
customer_corporate_name
string
customer_trading_name
string
customer_cnpj
string
customer_contact_name
string
customer_cost_center_id
string
customer_cost_center_code
string
customer_cost_center_name
string
customer_cost_center_place
string

Responses

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "candidate_id": 0,
  • "event": "candidate_hired",
  • "title": "string",
  • "salary": null,
  • "contracting_regime": "aprendiz",
  • "requisition_type": "administracao_contrato",
  • "license": "string",
  • "name_substituted": "string",
  • "cpf_substituted": "string",
  • "contract_time": "string",
  • "reason_of_demand": "string",
  • "candidate_name": "string",
  • "candidate_cpf": "string",
  • "candidate_email": "string",
  • "candidate_cell_phone": "string",
  • "candidate_pis": "string",
  • "candidate_birthday": "string",
  • "initial_date": null,
  • "address": "string",
  • "cost_center": "string",
  • "working_journey": "string",
  • "additional_info": "string",
  • "benefits": "string",
  • "exclusive_pcd": true,
  • "team_name": "string",
  • "customer_id": 0,
  • "customer_corporate_name": "string",
  • "customer_trading_name": "string",
  • "customer_cnpj": "string",
  • "customer_contact_name": "string",
  • "customer_cost_center_id": "string",
  • "customer_cost_center_code": "string",
  • "customer_cost_center_name": "string",
  • "customer_cost_center_place": "string"
}

admission_finished Webhook

Request Body schema: application/json

Informação sobre o evento de finalização de admissão

vacancy_id
integer
candidate_id
integer
event
string
Value: "admission_finished"
pipeline_stage_id
integer
name
string
email
string
cell_phone
string <(00) 00000-0000>
home_phone
string <(00) 0000-0000>
cnh
string
pis
string
cpf
string
birthday
string
gender
string
ethnicity
string
sexual_orientation
string
pronoun
string
disability
string
disability_description
string
cover_letter
string
state
string
city
string
neighborhood
string
cep
string
work_type
string
linkedin_url
string
portfolio_url
string
salary_intended
string
salary_intended_max
string
area_of_interest
Array of strings
level_of_interest
Array of strings
Array of objects
Array of objects

Request samples

Content type
application/json
{
  • "vacancy_id": 0,
  • "candidate_id": 0,
  • "event": "admission_finished",
  • "pipeline_stage_id": 0,
  • "name": "string",
  • "email": "string",
  • "cell_phone": "string",
  • "home_phone": "string",
  • "cnh": "string",
  • "pis": "string",
  • "cpf": "string",
  • "birthday": "string",
  • "gender": "string",
  • "ethnicity": "string",
  • "sexual_orientation": "string",
  • "pronoun": "string",
  • "disability": "string",
  • "disability_description": "string",
  • "cover_letter": "string",
  • "state": "string",
  • "city": "string",
  • "neighborhood": "string",
  • "cep": "string",
  • "work_type": "string",
  • "linkedin_url": "string",
  • "portfolio_url": "string",
  • "salary_intended": "string",
  • "salary_intended_max": "string",
  • "area_of_interest": [
    ],
  • "level_of_interest": [
    ],
  • "national_experiences": [
    ],
  • "educational_profiles": [
    ]
}

Buscar

Busca de subscriptions

Authorizations:
BearerToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Cadastrar

Cadastrar webhook subscription

Authorizations:
BearerToken
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
[]

Buscar pelo id

Busca de subscription pelo id

Authorizations:
BearerToken
path Parameters
id
required
integer

Webhook Subscription id

Responses

Response samples

Content type
application/json
[]

Atualizar pelo id

Atualização de subscription pelo id

Authorizations:
BearerToken
path Parameters
id
required
integer

Webhook Subscription id

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
[]

Deletar pelo id

Deletar subscription pelo id

Authorizations:
BearerToken
path Parameters
id
required
integer

Webhook Subscription id

Responses

Response samples

Content type
application/json
[]