A integração de sistemas permite automatizar processos, centralizar dados e aumentar drasticamente a produtividade da sua operação de campo. O Contele Teams oferece soluções robustas para conectar a plataforma com o seu ERP, CRM, sistemas proprietários ou planilhas eletrônicas.
Formas de Integrar o Seu Sistema
Para realizar a comunicação de dados, o sistema disponibiliza dois métodos principais voltados para desenvolvedores:
-
API REST: É uma aplicação de integração estruturada que funciona como uma "ponte" segura, permitindo ao Contele Teams receber ou enviar dados para qualquer software externo. Por meio dela, você pode automatizar comandos e gerenciar dados de Locais e Visitas (como cadastrar, editar ou deletar registros de forma 100% automatizada).
-
Webhooks: Mecanismo de disparo que envia notificações em tempo real sobre eventos ocorridos dentro do Contele Teams diretamente para a URL do seu sistema, eliminando a necessidade de consultas manuais repetitivas.
Pré-requisitos para Iniciar a Integração
Para garantir a estabilidade dos servidores e o suporte técnico avançado às demandas de dados, sua empresa deve cumprir os seguintes critérios:
-
Possuir um saldo mínimo de 5 licenças ativas no sistema.
-
Contar com um desenvolvedor profissional ou equipe de TI para programar a comunicação entre as plataformas.
-
Ter em mãos a documentação técnica dos sistemas que deseja integrar.
-
Compreender detalhadamente as regras de negócio da automação (por exemplo: determinar que, sempre que um novo cliente for cadastrado no seu sistema de faturamento "X", a API deve criar automaticamente esse Local dentro do Contele Teams).
O que o seu desenvolvedor precisa dominar?
-
Conhecimento prático em arquitetura de APIs REST e tratamento de Webhooks.
-
Domínio da API e do fluxo de uso do sistema que será conectado ao Contele Teams.
-
Alinhamento prévio sobre as regras de tratamento de erros e respostas da requisição.
Como Gerar as Chaves de Integração no Sistema
Para validar a segurança das requisições, o desenvolvedor precisará de credenciais exclusivas de autenticação.
Atenção: Esse procedimento deve ser realizado obrigatoriamente por um usuário com perfil de Administrador.
-
No menu superior do sistema, navegue até Configurações > Integração e localize a seção dedicada à API REST.
-
X-API-KEY: Clique no botão correspondente para gerar a sua chave de integração primária.
-
Authorization Key (Token): Clique no botão indicado para gerar o token de segurança.
-
Configuração de Webhook: Se for utilizar Webhooks para capturar eventos em tempo real, acesse o menu superior em Configurações > Sua Empresa, role a página até o bloco Configurações da API e insira a URL de destino do seu servidor.
Atenção: Ao configurar a chave de autenticação (Authorization) nas requisições do seu código, é obrigatório adicionar o prefixo Bearer (com o espaço em branco) logo no início do campo de cabeçalho (Header).
Links de Apoio ao Desenvolvedor
Contele Teams Tech Stack (Para Equipes de TI)
Caso a sua equipe técnica precise validar a compatibilidade de arquitetura e infraestrutura, nossa stack é composta por:
-
Frontend: HTML, CSS e JavaScript (AngularJS).
-
Backend: Node.js (JavaScript).
-
Banco de Dados e Cache: PostgreSQL, Redis, DynamoDB e ElasticSearch.
-
Hospedagem: Infraestrutura em nuvem na Amazon Web Services (AWS) sob o modelo IaaS (Infrastructure as a Service), contando com tráfego e comunicação de dados totalmente criptografados.
Observação: Se o seu fornecedor atual de software não possuir uma API aberta ou não oferecer suporte para integrações, nossa equipe pode avaliar o desenvolvimento de um projeto personalizado de barramento de dados. Para entender viabilidades e custos de manutenção, envie uma solicitação formal para o e-mail [email protected].