Principal Integrações

Integrações

Integrações
Marco Antonio Fassa
Por Marco Antonio Fassa
11 artigos

Zapier: Automatize ações a partir de Formulários respondidos no APP Contele Equipes

Conteúdos de Pré-Requisito Antes de continuar com o artigo, é recomendado que você consulte os seguintes conteúdos: - Introdução ao Zapier - Conectar Contele ao Zapier Como Capturar Respostas do Formulário O trigger que você deve utilizar é o Form Answered (Formulário Respondido). analisefiscal-enviarformulario_18ufhpb Dessa forma, o Zapier receberá do Contele Equipes todas as respostas de cada formulário respondido individualmente. Tem-se disponível a resposta do formulário e o nome do formulário, ou seja, as informações do modelo configurado no Contele, incluindo dados do usuário que respondeu e do local da visita. As próximas ações dependerão da sua necessidade, conhecidas como Actions no Zapier. Você poderá manipular essas informações conforme sua utilização. Dicas e Ideias 1. Filtre Campos de Pesquisa Utilize a função Filter do Zapier caso precise apenas da resposta de um formulário específico. No filtro, você pode restringir por outros campos, como Usuário, Local e até mesmo o conteúdo da própria resposta do formulário. 2. Filtre o Formulário pela Palavra-chave Semelhante à dica anterior, você pode filtrar por uma palavra-chave presente na resposta do formulário. Isso permite identificar e ativar ações no seu fluxo de trabalho (Workflow). 3. Receba as Respostas por E-mail Você pode enviar a resposta como aviso ou alerta para um endereço de e-mail específico. Por exemplo, se você tiver um formulário intitulado "Pedido de Compras", utilize o Filter para filtrar pelo título e uma Action de E-mail para enviar ao setor de compras ([email protected]). Assim, eles receberão um e-mail formatado como você desejar, sempre que o formulário for respondido. 4. Preencha uma Planilha com as Respostas do Formulário É possível criar uma Action com o Google Planilhas para que, toda vez que um formulário for preenchido, suas respostas sejam registradas em uma linha de uma planilha selecionada por você. No vídeo abaixo, você pode ver um exemplo de criação de locais no Contele Gestor de Equipes utilizando uma planilha, que pode ser adaptado para o seu caso: Assista ao vídeo Como Configurar Zapier para Automatizar Cadastro de Locais

Última atualização em Jan 27, 2025

API Contele Gestor de Equipes para Integração com Outros Sistemas

O que é API? A API Rest é uma aplicação de integração que permite ao Contele Gestor de Equipes enviar dados para qualquer sistema. Assim, é possível realizar comandos customizados em conjunto com outro sistema ou, até mesmo, planilhas Excel. Vantagens da Integração via API Rest A utilização da API Rest permite trazer diversas funcionalidades ao sistema, aumentando assim a produtividade. Os dados liberados para integração são: - Locais (Places) - Visitas (Tasks) Através da nossa API REST, é possível cadastrar, editar ou deletar Visitas e Locais de forma automática. Assista ao vídeo Pré-requisitos Para realizar a integração dos sistemas através do Contele Gestor de Equipes, os pré-requisitos são: 1. Você precisará de um desenvolvedor para fazer a integração. 2. Possuir documentação técnica dos sistemas que deseja integrar. 3. As chaves de integração do Contele Gestor de Equipes. 4. Ter um mínimo de 5 licenças no sistema. Além disso, o seu desenvolvedor precisa compreender as regras de negócio da integração que deseja realizar. Por exemplo: cadastrar um novo Local no Contele quando determinado evento ocorrer no sistema "X" que o cliente está utilizando. O que o Desenvolvedor Precisa? - Conhecimento em integrações com API Rest. - Conhecimento na API do sistema a ser integrado com o Contele. - Conhecimento do sistema Contele Gestor de Equipes. - Conhecimento do sistema a ser integrado. - Fluxo de uso dos dois sistemas. - Regras de negócio. É importante que o desenvolvedor também entenda o funcionamento dos dois sistemas, bem como o fluxo de utilização e as documentações de integração de cada um. Muitos sistemas utilizam o mesmo tipo de integração que o Contele Gestor de Equipes adota. No entanto, é recomendado verificar a documentação do outro sistema antes de realizar a integração. Documentação Técnica do Contele Gestor de Equipes Consulte a documentação técnica do Contele Gestor de Equipes para saber com mais detalhes os campos disponíveis em cada recurso do sistema: - Readme para integração Rest - Documentação completa Chave de Integração Para integrar via API do Contele Gestor de Equipes com outros sistemas, são necessárias duas Chaves de Integração. Você pode encontrá-las na página de integração, na seção de API Rest. (Observação: é necessário um usuário com perfil de administrador). Como Gerar as Chaves de Integração: - Authorization key: Clique no botão "Clique aqui para gerar sua Chave Zapier". - X-API-KEY: Clique no botão "Clique aqui para gerar sua Chave de Integração". - Webhook da documentação da API: Vá em Configurações > Sua empresa, e desça a tela até Configurações da API. Quando for utilizar a Chave Authorization, adicione o prefixo Bearer no começo.

