Pular para o conteúdo
Português - Brasil
  • Não há sugestões porque o campo de pesquisa está em branco.

Como funcionam as integrações não nativas na Qulture.Rocks

O que são integrações não nativas

Integrações não nativas são aquelas que não fazem parte das conexões oficiais disponíveis na plataforma.
Ou seja, são integrações desenvolvidas diretamente pelo cliente (ou por terceiros) no sistema que irá utilizar, utilizando a API pública da Qulture.Rocks ou outros mecanismos externos (como scripts, automações em ferramentas de integração, ou sistemas internos).

Essas integrações não estão disponíveis na interface da Qulture.Rocks e não contam com suporte sobre código, estrutura ou funcionamento, já que dependem de lógicas criadas por terceiros.
Em geral, são criadas para atender necessidades específicas de negócio, como sincronizar dados de pessoas, avaliações ou resultados entre sistemas internos do cliente e a Qulture.Rocks.

Como funcionam

De forma geral, uma integração não nativa:

  1. Utiliza a API da Qulture.Rocks para enviar ou receber dados (via endpoints REST ou GraphQL);

  2. É executada por um sistema externo ao ambiente da Qulture.Rocks — por exemplo, um servidor interno, ferramenta de automação (como Make, Zapier ou Power Automate) ou aplicação própria do cliente;

  3. Depende de lógicas e regras de negócio definidas pelo cliente, como periodicidade de execução, tratamento de erros, autenticação e transformações de dados.

Como não há controle da Qulture.Rocks sobre o ambiente externo, a responsabilidade pela criação, manutenção e funcionamento dessas integrações é do cliente.

Aspecto Integração Nativa Integração Não Nativa
Disponibilidade Está listada na plataforma Qulture.Rocks Criada e mantida pelo cliente
Configuração Sincronização de campos realizado via QR (Cliente disponibiliza token direto na plataforma nativa. Ex: Convenia) Realizada por meio de código ou automação externa
Suporte técnico Campos pré configurados em QR. Suporte limitado a dúvidas sobre a API
Validação Testada e validada pela Qulture.Rocks Não validada nem monitorada pela equipe técnica
Dependência técnica Nenhuma. É pré configurado na plataforma e os ajustes são feitos direto pelo cliente. Requer conhecimento técnico e desenvolvimento próprio
Fonte de dados APIs e recursos internos da Qulture API pública (REST/GraphQL) da Qulture.Rocks

⚠️Observação: a API da Qulture.Rocks está em fase Beta, portanto nem todas as funcionalidades disponíveis na interface estão acessíveis via API.


Suporte e responsabilidades

O time de suporte pode auxiliar somente em pontos relacionados à API, como estrutura de requisições, autenticação e interpretação de erros.
O comportamento da integração (como implementação, lógica de execução, sincronização e regras de negócio) é responsabilidade do cliente.

O time de suporte pode:
✅ Orientar sobre o uso da API (endpoints, autenticação, limites, parâmetros);
✅ Ajudar a interpretar erros retornados pela API (ex.: mensagens 400, 401, 404 ou 500);
✅ Esclarecer dúvidas sobre dados acessíveis via endpoints documentados.

O time de suporte não pode:
❌ Depurar ou alterar códigos desenvolvidos externamente;
❌ Garantir o funcionamento de automações fora da plataforma;
❌ Investigar regras aplicadas em sistemas terceiros;
❌ Corrigir erros de autenticação, agendamento ou sincronização causados por ambientes externos.

Exemplo de uso típico

Um exemplo comum de integração não nativa é uma automação que:

  1. Usa a API REST para atualizar informações de usuários na Qulture.Rocks vindas de seu sistema interno (Sênior, ADP, SAP., entre outros não nativos);

  2. Consulta a API GraphQL para obter os dados de OKRs/Pesquisa de Clima/Feedback e combina essas informações em um relatório ou dashboard interno da empresa;

Onde encontrar informações oficiais

Para garantir o bom funcionamento das integrações, utilize sempre os canais oficiais: