Ploomes

Adicionando a fonte de dados

Adicionando o conector

Baseado na documentação da API do Ploomes

Este conector está em modo beta

Requisitos

Siga as instruções abaixo com um usuário administrador

Instruções

1) Acesse o site e faça login em sua conta Ploomes e, no painel lateral direito acesse Administração

2) Em integrações, selecione "Usuários de integração"

3) No modal, selecione “Novo usuário”

4) Preencha nome o “Kondado”, utilize um e-mail válido da sua empresa e perfil Administrador > Criar usuário

5) Confirme a criação

6) Voltando ao modal de listagem de usuários, selecione o usuário Kondado recém criado

7) Copie a o valor exibido na caixa de“Chave da API”

8) Faça login na plataforma da Kondado, clique para criar um novo conector Ploomes e cole em "Chave da API" o valor obtido no passo 7

Agora basta clicar em SALVAR e criar suas integrações para começar a receber dados do Ploomes no seu Data Warehouse, Data Lake ou planilha

Pipelines

Resumo

Cargos
Cidades
Cidades: estados
Cidades: países
Clientes (empresas e pessoas)
Clientes: classificações
Clientes: origens
Clientes: relações
Clientes: segmentos
Clientes: status
Clientes: tipos
Departamentos
Documentos
Moedas
Negócios
Negócios: estágios
Negócios: funis
Negócios: motivos de perda
Negócios: status
Produtos
Produtos: grupos
Produtos: grupos: famílias
Propostas
Propostas: produtos
Propostas: status de aprovação
Registros de interação
Tarefas
Tarefas: intervalos de repetição
Tarefas: tipos
Tarefas: tipos de lembrete de email
Usuários
Usuários: motivos de suspensão
Usuários: perfis
Vendas
Vendas: estágios
Vendas: produtos

Diagrama de relacionamento

Clique para expandir

Cargos

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os cargos cadastrados no CRM. Cada linha é um cargo, com seu nome, usado para indicar a função de clientes e usuários.

Campo	Tipo
id	text	[pt] Id do cargo.
name	text	[pt] Nome do cargo.

Cidades

Tipo de replicacao: Integral

Relacionamentos:

countryid → Cidades: países > id
stateid → Cidades: estados > id

Tabela de apoio com as cidades cadastradas no CRM. Cada linha é uma cidade, com nome, código IBGE, coordenadas geográficas e vínculos com o estado e o país, usada para qualificar endereços de clientes e demais registros.

Campo	Tipo
id	text	[pt] Id da cidade, gerado automaticamente pelo Banco de dados.
name	text	[pt] Nome da cidade.
countryid	text	[pt] Id do país da cidade Cidades: países > > id
stateid	text	[pt] Id do estado da cidade Cidades: estados > > id
ibgecode	int	[pt] Código do IBGE da cidade.
latitude	text	[pt] Latitude da cidade.
longitude	text	[pt] Longitude da cidade.

Cidades: estados

Tipo de replicacao: Integral

Relacionamentos:

countryid → Cidades: países > id

Tabela de apoio com os estados (unidades federativas) cadastrados no CRM. Cada linha é um estado, com nome, sigla e vínculo com o país, usado para qualificar a localização de cidades e endereços.

Campo	Tipo
id	text	[pt] Id do estado, gerado automaticamente pelo Banco de dados.
short	text	[pt] Sigla do estado.
name	text	[pt] Nome do estado.
countryid	text	[pt] Id do país desse estado Cidades: países > > id

Cidades: países

Tipo de replicacao: Integral

Tabela de apoio com os países cadastrados no CRM. Cada linha é um país, com seu nome e siglas, usado para qualificar a localização de cidades, clientes e demais registros.

Campo	Tipo
id	text	[pt] Id do país, gerado automaticamente pelo Banco de dados.
short	text	[pt] Código Alpha-3. Representa a sigla do país, com 3 letras.
short2	text	[pt] Código Alpha-2. Representa a sigla do país, com 2 letras.
name	text	[pt] Nome do País.

Clientes (empresas e pessoas)

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

typeid → Clientes: tipos > id
classid → Clientes: classificações > id
statusid → Clientes: status > id
companyid → Clientes (empresas e pessoas) > id
relationshipid → Clientes: relações > id
lineofbusinessid → Clientes: segmentos > id
originid → Clientes: origens > id
ownerid → Usuários > id
roleid → Cargos > id
departmentid → Departamentos > id
cityid → Cidades > id
currencyid → Moedas > id