Última atualização em Jan 27, 2025

Como Enviar Convites Automaticamente no Calendário (Google, Outlook,etc) com a Integração do Zapier

Como Enviar um Convite na Agenda Usando o Zapier e Contele Gestor de Equipes Aprenda a configurar o envio automático de convites de agenda sempre que for marcada uma visita, utilizando o Zapier em conjunto com o Contele Gestor de Equipes. Introdução Integração com o Zapier Antes de começar, caso ainda não tenha conectado o Contele ao Zapier, siga as instruções detalhadas neste tutorial do Contele. Se já completou essa etapa, estamos prontos para seguir adiante! Recursos visuais Além deste guia, você pode assistir ao vídeo completo que resume o processo passo a passo: Assista ao vídeo Configurando o Trigger no Zapier Usando o Trigger "New Visit" (Nova Visita) 1. Selecione o trigger "New Visit" (Nova Visita). Trigger Image Aplicando Filtros no Zapier 2. Adicione filtros no Zapier conforme necessário. Por exemplo, você pode filtrar apenas contatos com e-mail e um horário de agendamento definido no Contele Gestor de Equipes para garantir que o convite seja enviado corretamente. Se os critérios não forem atendidos, o convite não será enviado. Filtro Image Exemplos de Filtros - Email do Contato do POI: Configure para que o texto contenha "@" - Data/Hora do Agendamento: Configure para que o texto não contenha "03:00:0.000Z" Associando ao Google Calendar 3. Adicione o Google Calendar ou outro calendário de sua preferência. Faça a associação dos campos enviados pelo Zapier para que o convite do calendário seja enviado corretamente. Aqui estão alguns campos relevantes: Associação Image Resultado Final Abaixo está um exemplo do resultado após seguir as etapas acima. Resultado Image Para mais informações, acesse o artigo sobre como enviar convites automaticamente no Google Calendar, Outlook, etc., com a integração do Zapier.

Última atualização em Jan 27, 2025

Introdução ao Zapier

