Aparência
Conectores com CRMs e ERPs
Em uma frase ​
Um conector busca, de tempos em tempos, os registros do seu sistema (HubSpot, Ploomes, Sankhya, Meetime ou qualquer outro com API) e os guarda numa tabela do Trevo, que você usa no plano de remuneração, nas metas e no cadastro de pessoas remuneradas.
Como funciona ​
Cada vez que o conector roda, ele faz uma execução: lê os registros no seu sistema e atualiza a tabela do conector, que guarda uma linha por registro. O plano de remuneração é o conjunto de regras que calcula quanto cada pessoa remunerada ganha, e ele lê essa tabela.
Nos conectores nativos (HubSpot, Ploomes, Sankhya e Meetime), você escolhe a entidade (por exemplo, "Negócios" ou "Leads") e poucas opções, e o Trevo monta o resto. No conector genérico, você descreve a requisição à mão, para qualquer sistema com API.
Conectores disponíveis ​
- HubSpot: propriedades padrão e extras e o limite de data.
- Ploomes: seleção de campos, Metas e o modo "uma linha por produto".
- Meetime: sincronização incremental em Leads e as datas de cada entidade.
- Sankhya: consultas customizadas, condição livre com variáveis de data, Funcionários e Sankhya Marketplace.
- Conector genérico (API própria): requisição, autenticação, expansão de itens e coluna de exclusão.
Versões e o que não muda depois de criado ​
Toda mudança que você salva vira uma versão nova do conector, e a última é a que vale. Salvar sem mudar nada não cria versão. O nome do conector não pode se repetir.
Algumas escolhas definem o que é cada linha da tabela e ficam fixas depois de criar o conector, como a entidade dos nativos. Cada tipo de conector tem as suas, descritas na página dele. Para mudar uma delas, crie outro conector. Por isso, revise essas escolhas antes de salvar pela primeira vez.
Sincronização incremental e carga completa ​
Na carga completa, cada execução lê tudo do seu sistema. Na sincronização incremental, cada execução lê só o que mudou desde a anterior. A incremental só existe quando o sistema avisa que um registro foi excluído: entre os nativos, isso acontece apenas em Leads da Meetime. HubSpot, Ploomes e Sankhya funcionam sempre por carga completa.
Se você acrescenta campos a um conector incremental, a próxima execução relê tudo, para o campo novo chegar preenchido também nos registros antigos. Essa execução demora mais. Você também pode reiniciar a marca d'água (a data até onde o conector já leu) para forçar uma releitura completa.
Autenticações salvas ​
Uma credencial salva pode servir a vários conectores e automações do mesmo tipo. Ao escolher uma, você vê quantos outros conectores ou automações a usam. Na edição, deixe o segredo em branco para manter o atual. Para trocar o tipo de credencial, digite o segredo de novo.
Se você remove uma autenticação salva, os conectores que a usam param de rodar: o selo mostra "Sem autenticação" e o botão "Executar agora" fica desabilitado. Escolha outra autenticação e salve para o conector voltar a ser agendado.
Agendar ​
Escolha uma de três frequências: "a cada hora" (no minuto 0), "diariamente" (às 6h) ou "semanalmente" (segunda, às 6h). O horário é UTC: 6h equivale a 3h no horário de Brasília. Sem agendamento, o conector só roda quando você dispara.
Se o conector ficou um tempo sem rodar, ele roda uma vez assim que possível e volta ao ritmo normal. Quando você clica em "Executar agora", o próximo horário agendado passa a contar a partir desse momento.
Executar agora e testar ​
O conector roda uma execução por vez. Se outra está em andamento, um novo disparo é recusado com "já em execução". Depois de "Executar agora", a tela acompanha o status por até 3 minutos; para execuções mais longas, recarregue a página.
O teste do conector lê só a primeira página e não grava nada. Ele mostra quantos registros vieram, um registro de exemplo e o tempo gasto, ou o motivo da falha. Use-o para conferir a configuração antes da primeira execução. O teste tem 30 segundos para responder.
Entender o status de uma execução ​
| Selo | Quer dizer |
|---|---|
| Nunca executado | O conector ainda não rodou |
| Processando | A execução está em andamento |
| Pronto | A última execução terminou; o dado está disponível |
| Falhou | A última execução falhou |
| Sem autenticação | A autenticação salva usada pelo conector foi removida |
Linhas, colunas e "última sincronização" mostram a última execução que terminou. Uma falha não apaga o dado que você já tinha. Se aparecer uma mensagem de agendamento parado, o conector não vai rodar sozinho até você editá-lo e salvar, mesmo com o selo "Pronto".
Quando falha, a execução mostra um motivo:
| Motivo | O que fazer |
|---|---|
| falha de autenticação | Confira a credencial no seu sistema e atualize no Trevo |
| limite de requisições ou indisponível | Num conector agendado, nada: o Trevo tenta de novo em poucos minutos |
| requisição recusada | Revise o caminho e os parâmetros |
| resposta inválida ou configuração inválida | Revise a configuração e rode o teste |
| erro da origem | Veja a mensagem devolvida pela Sankhya |
O que fica na tabela ​
A tabela guarda uma linha por registro. Quando o mesmo registro chega de novo, vale a leitura mais recente. Um registro excluído no seu sistema continua na tabela, com a data de exclusão preenchida. Na carga completa, um registro que deixou de vir é tratado como excluído. Se ele voltar, volta a valer.
Uma execução para em 1.000 páginas, 1.000.000 de registros ou 1 hora, e termina como concluída com o que trouxe.
Campos aninhados viram colunas separadas por _, como a_b_0_c. Só número de verdade vira coluna numérica: um valor que seu sistema manda como texto ("1500.00") chega como texto. Se uma coluna numérica receber um valor com letra, ela inteira passa a ser texto e não volta. Com seleção de campos, só as colunas escolhidas ficam, e uma coluna que sai da seleção é retirada da tabela.
Exemplo completo ​
Você liga um conector Meetime de Leads, com sincronização incremental e frequência "diariamente" (3h no horário de Brasília).
| Dia | O que acontece | Linhas na tabela | Selo |
|---|---|---|---|
| Segunda | Primeira execução lê todos os 12.000 leads | 12.000 | Pronto |
| Terça | 25 leads novos e 15 alterados; 3 excluídos ganham data de exclusão | 12.025 | Pronto |
| Quarta | Nada mudou | 12.025 | Pronto |
| Quinta, 3h | A Meetime está fora do ar | 12.025 | Falhou |
| Quinta, 3h01 | Nova tentativa automática dá certo; traz 10 leads novos | 12.035 | Pronto |
Na quinta à tarde, você acrescenta um campo personalizado. A execução de sexta relê os 12.035 leads para preencher o campo novo em todos.
Perguntas frequentes ​
A última execução falhou. Perdi os dados? Não. A tabela continua com o dado da última execução que terminou.
Posso trocar a entidade de um conector? Não. Crie outro conector com a entidade nova.
Escolhi "diariamente" e o conector roda às 3h. Por quê? O horário é UTC: 6h UTC são 3h em Brasília.
Um registro excluído no meu CRM continua na tabela. Está certo? Sim. Ele fica com a data de exclusão preenchida, para você saber quando saiu.