Cadastro de clientes (pessoas e empresas) do CRM. Cada linha é um contato, com nome, razão social, CPF/CNPJ, dados de contato (e-mail, site, telefone, redes sociais), endereço completo e vínculos como tipo, classe, status, origem, segmento, responsável e empresa associada.

Campo	Tipo
id	text	[pt] Id do cliente, gerado automaticamente pelo Banco de dados.
typeid	text	[pt] Id do tipo do cliente, podendo ser um cliente do tipo pessoa ou do tipo empresa. Clientes: tipos > > id
classid	text	[pt] Id da classe do cliente. Clientes: classificações > > id
name	text	[pt] Nome do cliente.
legalname	text	[pt] Razão social do cliente.
register	text	[pt] CNPJ ou CPF do cliente, a escolha do tipo do campo é de acordo com o tipo do cliente.
statusid	text	[pt] Id do status do cliente. Se não estiver preenchido, assume um valor padrão Clientes: status > > id
companyid	text	[pt] Id da empresa do cliente (Se aplica para clientes do tipo pessoa). Clientes (empresas e pessoas) > > id
relationshipid	text	[pt] Id da relação do cliente Clientes: relações > > id
lineofbusinessid	text	[pt] Id do segmento do cliente Clientes: segmentos > > id
originid	text	[pt] Id da origem do cliente Clientes: origens > > id
ownerid	text	[pt] Id do usuário responsável do cliente. Usuários > > id
note	text	[pt] Observações sobre o cliente.
email	text	[pt] Email do cliente.
website	text	[pt] Site do cliente.
roleid	text	[pt] Id do cargo do cliente Cargos > > id
departmentid	text	[pt] Id do departamento do cliente Departamentos > > id
skype	text	[pt] Skype do cliente.
facebook	text	[pt] Facebook do cliente.
streetaddress	text	[pt] Endereço do cliente.
streetaddressnumber	text	[pt] Número do endereço do cliente.
streetaddressline2	text	[pt] Complemento do endereço do cliente.
neighborhood	text	[pt] Bairro do cliente.
zipcode	int	[pt] CEP do cliente.
foreignzipcode	text	[pt] Código postal internacional do cliente.
cityid	text	[pt] Id da cidade do cliente Cidades > > id
currencyid	text	[pt] Id da moeda do cliente Moedas > > id
emailmarketing	boolean	[pt] Boleano sobre o recebimento de email marketing.
cnaecode	text	[pt] Código CNAE do cliente.
cnaename	text	[pt] Descrição do CNAE do cliente.
latitude	float	[pt] Latitude do cliente.
longitude	float	[pt] Longitude do cliente.
key	text	[pt] Chave externa do cliente.
avatarurl	text	[pt] URL do avatar do cliente (Ícone).
identitydocument	text	[pt] Documento de identidade internacional do cliente.
last_update_date	timestamp

Clientes: classificações

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com as classes de clientes cadastradas no CRM (por exemplo, cliente, fornecedor ou parceiro). Cada linha é uma classe, com seu nome, usada para categorizar os contatos.

Campo	Tipo
id	text	[pt] Id da relação, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome da relação.

Clientes: origens

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com as origens de clientes cadastradas no CRM (por exemplo, indicação, site ou evento). Cada linha é uma origem, com seu nome, usada para registrar de onde veio cada contato.

Campo	Tipo
id	text	[pt] Id da origem, gerado automaticamente pelo banco de dados.
name	text	[pt] Nome da origem.

Clientes: relações

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os tipos de relacionamento de clientes cadastrados no CRM. Cada linha é um tipo de relacionamento, com seu nome, usado para descrever o vínculo do contato com a empresa.

Campo	Tipo
id	text	[pt] Id da relação, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome da relação.

Clientes: segmentos

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os segmentos (ramos de atuação) cadastrados no CRM. Cada linha é um segmento, com seu nome, usado para classificar os clientes pelo seu ramo de negócio.

Campo	Tipo
id	text	[pt] Id do Segmento , gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do Segmento.

Clientes: status

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os status de clientes cadastrados no CRM (por exemplo, ativo ou inativo). Cada linha é um status, com seu nome, usado para indicar a situação atual de cada contato.

Campo	Tipo
id	text	[pt] Id do status do cliente, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do status do cliente.

Clientes: tipos

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os tipos de clientes cadastrados no CRM, distinguindo contatos do tipo pessoa e do tipo empresa. Cada linha é um tipo, com seu nome.

Campo	Tipo
id	text	[pt] Id do tipo de cliente.
name	text	[pt] Nome do tipo de cliente.