O que é Zapier? O Zapier é uma ferramenta integradora que facilita a automação de ações entre diferentes aplicativos e softwares que sua empresa utiliza. Com o Zapier, você poderá integrar milhares de sistemas com o Contele Gestor de Equipes, como ERPs, CRMs, entre outros. Assista ao vídeo Como Criar Conta no Zapier No site do Zapier, você encontra uma caixa de cadastro de contas. O Zapier disponibiliza três opções de cadastro rápido, permitindo o uso de uma conta do: - Google - Facebook - Microsoft Caso prefira utilizar um outro e-mail que não seja nenhum destes, você pode preencher um campo de e-mail, nome e sobrenome. Assista ao vídeo Como Pesquisar Aplicativos e Softwares no Zapier O Zapier oferece fluxos para automatizar o uso de aplicativos da web, permitindo que trabalhem de forma conjunta. Ele funciona como um tradutor entre APIs da web e é compatível com mais de 3.000 aplicativos. Para pesquisar quais programas podem ter os processos automatizados, vá para a página inicial do Zapier. Clique no ícone de uma lupa para abrir uma caixa de pesquisa e digite o nome do aplicativo desejado. Dica: Muitas aplicações estão na categoria beta e, por isso, não aparecem na pesquisa. Caso não consiga encontrar um aplicativo, você pode solicitar a adição do aplicativo ao Zapier. Como Fazer a Integração Via Zapier do Sistema que Uso com o Contele Gestor de Equipes 1. Na Tela Inicial, Crie um "Zap" Após realizar o login em sua conta, clique em “Create Zap” no canto superior esquerdo da tela inicial do Zapier. 2. Construa a Integração Nesta tela, você escolherá um Gatilho (Trigger), que é o que irá ativar a automação, como, por exemplo, a conclusão de uma visita no Contele Gestor de Equipes. Após esse Gatilho, será executada uma Ação (Action), como preencher uma planilha com os dados dessa visita. 3. Introduza a Chave de Integração do Contele Seja em um Gatilho ou em uma Ação, para o Contele Gestor de Equipes permitir o acesso aos dados, é necessário a Chave de Integração. Você pode encontrar as chaves na página de integração do sistema. Basta clicar em "Clique aqui para gerar sua Chave Zapier". Ao ser solicitado, conecte-se ao Contele Gestor de Equipes cole a chave no campo solicitado e clique em "Yes, Continue". Cole o código neste campo 4. Faça sua Integração Agora, basta criar suas integrações. Aqui estão alguns artigos que apresentam exemplos de automações: - Como criar ''Locais'' automaticamente com o Google Planilhas - Como enviar convites automaticamente no Calendário (Google, Outlook, etc) com a integração do Zapier - Agendar Visitas por Integração - Agendar Visitas em Massa com uma Planilha Online - Avisar Meu Cliente Quando Usuário Chegar no Local (Trigger: Visit Check-in) - Zapier: Automatize ações a partir de Formulários respondidos no APP Contele Equipes Explore mais sobre o Zapier no nosso blog.

Última atualização em Jan 27, 2025

FAQ: Dúvidas Frequentes sobre Integração e API

Integração com o Contele Gestor de Equipes Formas de Integrar seu Sistema Existem três formas de integrar o Contele Gestor de Equipes com um sistema: 1. API Rest - Você precisará de nossa documentação, da documentação do sistema que deseja integrar e de um desenvolvedor. 2. Webhook - Receba em tempo real dados de eventos do Contele para integrar com outros sistemas. Também requer documentação e um desenvolvedor. 3. Zapier - Uma ferramenta integradora que facilita a comunicação entre softwares. Permite integração do Contele Gestor de Equipes com mais de 3.000 softwares sem necessidade de um desenvolvedor. O que é necessário para a Integração? Para integrar o sistema que você usa com o Contele Gestor de Equipes, você precisará de: - Documentação da API do Contele Gestor de Equipes. Veja mais aqui. - Documentação da API do sistema com o qual deseja fazer a integração. - Um desenvolvedor para interpretar as informações e criar a comunicação entre os sistemas. O que é uma API? API é um conjunto de normas que facilita a comunicação entre plataformas e sistemas por meio de padrões e protocolos. Funciona como uma “ponte” para conectar aplicações ou informações entre diferentes sistemas, simplificando o trabalho dos desenvolvedores e oferecendo um padrão seguro para integração. Como Obter a Documentação da API? - O Contele Gestor de Equipes mantém uma página com toda a documentação necessária para integração. Você pode acessá-la aqui. - Para a documentação do sistema que você usa, entre em contato com a empresa desenvolvedora. Possibilidades de Integração Qualquer software pode integrar-se com o Contele Gestor de Equipes, desde calendários e planilhas de Excel até sistemas com acesso à internet. Quantidade Mínima de Licenças Necessária São necessárias ao menos cinco licenças ativas para liberar a API. Isso se deve à necessidade de liberar servidores e suporte técnico avançado para atender as demandas de API. Integração pelo Zapier Requisitos Para integrar o Contele Gestor de Equipes pelo Zapier, você precisará: - Criar uma conta no Zapier. - Dados de acesso (login e senha) do Contele Gestor de Equipes e do sistema de integração. - Token do Contele Gestor de Equipes. Como Obter o Token? Há um artigo específico sobre como obter o Token. Clique aqui para mais detalhes. Necessidade de Desenvolvedor Não é necessário um desenvolvedor para integração via Zapier, mas é importante conhecer bem o funcionamento dos sistemas e seus fluxos de trabalho. Termos Importantes no Zapier - ZAP: Um tipo de integração. Por exemplo, integrar o Contele Gestor de Equipes com outro sistema é contado como um zap. - Ação: Uma atividade de comunicação entre sistemas. Exemplo: enviar um novo cliente de seu sistema para o Contele Gestor de Equipes automaticamente. - Trigger: Um "gatilho" que é acionado quando ocorre uma ação. Encontrando Sistemas para Integração no Zapier Para descobrir quais programas podem ser automatizados, faça uma pesquisa na página inicial do Zapier usando o ícone de lupa. Problemas ao Encontrar um Sistema Se o software desejado não estiver disponível, ele pode estar em processo de integração com o Zapier. Entre em contato com o setor de desenvolvimento do software ou solicite a adição do aplicativo ao Zapier. Projetos de Integração Personalizada Se seu fornecedor não oferece integração, podemos desenvolver um projeto personalizado mediante custo de desenvolvimento e manutenção. Para isso, entre em contato pelo e-mail [email protected]. Informações de Solicitação Somente o Gestor ou alguém autorizado pode solicitar informações sobre API/Integração. Leia mais sobre integrações e APIs

