Visão Geral

A plataforma Textualiza oferece funcionalidades para gerar descrições de cargos e vagas de emprego através da interface web ou integração via API com inteligência artificial.

Usando a Interface (UI)

Navegação Inicial

Acesse o menu lateral do painel e selecione “Descrições de Cargo” dentro das seções “Conteúdo” e “RH”.

Campos Obrigatórios

Ao criar uma nova descrição, preencha:

Título do Cargo: Nome da posição (exemplo: Desenvolvedor Back-End)
Departamento: Setor organizacional
Tipo de Contrato: Modalidade (estágio, efetivo, prestação de serviços)
Senioridade: Nível de experiência (Estagiário até Master)
Requisitos: Habilidades e formação desejadas
Responsabilidades: Tarefas e obrigações do profissional
Informações da Empresa: Nome, resumo (missão/visão/valores) e setor de atuação

Geração de Conteúdo

Clique em “Gerar Descrição” para que o sistema utilize IA e produza um texto completo que você pode revisar e editar conforme necessário.

Integração via API

Autenticação

Obtenha sua chave de API em “Conta” > “Perfil” no painel.

Endpoint e Requisição

URL: POST https://textualiza.com.br/api/content/jobs/description/

Headers necessários:

Authorization: Bearer SUA_CHAVE_DE_API
Content-Type: application/json

Estrutura de Dados

O corpo da requisição deve incluir input_data contendo os seguintes campos:

{
  "input_data": {
    "job_title": "Desenvolvedor Back-End",
    "department": "Tecnologia",
    "contract_type": "Efetivo",
    "seniority_level": "Sênior",
    "requirements": [
      "Experiência em desenvolvimento web",
      "Conhecimento em JavaScript, Python e Django",
      "Habilidade em trabalhar com bancos de dados relacionais"
    ],
    "responsibilities": [
      "Desenvolver novas funcionalidades para o sistema",
      "Manter e otimizar os sistemas existentes",
      "Colaborar com outras equipes para integrar soluções"
    ],
    "company": {
      "name": "Tech Solutions",
      "short_bio": "Empresa de tecnologia focada em soluções B2B.",
      "industry": "Tecnologia"
    }
  }
}

Exemplo com cURL

curl -X POST https://textualiza.com.br/api/content/jobs/description/ \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "input_data": {
      "job_title": "Desenvolvedor Back-End",
      "department": "Tecnologia",
      "contract_type": "Efetivo",
      "seniority_level": "Sênior",
      "requirements": ["Experiência em desenvolvimento web"],
      "responsibilities": ["Desenvolver novas funcionalidades"],
      "company": {
        "name": "Tech Solutions",
        "short_bio": "Empresa de tecnologia focada em soluções B2B.",
        "industry": "Tecnologia"
      }
    }
  }'

Resposta

A API retorna um JSON com output_data contendo o campo job_description com o texto gerado pela IA.

Recomendações

Segurança: Preserve a confidencialidade da sua chave de API.
Testes: Teste em ambientes de desenvolvimento antes de produção.
Personalização: Customize os dados enviados para refletir as necessidades específicas do cargo.

Como Criar Descrição de Cargo na Plataforma Textualiza