Admissão → colaborador + linha

​

O que você precisa

• Uma chave de API de empresa. Chaves de organização são somente leitura e não criam colaboradores nem linhas. Veja Chaves de API.
• Os dados da admissão vindos do seu sistema de RH: nome, e-mail profissional ou CPF e, se quiser, cargo, área e data de admissão.
• O nome do plano da linha e, se usar, o centro de custo (nome ou código).
• O DDD da linha e o ICCID do chip físico que a pessoa vai usar (o ICCID completo ou os últimos 7 a 10 dígitos).

​

Passo a passo

curl -G "https://api.salvy.com.br/api/v3/cost-centers" \
  -H "Authorization: Bearer $SALVY_API_KEY" \
  --data-urlencode "status=active" \
  --data-urlencode "pageSize=200"

{
  "data": [
    { "id": "0198c2f1-3815-45b7-9e60-8e137cad845c", "code": "COMERCIAL", "name": "Comercial", "status": "active" }
  ],
  "pagination": { "page": 1, "pageSize": 200, "totalCount": 1, "totalPages": 1 }
}

curl "https://api.salvy.com.br/api/v3/plans" \
  -H "Authorization: Bearer $SALVY_API_KEY"

{
  "data": [
    { "id": "0197aa3e-3815-45b7-9e60-8e137cad845c", "name": "Plano 20GB", "productType": "mobile", "availableDataAmountGB": 20, "priceCents": 4500 }
  ]
}

curl -X POST "https://api.salvy.com.br/api/v3/employees" \
  -H "Authorization: Bearer $SALVY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "idempotency-key: admissao-joaosilva@empresa.com.br-2026-10-01-employee" \
  -d '{
    "fullName": "João da Silva",
    "status": "active",
    "workEmail": "joaosilva@empresa.com.br",
    "cpf": "198.099.750-07",
    "position": "Analista de Vendas",
    "area": "Comercial",
    "admittedAt": "2026-10-01",
    "costCenterId": "0198c2f1-3815-45b7-9e60-8e137cad845c"
  }'

curl -X POST "https://api.salvy.com.br/api/v3/phone-accounts/mobile" \
  -H "Authorization: Bearer $SALVY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "idempotency-key: admissao-joaosilva@empresa.com.br-2026-10-01-phone-account" \
  -d '{
    "simType": "physical",
    "iccid": "1234567890",
    "subscriptionPlanId": "0197aa3e-3815-45b7-9e60-8e137cad845c",
    "areaCode": 11,
    "employeeId": "123e4567-e89b-12d3-a456-426614174000",
    "costCenterId": "0198c2f1-3815-45b7-9e60-8e137cad845c",
    "name": "Linha João da Silva"
  }'

​

Sem código: workflow do n8n

1. No n8n, crie um workflow e importe o arquivo (menu ⋯ > Import from File, ou cole o conteúdo do arquivo no editor).
2. Crie uma credencial Bearer Auth com a sua chave de API e selecione-a nos quatro nós HTTP.
3. Preencha o nó Dados de teste e execute. O workflow começa em modo simulação (dryRun = true no nó Configuração): ele consulta centros de custo e planos e mostra o colaborador e a linha que seriam criados, com o valor do plano, sem criar nada.
4. Quando o resultado estiver certo, troque dryRun para false. Para rodar automaticamente, ative o workflow e faça o seu sistema de RH chamar a URL do nó Webhook do RH com os dados da admissão. O formato do corpo está nas notas do workflow.

​

Como implementar

• Gatilho: um webhook do sistema de RH a cada admissão, uma rotina diária que busca as admissões do dia ou um botão no seu sistema interno.
• Modo simulação primeiro. Comece com uma versão que só consulta e mostra o colaborador e a linha que seriam criados, com o plano e o valor, sem fazer as chamadas de escrita. Confira o resultado e só depois ative as escritas.
• Chaves de idempotência: monte as chaves a partir do evento de admissão (e-mail ou CPF e data de admissão), nunca de algo que muda a cada execução.

​

Cuidados

​

Variações

• eSIM em vez de chip físico. Envie simType: "esim" sem iccid. Assine phone-account.esim-ready para saber quando o código de ativação está pronto e busque-o em Dados do eSIM para enviar à pessoa.
• Avisar o gestor. Ao final, envie para o Slack, Teams ou e-mail do gestor um resumo com o nome do colaborador, o plano e o status da linha.
• Desligamento. Para o caminho inverso, quando a pessoa sai da empresa, veja Desligamento → bloqueio de linhas.