Última atualização em Jan 27, 2025

Agendar Visitas em Massa com uma Planilha Online

Agendamento de Visitas em Massa no Contele Gestor de Equipes No Contele Gestor de Equipes, você pode realizar o agendamento de visitas em massa utilizando uma planilha online. Este processo é facilitado pelo uso da ação do Zapier para agendar uma visita. Como Funciona A seguir, é apresentado um exemplo utilizando como gatilho novas linhas de uma planilha Google para realizar o agendamento. Os campos obrigatórios para o agendamento são: - E-mail do Usuário que irá receber a visita. - ID do Local no Contele. - Termo "Tomorrow" para agendar visitas para o dia seguinte, sem horário definido. Caso você não esteja familiarizado com o Zapier, leia este artigo introdutório: Introdução ao Zapier. Exemplo de Configuração Dicas - Você pode passar a data como variável na planilha para agendar conforme a data fornecida. No exemplo apresentado, a necessidade era realizar o agendamento para o dia seguinte. Observações Neste exemplo, exportei todos os locais do Contele e abri em uma planilha Google. Adicionei uma coluna para colocar o e-mail do usuário para as visitas desejadas e copiei as informações para uma nova página, nomeada de "Agendar". Configuração da Planilha Resultado do Exemplo Resultado do Exemplo Espero que este artigo inspire você a encontrar a forma ideal de trabalho para realizar um agendamento em massa de maneira mais simples! Vídeo Demonstrativo Veja o vídeo abaixo para uma demonstração e alguns comentários sobre outras possibilidades: Assista ao vídeo no YouTube

Última atualização em Jan 27, 2025

Agendar Visitas por Integração

