Principal Integrações

Integrações

Integrações
Douglas Vichi
Por Douglas Vichi
3 artigos

📘 Integração via API REST e Webhooks

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. 1. No menu superior do sistema, navegue até Configurações > Integração e localize a seção dedicada à API REST. 2. X-API-KEY: Clique no botão correspondente para gerar a sua chave de integração primária. 3. Authorization Key (Token): Clique no botão indicado para gerar o token de segurança. 4. 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 - Documentação Completa da API do Contele Teams - README e Guias Práticos para Integração REST 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].

Última atualização em Jul 06, 2026

📘 Conectando o Google Data Studio ao Contele Teams

O Google Data Studio é uma poderosa ferramenta de BI (Business Intelligence) que permite centralizar dados, aplicar fórmulas complexas e construir painéis visuais interativos. Ao conectar o Contele Teams ao Data Studio, você ganha total liberdade para cruzar os indicadores das equipes externas e apresentar relatórios gerenciais personalizados para a sua diretoria ou clientes. Passo a Passo para Realizar a Conexão Para facilitar a sua largada, o sistema disponibiliza conectores nativos e modelos pré-configurados estruturados para dois perfis de operação: o Modelo para Equipes Técnicas (focado em tempos de atendimento e ordens de serviço) e o Modelo para Equipes de Vendas (focado em prospecções e positivações). 1. Acesse o link do modelo de dashboard desejado fornecido pelo suporte. 2. No canto superior direito da tela do Data Studio, clique no ícone de três pontos ... e escolha a opção Fazer uma cópia. 3. Na janela de confirmação de origem de dados, clique em Nova Fonte de Dados e selecione a opção Adicionar Nova Fonte. 4. No campo de busca de conectores de parceiros, digite Contele Teams. 5. O conector solicitará uma chave de autenticação para liberar os dados. Para encontrá-la, abra o sistema Web do Contele Teams em outra aba, acesse o menu superior em Configurações > Integração, clique em Usar API Rest e copie o código contido no campo Authorization Key. 6. Retorne à janela do Data Studio, cole a chave no campo indicado e avance. 7. Na seleção de tabelas do conector, escolha a opção Visitas. 8. Finalize clicando no botão Adicionar ao Relatório. O sistema processará as credenciais e carregará o seu novo Dashboard editável. Legenda de Dados do Conector (Mapeamento de Campos) Os dados brutos das suas visitas são transmitidos ao Data Studio utilizando termos e parâmetros universais. Utilize a tabela de equivalência abaixo para montar as suas dimensões e filtros de gráficos: Customização Avançada com Fórmulas Uma das grandes vantagens do Data Studio é a possibilidade de criar novas métricas combinando campos. Você pode, por exemplo, criar um campo calculado para descobrir o tempo exato em minutos que a equipe gasta dentro dos clientes aplicando a fórmula: DATETIME_DIFF(Data e Hora do Check-out, Data e Hora do Check-in, MINUTE) Limites e Restrições Técnicas da Conexão Para manter a estabilidade no carregamento dos painéis e evitar lentidões, fique atento aos limites de requisição do conector: - Vinculação de Contas: É permitida a conexão de apenas uma conta do Contele Teams por conta do Google. Caso você gerencie os dados de duas ou mais empresas distintas, será necessário utilizar contas do Google diferentes para construir cada painel. - Limite de Colunas: Cada relatório ou gráfico estruturado suporta a plotagem de no máximo 20 colunas simultâneas. - Volume de Dados: O conector suporta o processamento de um teto máximo de até 200.000 registros (visitas) por relatório. Caso sua empresa possua um histórico superior a este volume, utilize os filtros de período do dashboard para segmentar os gráficos por fatias de meses. Dúvidas Frequentes sobre o Data Studio Quais dados do sistema eu consigo puxar para os gráficos? Atualmente, o conector nativo disponibiliza todas as dimensões e métricas estruturais relacionadas ao módulo de Visitas (incluindo tempos, status, locais e usuários). Nossa equipe de engenharia estuda a liberação de novos endpoints para abranger outros módulos nas próximas atualizações. Como posso compartilhar o Dashboard pronto com a minha equipe ou diretoria? O compartilhamento é feito pelas ferramentas nativas do ecossistema do Google. Clique no botão Compartilhar localizado no topo do painel e selecione o método: você pode disparar convites diretos por e-mail, gerar um link de leitura pública, exportar um arquivo em formato de relatório ou obter o código de incorporação (iframe) para fixar o gráfico dentro do site ou portal interno da sua empresa. Consigo monitorar o planejamento de Visitas futuras pelo painel? Sim. O conector realiza a leitura de todas as visitas que já possuem uma data programada na agenda da Web, cobrindo o status de pending. No entanto, fique atento: rotinas de visitas configuradas no módulo de recorrência só passam a contar no gráfico quando o sistema efetivamente gera a visita física correspondente na agenda. É possível puxar as Etiquetas das Visitas para criar filtros no Data Studio? No momento, as etiquetas de visitas não estão disponíveis como dimensão dentro do conector de dados. Essa melhoria já está mapeada no nosso cronograma de desenvolvimento e notificaremos todos os administradores assim que o campo for homologado e liberado.

Última atualização em Jul 06, 2026