Departamentos

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os departamentos cadastrados no CRM. Cada linha é um departamento, com seu nome, usado para vincular clientes e organizar a estrutura interna.

Campo	Tipo
id	text	[pt] Id do departamento, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do departamento.

Documentos

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

contactid → Clientes (empresas e pessoas) > id
personid → Clientes (empresas e pessoas) > id
dealid → Negócios > id
ownerid → Usuários > id
originquoteid → Propostas > id
currencyid → Moedas > id

Documentos gerados no CRM. Cada linha é um documento, com número, data, modelo utilizado, cliente e pessoa associados, negócio vinculado, responsável, moeda, status de aprovação, dados de compartilhamento externo e arquivo gerado.

Campo	Tipo
id	text	[pt] Id do documento, gerado automaticamente pelo Bando de Dados.
name	text	[pt] Nome do documento.
documentnumber	int	[pt] Número do documento.
date	timestamp	[pt] Data do documento, prenchida automaticamente com a data atual se nenhum valor for infomado.
templateid	text	[pt] Id do modelo do documento
contactid	text	[pt] Id do cliente do documento Clientes (empresas e pessoas) > > id
personid	text	[pt] Id da pessoa do documento Clientes (empresas e pessoas) > > id
dealid	text	[pt] Id do negócio do documento Negócios > > id
ownerid	text	[pt] Id do responsável do documento Usuários > > id
key	text	[pt] Chave do documento.
shared	boolean	[pt] Indica se o documento foi compartilhado.
externallyaccepted	boolean	[pt] Indica se o documento foi aceito externamente.
externalnotifications	boolean	[pt] Indica o recebimento de notificações externas.
externalsharingdate	timestamp	[pt] Data de compartilhamento do documento.
documenturl	text	[pt] URL do documento (Quando compartilhado externamente).
approvalstatusid	text	[pt] Id do status da aprovação do documento.
approvallevelid	text	[pt] Indica o nível de aprovação do documento.
originquoteid	text	[pt] Id da proposta origem do documento. Propostas > > id
currencyid	text	[pt] Id da moeda do documento Moedas > > id
filename	text	[pt] Nome do arquivo do documento.
last_update_date	timestamp

Moedas

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com as moedas cadastradas no CRM. Cada linha é uma moeda, com seu código e símbolo, usada para definir a moeda de clientes, negócios, orçamentos e pedidos.

Campo	Tipo
id	text	[pt] Id da moeda, gerado automaticamente pelo Banco de dados.
symbol	text	[pt] Símbolo da moeda.
code	text	[pt] Código da moeda.

Negócios

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

contactid → Clientes (empresas e pessoas) > id
personid → Clientes (empresas e pessoas) > id
statusid → Negócios: status > id
pipelineid → Negócios: funis > id
stageid → Negócios: estágios > id
laststageid → Negócios: estágios > id
lossreasonid → Negócios: motivos de perda > id
ownerid → Usuários > id
currencyid → Moedas > id

Negócios (oportunidades de venda) do CRM. Cada linha é um negócio com título, valor, moeda, cliente e pessoa associados, responsável, origem, funil, estágio atual e último estágio, status, motivo de perda e eventual negócio de origem.

Campo	Tipo
id	text	[pt] Id do negócio, gerado automaticamente pelo Banco de Dados.
title	text	[pt] Título do negócio.
contactid	text	[pt] Id do cliente do negócio. Se o negócio não possuir nenhum cliente, o cliente Fantasma da conta será adicionado (É um id de cliente que todas as contas possuem para representar um cliente vazio) Clientes (empresas e pessoas) > > id
personid	text	[pt] Id da pessoa do negócio Clientes (empresas e pessoas) > > id
statusid	text	[pt] Id do status do negócio Negócios: status > > id
pipelineid	text	[pt] Id do funil do negócio Negócios: funis > > id
stageid	text	[pt] Id do estágio do negócio. Se o estágio não for informado, esse campo será preenchido com o primeiro estágio de um funil não arquivado. Negócios: estágios > > id
laststageid	text	[pt] Id do último estágio do negócio. Negócios: estágios > > id
lossreasonid	text	[pt] Id do motivo de perda do negócio. Negócios: motivos de perda > > id
originid	text	[pt] Id da origem do negócio.
ownerid	text	[pt] Id do responsável do negócio. Usuários > > id
currencyid	text	[pt] Id da moeda do negócio. Será inserido nesse campo a moeda do cliente ou a moeda padrão da conta. Moedas > > id
amount	float	[pt] Valor do negócio. Esse campo tem um valor padrão de 0.
origindealid	text	[pt] Id do negócio origem desse negócio. Esse campo estará preenchido se esse negócio for um negócio derivado de outro.
dealnumber	int	[pt] Número do negócio.
contactproductid	text	[pt] Id do produto de cliente do negócio.
last_update_date	timestamp