Guia Avançado: Agendar Visitas de Forma Integrada e Automática Este guia é para ajudá-lo a agendar visitas no Contele Gestor de Equipes de forma automática a partir de sistemas, planilhas ou mais de 1500 aplicativos integrados com o Zapier. Ele explica os campos da ação de agendamento de visitas (Schedule Visit) do Contele Gestor de Equipes, disponível no Zapier. Existem muitas possibilidades de integração, desde agendar uma visita com uma planilha online até realizar uma integração completa dentro do Contele Gestor de Equipes. Por exemplo, você pode configurar para que, ao responder uma determinada pergunta em um formulário, o Zapier agende automaticamente uma nova visita nesse local. Pré-requisitos Antes de prosseguir, recomendamos a leitura dos conteúdos introdutórios ao Zapier e ao Contele Gestor de Equipes: - Introdução ao Zapier (link removido) - Como encontrar o Contele Gestor de Equipes no Zapier, gerar Token e conectar a conta (link removido) Se você já leu os conteúdos acima ou já conhece o Zapier, vamos em frente: Ação de Agendar Visita no Contele Gestor de Equipes Campos Necessários para Agendar uma Visita Os campos obrigatórios para agendar uma visita são: 1. Usuários (User): Você pode selecionar um usuário específico na lista, que ficará fixo para essa automação, ou usar um customizado. Para isso, é necessário fornecer um e-mail que corresponda ao usuário cadastrado no Contele Gestor de Equipes. Clique para abrir a janela até o fim e escolha a opção "Use a Custom Value" para inserir o e-mail do usuário. Passando e-mail do Usuário 2. Local (Place): Utilize o ID do local ou o nome. O sistema encontrará o local com o nome mais aproximado do que foi fornecido. Para maior precisão, tente passar o nome o mais semelhante possível ao cadastrado no sistema. A melhor dica é exportar todos os locais do Contele e sincronizá-los com sua base de dados, passando o ID Contele ou o nome do local cadastrado. Custom Value for Place Exemplo No exemplo acima, estou usando um valor personalizado e o nome do local exportado do Contele (idêntico), pois estou dentro de uma planilha onde a primeira aba contém todos os locais que exportei. Na segunda aba, que integrei com o Zapier, trago o nome do local da primeira aba. Confira o modelo da minha planilha. 3. Data da Visita (Schedule Date): Insira a data e hora completa no formato yyyy-mm-dd hh:mm ou apenas a data. Caso utilize apenas a data, mantenha o parâmetro "NO" no campo "Consider scheduling time?" (opcional). Você também pode usar "Today" para agendar para o mesmo dia, pois o campo aceita os formatos de data/hora disponíveis no Zapier. Campos Opcionais - Details: Detalhes ou instruções da visita. - Observation: Observações podem ser utilizadas para adicionar detalhes antes e durante a visita. - Custom OS: Campo para identificação da Ordem de Serviço personalizada. Permite letras e números. Esse valor ficará associado a cada visita e poderá ser encontrado em relatórios de visita, exportação e pesquisas no sistema. Use-o para associar a visita com outro sistema ou controle. Para mais informações, acesse o artigo completo.

Última atualização em Jan 27, 2025

Como conectar o Contele Gestor de Equipes no Looker Studio (Data Studio) + Modelo de Dashboard