Negócios: estágios

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

pipelineid → Negócios: funis > id

Tabela de apoio com os estágios dos funis de negócios cadastrados no CRM. Cada linha é um estágio, com seu nome, ordem dentro do funil e o funil ao qual pertence.

Campo	Tipo
id	text	[pt] Id da estágio do negócio, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do estágio do negócio.
pipelineid	text	[pt] Funil do estágio do negócio. Essa informação pode ser consultada no endpoint '/Deals@Pipelines'. Negócios: funis > > id
ordination	int	[pt] Ordenação do estágio do negócio. Esse é o número que define a ordem entre os estágios dentro de um funil, indo do menor para o maior. Não é possível inserir estágios com ordenação igual dentro do mesmo funil.

Negócios: funis

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os funis de negócios cadastrados no CRM. Cada linha é um funil, com seu nome, regras de avanço entre estágios, permissões para gerar orçamentos, pedidos e documentos, nomenclatura das unidades e configurações de visualização.

Campo	Tipo
id	text	[pt] Id do Funil de negócio, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do funil de negócio.
mustpassallstages	boolean	[pt] Boleano que indica se a passagem por todos os estágios é obrigatória neste funil. Assume o valor de falso se não for informado.
forbiddenstagereturn	boolean	[pt] Boleano que indica se é proibido voltar de etapa neste funil. Assume o valor de falso se não for informado.
maycreatequotes	boolean	[pt] Boleano que indica se pode gerar propostas neste funil. Assume o valor de falso se não for informado.
maycreateorders	boolean	[pt] Boleano que indica se pode gerar vendas neste funil. Assume o valor de falso se não for informado.
maycreatedocuments	boolean	[pt] Boleano que indica se pode gerar documentos neste funil. Assume o valor de falso se não for informado.
maywindeals	boolean	[pt] Boleano que indica se pode ganhar negócios neste funil. Assume o valor de falso se não for informado.
maylosedeals	boolean	[pt] Boleano que indica se pode perder propostas neste funil. Assume o valor de falso se não for informado.
formid	text	[pt] Id do formulário do funil de negócio.
quickformid	text	[pt] Id do formulário mini do funil de negócio.
archived	boolean	[pt] Indica de o formulário está arquivado. Assume o valor de falso inicialmente.
neworderonwondeal	boolean	[pt] Boleano que indica se deve gerar uma nova venda ao ganhar um negócio neste funil (Abrindo a janela de criação de uma nova venda). Assume o valor de falso se não for informado.
createorderonwondeal	boolean	[pt] Boleano que indica se deve gerar uma nova venda automaticamente ao ganhar um negócio neste funil. Assume o valor de falso se não for informado.
windealonlaststage	boolean	[pt] Boleano que indica se é possível ganhar um negócio apenas na última etapa neste funil. Assume o valor de falso se não for informado.
singularunitname	text	[pt] Nome da unidade no singular desse funil.
pluralunitname	text	[pt] Nome da unidade no plural desse funil.
genderid	text	[pt] Gênero da unidade desse funil.
enabletableviewmode	boolean	[pt] Boleano que indica se a visualização de tabela está disponível.
enablefunnelviewmode	boolean	[pt] Boleano que indica se a visualização de Funil/Kanban está disponível.
ordination	int	[pt] Ordenação do funil.
quotesuseerpformat	boolean	[pt] Boleano que indica se deve usar formato de tela cheia para criação/edição de propostas neste funil.
ordersuseerpformat	boolean	[pt] Boleano que indica se deve usar formato de tela cheia para criação/edição de vendas neste funil.
documentsuseerpformat	boolean	[pt] Boleano que indica se deve usar formato de tela cheia para criação/edição de documentos neste funil.

Negócios: motivos de perda

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os motivos de perda de negócios cadastrados no CRM. Cada linha é um motivo, com seu nome e o funil ao qual pertence, usado para justificar por que um negócio foi perdido.

Campo	Tipo
id	text	[pt] Id do motivo de perda, gerado automaticamente pelo Banco de dados.
name	text	[pt] Nome do motivo de perda.
pipelineid	text	[pt] Id do funil do motivo de perda.