Conectando o Looker Studio ao Contele Gestor de Equipes O que é o Looker Studio? Assista ao vídeo O Looker Studio, anteriormente conhecido como Data Studio, é uma ferramenta de BI (Inteligência de Negócio) do Google. Ela permite a criação de relatórios e painéis informativos personalizados a partir de bancos de dados e planilhas. Você pode integrar o Contele Gestor de Equipes ao Looker Studio para criar relatórios customizados e visualizar informações da forma que preferir. Como conectar o Looker Studio ao Contele Gestor de Equipes Escolha o Modelo Desejado Modelos de Dashboards para Equipes Externas Existem dois modelos de dashboard disponíveis: - Modelo para Equipes Técnicas - Modelo para Equipes de Vendas Para utilizá-los, siga as instruções: 1. Acesse o modelo desejado. 2. Clique nos três pontos no canto superior direito e escolha "Fazer uma cópia". Fazer uma Cópia 3. Em "Nova Fonte de Dados", clique em "Adicionar Nova Fonte" e procure por "Contele Gestor de Equipes". Adicionar Nova Fonte de Dados Gerando as Chaves de Conexão Após a escolha do modelo, o Looker Studio solicitará um token do Contele Gestor de Equipes para acessar seus dados. Siga os passos abaixo: 1. No Contele Gestor de Equipes, vá em Configurações > Integração. 2. Clique no botão "Usar API Rest". 3. Desça a página e clique em "Clique para gerar suas Chaves de Integração". 4. Copie a "Authorization Key". Processo de Geração de Chaves Volte ao Looker Studio, cole a Authorization Key no campo correspondente. Após isso, o Looker Studio te direcionará para uma nova página onde você deverá escolher a opção “Visitas” em "Fonte de Dados". Finalize clicando no botão "Adicionar ao Relatório". Esse processo te levará ao seu Dashboard. Recursos do Looker Studio: Gráficos, Campos, Dimensões, Cores, etc. Assista ao vídeo No Looker Studio, você pode editar os Dashboards conforme preferir, adicionando dados e gráficos conforme necessário. Para alcançar isso, adicione fórmulas. Por exemplo: DATETIME_DIFF(Data e Hora do Check-out, Data e Hora do Check-in, MINUTE) Veja uma lista de fórmulas possíveis clicando aqui. Legenda de Dados (Status das Visitas e Usuários) A seguir, encontra-se a definição de alguns termos que aparecem nos relatórios do Looker Studio: | Campo | Termo no Looker Studio | Significado | |--------------------------|------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------| | Status da Visita | completed | Visitas que estão com o Status de Completa. | | | lost | Visitas que estão com o Status de Perdida. | | | ongoing | Visitas que estão com o Status de Incompleta. | | | pending | Visitas que estão com o Status de Pendente. | | | refused | Visitas que estão com o Status de Recusada. | | | cancelled | Visitas que estão com o Status de Cancelada. | | A Visita foi Reagendada? | false | Falso. Significa que a Visita foi reagendada. | | | true | Verdadeiro. Significa que a Visita foi reagendada. | | Tipo de Usuário | admin | O Usuário tem a Hierarquia de Administrador. | | | supervisor | O Usuário tem a Hierarquia de Supervisor. | | | default | O Usuário tem a Hierarquia Padrão. | | Cor da Categoria do Local| código iniciado com # | Padrão de cores HEX. | | Status do Usuário | 1 | O Usuário está como Habilitado. | | | 0 | O Usuário está como Desabilitado. | | Status do Local | positioned | O Status do Local está como Posicionado. | | | not_positioned | O Status do Local está como Não Geoposicionado. | | | valid | O Status do Local está como Validado. | | | repositioned | O Status do Local está como Reposicionado. | Limites da Conexão - Apenas uma conta do Contele Gestor de Equipes pode ser conectada a uma conta do Google. Para conectar dados de mais de uma empresa, são necessárias outras contas do Google. - Máximo de 20 colunas por relatório. - Máximo de 200 mil registros (visitas) por relatório. Aprenda mais sobre o Looker Studio - Central de Ajuda do Looker Studio - Curso Completo de Looker Studio - Canal Web Designer em Foco - Live - Criar um DASHBOARD no LOOKER STUDIO para Equipes Externas DO ZERO - Treinamento do Contele Gestor de Equipes - Como ter suporte a dúvidas no Contele Gestor de Equipes Dúvidas Frequentes 7.1. Eu consigo conectar diversas contas do Contele Gestor de Equipes no Looker Studio? Não, apenas uma conta do Contele Gestor de Equipes pode ser conectada por conta do Google. Para conectar dados de mais de uma empresa, são necessárias outras contas do Google. 7.2. Quais são os dados que consigo conectar ao Looker Studio? Atualmente, apenas dados relacionados a Visitas estão disponíveis no Looker Studio. Nossa equipe está trabalhando para incluir mais dados. 7.3. Como eu posso compartilhar a visualização e edição do Dashboard com outras pessoas? É possível compartilhar relatórios enviando um e-mail, um link com convite de acesso ao Looker Studio ou incorporando no site ou aplicativo. Clique no botão "Compartilhar" no topo do dashboard, escolha o método desejado e defina o tipo de acesso. Saiba mais. 7.4. É possível visualizar Visitas futuras no Looker Studio? Sim, a funcionalidade aplica-se somente a Visitas agendadas, pois recorrências ainda não são consideradas Visitas. Saiba mais sobre Visitas Recorrentes. 7.5. É possível visualizar as Etiquetas das Visitas no Looker Studio? Atualmente, não é possível. Estamos desenvolvendo uma solução para isso e informaremos quando estiver disponível. Veja também - Termos de Uso - Política de Privacidade

Última atualização em Jan 27, 2025