Negócios: status

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os status de negócios cadastrados no CRM (por exemplo, em aberto, ganho ou perdido). Cada linha é um status, com seu nome.

Campo	Tipo
id	text	[pt] Id do status do negócio.
name	text	[pt] Nome do status do negócio.

Produtos

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

groupid → Produtos: grupos > id
currencyid → Moedas > id

Catálogo de produtos do CRM. Cada linha é um produto, com nome, código, unidade de medida, preço unitário, moeda, imagem e o grupo ao qual pertence.

Campo	Tipo
id	text	[pt] Id do produto, gerado automaticamente pelo Banco de Dados.
groupid	text	[pt] Id do grupo do produto. Produtos: grupos > > id
name	text	[pt] Nome do produto.
code	text	[pt] Código do produto.
measurementunit	text	[pt] Unidade de medida do produto.
imageurl	text	[pt] Imagem do produto.
currencyid	text	[pt] Id da moeda do produto. Essa informação pode ser consultada no endpoint de '/Currencies'. Moedas > > id
unitprice	float	[pt] Unit value of the product.
last_update_date	timestamp

Produtos: grupos

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

familyid → Produtos: grupos: famílias > id

Tabela de apoio com os grupos de produtos cadastrados no CRM. Cada linha é um grupo, com seu nome, a família a que pertence, indicação de preço fixo e se é o grupo padrão, usado para categorizar os produtos.

Campo	Tipo
id	text	[pt] Id do grupo de produto, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do grupo de produto.
familyid	text	[pt] Id da família do grupo de produto Produtos: grupos: famílias > > id
fixedprice	boolean	[pt] Indica se o preço é fixado nesse grupo de produto.
default	boolean	[pt] Indica se esse grupo de produto é padrão.

Produtos: grupos: famílias

Tipo de replicacao: Integral

Tabela de apoio com as famílias de produtos cadastradas no CRM. Cada linha é uma família, com seu nome, usada como nível mais alto de categorização dos produtos.

Campo	Tipo
id	text	[pt] Id da família de produto, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome da família de produto.

Propostas

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

dealid → Negócios > id
approvalstatusid → Propostas: status de aprovação > id

Orçamentos (propostas) do CRM. Cada linha é um orçamento, com seu número, o negócio vinculado, o modelo utilizado, o status de aprovação, a última revisão e os dados de compartilhamento externo.

Campo	Tipo
id	text	[pt] Id da proposta, gerado automaticamente pelo Banco de Dados.
dealid	text	[pt] Id do negócio da proposta. Negócios > > id
templateid	text	[pt] Id do modelo da proposta
approvalstatusid	text	[pt] Id do status de aprovação da proposta Propostas: status de aprovação > > id
quotenumber	int	[pt] Número da proposta.
shared	boolean	[pt] Indica se a proposta foi compartilhado.
externalnotifications	boolean	[pt] Indica o recebimento de notificações externas.
externalsharingdate	timestamp	[pt] Data de compartilhamento da proposta.
lastreviewid	text	[pt] Id da última revisão.
last_update_date	timestamp

Propostas: produtos

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

quoteid → Propostas > id
productid → Produtos > id
dealid → Negócios > id
ownerid → Usuários > id
contactid → Clientes (empresas e pessoas) > id

Itens de produtos dos orçamentos do CRM. Cada linha é um produto incluso em um orçamento, detalhando quantidade, preço unitário, desconto, total e bônus, além dos vínculos com o orçamento, o produto, o negócio, o cliente e o responsável.

Campo	Tipo
quoteid	text	[pt] Id da proposta Propostas > > id
id	text	[pt] Id do registro proposta/produto
productid	text	[pt] Id produto Produtos > > id
dealid	text	[pt] Id do negócio da proposta. Negócios > > id
ownerid	text	[pt] Id do usuário responsável pelo orçamento. Usuários > > id
contactid	text	[pt] Id do contato associado ao orçamento. Clientes (empresas e pessoas) > > id
quantity	float	[pt] Quantidade do produto no item.
unityprice	float	[pt] Preço unitário do produto.
discount	float	[pt] Desconto aplicado ao item.
total	float	[pt] Valor total do item.
bonus	float	[pt] Bônus do item.

Propostas: status de aprovação

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os status de aprovação de orçamentos cadastrados no CRM (por exemplo, pendente, aprovado ou reprovado). Cada linha é um status, com seu nome.

Campo	Tipo
id	text	[pt] Id do status de aprovação da proposta.
name	text	[pt] Nome do status de aprovação da proposta.

Registros de interação

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

contactid → Clientes (empresas e pessoas) > id
dealid → Negócios > id
typeid → Tarefas: tipos > id

Registros de interação (histórico de atividades) com clientes e negócios no CRM. Cada linha é uma interação, com data, tipo, título e conteúdo, cliente e negócio relacionados, localização e, quando é um e-mail, destinatários e assunto.

Campo	Tipo
id	text	[pt] Id do registro de interação, gerado automaticamente pelo Banco de Dados.
contactid	text	[pt] Id do cliente do registro de interação. Se for informado algum Id de negócio, o Id do cliente passa a ser o mesmo do cliente desse negócio. Caso contrário, o id do cliente deve ser válido para a criação do registro se completar Clientes (empresas e pessoas) > > id
dealid	text	[pt] Id do negócio do registro de interação Negócios > > id
date	timestamp	[pt] Data do registro de interação. Se estiver vazia, recebe a data atual da criação.
typeid	text	[pt] Id do tipo de registro de interação Tarefas: tipos > > id
title	text	[pt] Título do registro de interação.
content	text	[pt] Conteúdo do registro de interação.
latitude	float	[pt] Latitude do registro de interação (Se fizer sentido para o tipo dele).
longitude	float	[pt] Longitude do registro de interação (Se fizer sentido para o tipo dele).
emailrecipients	text	[pt] Destinatários do email do registro de interação (Se fizer sentido para o tipo dele).
emailsubject	text	[pt] Assunto do email do registro de interação (Se fizer sentido para o tipo dele).
last_update_date	timestamp

Tarefas

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

typeid → Tarefas: tipos > id
contactid → Clientes (empresas e pessoas) > id
dealid → Negócios > id
repeatintervalunitid → Tarefas: intervalos de repetição > id
emailreminderid → Tarefas: tipos de lembrete de email > id

Tarefas (compromissos e atividades) do CRM. Cada linha é uma tarefa, com título, descrição, tipo, duração, configuração de repetição e lembrete por e-mail, além dos vínculos com o cliente e o negócio relacionados.

Campo	Tipo
id	text	[pt] Id da tarefa, gerada automaticamente pelo Banco de Dados.
title	text	[pt] Título da tarefa.
description	text	[pt] Descrição da tarefa.
typeid	text	[pt] Id do tipo de tarefa Tarefas: tipos > > id
contactid	text	[pt] Id do contato da tarefa Clientes (empresas e pessoas) > > id
dealid	text	[pt] Id do negócio da tarefa. Negócios > > id
lenght	int	[pt] Duração da tarefa.
repeatintervallength	int	[pt] Duração do intervalo de repetição da tarefa.
repeatintervalunitid	text	[pt] Id do intervalo de repetição da Task Tarefas: intervalos de repetição > > id
emailreminderid	text	[pt] Id do lembrete por email Tarefas: tipos de lembrete de email > > id
last_update_date	timestamp

Tarefas: intervalos de repetição

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com as unidades de intervalo de repetição de tarefas cadastradas no CRM (por exemplo, dias, semanas ou meses). Cada linha é uma unidade, com seu nome e a configuração de período correspondente.

Campo	Tipo
id	text	[pt] Id do intervalo de repetição.
name	text	[pt] Nome do intervalo de repetição.
datepart	text	[pt] Parte da data.
datepartlength	int	[pt] Tamanho da parte da data.

Tarefas: tipos

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os tipos de tarefas cadastrados no CRM (por exemplo, ligação, reunião ou e-mail). Cada linha é um tipo, com seu nome, ícone e cor.

Campo	Tipo
id	text	[pt] Id do tipo de tarefa.
name	text	[pt] Nome do tipo de tarefa.
icon	text	[pt] Ícone do tipo de tarefa.
color	text	[pt] Cor do tipo de tarefa.

Tarefas: tipos de lembrete de email

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com as opções de lembrete por e-mail de tarefas cadastradas no CRM (por exemplo, avisar 30 minutos antes). Cada linha é uma opção de lembrete, com seu nome.

Campo	Tipo
id	text	[pt] Id do lembrete de email.
name	text	[pt] Nome do lembrete de email.

Usuários

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

roleid → Cargos > id
profileid → Usuários: perfis > id
suspensionreasonid → Usuários: motivos de suspensão > id

Usuários do CRM. Cada linha é um usuário, com nome, e-mail, telefone, idioma, redes sociais, avatar, cargo e perfil de acesso, além do motivo de suspensão e indicadores de integração e cortesia.

Campo	Tipo
id	text	[pt] Id do usuário, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do usuário.
email	text	[pt] Email do usuário.
roleid	text	[pt] Id do cargo do usuário Cargos > > id
profileid	text	[pt] Id do perfil do usuário Usuários: perfis > > id
avatarurl	text	[pt] Url do avatar do usuário (Foto).
phone	text	[pt] Telefone do usuário.
language	text	[pt] Língua do usuário.
facebook	text	[pt] Facebook do usuário.
linkedin	text	[pt] LinkedIn do usuário.
suspensionreasonid	text	[pt] Id do motivo de suspensão do usuário. Usuários: motivos de suspensão > > id
suspensionreasoncomments	text	[pt] Comentário sobre a suspensão do usuário.
integration	boolean	[pt] Boleano que indica se é um usuário de integração (UserKey fixa).
nativeintegration	boolean	[pt] Boleano que indica se é um usuário de integração nativa (Utilizado pelas integrações Plug-In-Play).
courtesy	boolean	[pt] Boleano que indica se é um usuário cortesia (Não conta no pagamento). Usuários que não são de integração terão o valor de falso.
last_update_date	timestamp

Usuários: motivos de suspensão

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os motivos de suspensão de usuários cadastrados no CRM. Cada linha é um motivo, com seu nome, usado para justificar a inativação de um usuário.

Campo	Tipo
id	text	[pt] Id do motivo de suspensão.
name	text	[pt] Nome do motivo de suspensão.

Usuários: perfis

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os perfis de usuário cadastrados no CRM, que definem o nível de acesso e permissões. Cada linha é um perfil, com seu nome.

Campo	Tipo
id	text	[pt] Id do perfil de usuário, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do perfil de usuário.

Vendas

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

contactid → Clientes (empresas e pessoas) > id
personid → Clientes (empresas e pessoas) > id
stageid → Vendas: estágios > id
dealid → Negócios > id
ownerid → Usuários > id
currencyid → Moedas > id
originquoteid → Propostas > id

Pedidos de venda do CRM. Cada linha é um pedido, com número, data, valor, desconto, moeda, cliente e pessoa associados, negócio vinculado, estágio, responsável, agente, comentários, status de aprovação e dados de compartilhamento externo.

Campo	Tipo
id	text	[pt] Id da venda, gerado automaticamente pelo Bando de Dados.
ordernumber	int	[pt] Número da venda.
date	timestamp	[pt] Data da venda, prenchida automaticamente com a data atual se nenhum valor for infomado.
contactid	text	[pt] Id do cliente da venda Clientes (empresas e pessoas) > > id
personid	text	[pt] Id da pessoa da venda Clientes (empresas e pessoas) > > id
stageid	text	[pt] Id do estágio da venda. Assume um valor de um estágio padrão se não for informado Vendas: estágios > > id
dealid	text	[pt] Id do negócio da venda. Negócios > > id
ownerid	text	[pt] Id do responsável da venda Usuários > > id
currencyid	text	[pt] Id da moeda da venda. Assume o valor da moeda do cliente ou da conta se não for informado Moedas > > id
amount	float	[pt] Valor da venda.
discount	text	[pt] Disconto da venda.
internalcomments	text	[pt] Comentários internos da venda.
description	text	[pt] Descrição da venda.
key	text	[pt] Chave da venda.
agentid	text	[pt] Id do comissionado da venda.
commission	text	[pt] Comissão da venda.
templateid	text	[pt] Id do modelo da venda
shared	boolean	[pt] Indica se a venda foi compartilhada.
externallyaccepted	boolean	[pt] Indica se a venda foi aceita externamente.
externalnotifications	boolean	[pt] Indica o recebimento de notificações externas.
externalsharingdate	timestamp	[pt] Data de compartilhamento da venda.
documenturl	text	[pt] URL da venda (Quando compartilhada externamente).
approvalstatusid	text	[pt] Indica o status da aprovação da venda
approvallevelid	text	[pt] Indica o nível de aprovação da venda.
originquoteid	text	[pt] Id da proposta origem da venda. Propostas > > id
filename	text	[pt] Nome do arquivo da venda.
last_update_date	timestamp

Vendas: estágios

Esta integracao e gratuita

Tipo de replicacao: Integral

Tabela de apoio com os estágios de pedidos cadastrados no CRM. Cada linha é um estágio, com seu nome, ícone e ordem, usado para acompanhar a situação de cada pedido.

Campo	Tipo
id	text	[pt] Id do estágio da venda, gerado automaticamente pelo Banco de Dados.
name	text	[pt] Nome do estágio da venda.
icon	text	[pt] Ícone do estágio da venda.
ordination	int	[pt] Ordenação do estágio da venda. Esse é o número que define a ordem entre os estágios dentro de um funil, indo do menor para o maior.

Vendas: produtos

Tipo de replicacao: Incremental

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data os registros serão lidos

Relacionamentos:

orderid → Vendas > id
productid → Produtos > id
dealid → Negócios > id
ownerid → Usuários > id
contactid → Clientes (empresas e pessoas) > id

Itens de produtos dos pedidos do CRM. Cada linha é um produto incluso em um pedido, detalhando quantidade, preço unitário, desconto, total e bônus, além dos vínculos com o pedido, o produto, o negócio, o cliente e o responsável.

Campo	Tipo
orderid	text	[pt] Id da venda Vendas > > id
id	text	[pt] Id do registro venda/produto
productid	text	[pt] Id produto Produtos > > id
dealid	text	[pt] Id do negócio da venda. Negócios > > id
ownerid	text	[pt] Id do usuário responsável pelo pedido. Usuários > > id
contactid	text	[pt] Id do contato associado ao pedido. Clientes (empresas e pessoas) > > id
quantity	float	[pt] Quantidade do produto no item.
unityprice	float	[pt] Preço unitário do produto.
discount	float	[pt] Desconto aplicado ao item.
total	float	[pt] Valor total do item.
bonus	float	[pt] Bônus do item.

Notas

Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Configurar o conector Ploomes na Kondado

Siga este passo a passo para criar um usuário de integração no Ploomes, obter a chave da API e configurar o conector na Kondado para enviar dados ao seu Data Warehouse ou Data Lake.

Criar usuário de integração no Ploomes

Acesse sua conta Ploomes com um usuário administrador, vá em Administração > Integrações > "Usuários de integração" e clique em "Novo usuário". Preencha o nome como "Kondado", use um email válido da sua empresa (ex: kondado@suaempresa.com.br) e defina o perfil como Administrador.

Copiar a chave da API do usuário Kondado

Na listagem de usuários de integração, selecione o usuário Kondado recém-criado e copie o valor exibido no campo "Chave da API". Este token será usado para autenticar a conexão.

Configurar o conector na Kondado

Faça login na plataforma da Kondado, clique para criar um novo conector Ploomes e cole a chave da API obtida no passo anterior. Salve para validar a conexão.

Criar integrações para o destino desejado

Com o conector ativo, crie suas integrações selecionando as entidades do Ploomes (Negócios, Vendas, Clientes, Tarefas, etc.) e o destino desejado, como Data Warehouse, Data Lake ou planilha.

Perguntas frequentes

O conector do Ploomes está em versão estável ou beta?▼

O conector do Ploomes na Kondado está em modo beta, conforme indicado na documentação. Isso significa que ele está funcional, mas pode receber ajustes contínuos enquanto é aprimorado.

Quais entidades do Ploomes posso integrar pela Kondado?▼

São disponibilizadas mais de 30 entidades, incluindo Negócios, Vendas, Clientes (empresas e pessoas), Produtos, Propostas, Tarefas, Usuários, Documentos, Registros de interação e diversas tabelas auxiliares como status, estágios, funis e classificações. Veja todos os conectores disponíveis.

Como os campos de seleção múltipla do Ploomes aparecem nas tabelas integradas?▼

Campos que suportam múltiplas escolhas são escritos em um único campo da tabela de integração, com os valores separados por vírgulas.

O que acontece com campos customizados que são criados no Ploomes depois da integração?▼

Entidades que suportam campos customizados trazem todos os campos existentes no momento da criação da integração. Novos campos criados posteriormente no Ploomes não são adicionados automaticamente — é necessária uma edição avançada na integração para sincronizar a lista de campos.

Como os campos baseados em listas de seleção do Ploomes são representados nas tabelas?▼

Esses campos geram dois campos na tabela: um terminado em _val (texto da opção no momento da leitura) e outro em _id (identificador da opção). Edições futuras no texto da opção no Ploomes podem não refletir nos registros já integrados, deixando o valor _val defasado.

Para quais destinos posso enviar os dados do Ploomes?▼

Os dados do Ploomes podem ser integrados a um Data Warehouse, Data Lake ou planilha, permitindo análises em BI, construção de dashboards ou atualização automática de planilhas conforme sua necessidade.

Escrito por

Thassyo Pereira·Publicado em 2023-10-03·Atualizado em 2026-08-27