Bitrix24 CRM

Adicionando a fonte de dados

O Bitrix24 CRM é uma plataforma de gestão de relacionamento com clientes (CRM). A integração de dados do Bitrix24 CRM para o Data Warehouse criada pela Kondado possibilita que você tenha acesso aos seus dados de negócios, contatos, atividades e mais na sua nuvem analítica.

Adicionando o conector

Baseado na documentação da API do Bitrix

Este conector está em modo beta

Requisitos

É necessário um plano comercial do Bitrix
Siga as instruções abaixo com um usuário administrador

Instruções

1) Faça login na sua conta do Bitrix, na barra lateral esquerda, selecione "Applications" > "Developer resources"

Bitrix - Applications > Developer resources

2) Na nova seção, selecione o menu de "Import and export data"

3) Na seção que irá abrir, role até o final e, em "Assign permissions", selecione a opção de "CRM (crm)"

4) Role para cima novamente, copie o valor exibido em "Webhook to call REST API" e depois clique em SALVAR ao final da seção

5) Faça login na plataforma da Kondado, vá para a seção de acionar conectores e selecione o conector do Bitrix24 CRM

6) Dê um nome para o seu conector e, em "Inbound Webhook URL", cole o valor obtido no passo 4 e clique em SALVAR

Agora basta clicar em SALVAR para começar a receber dados do Bitrix24 CRM no seu Data Warehouse ou Data Lake

Pipelines

Resumo

Activity
Catalogs
Companies
Companies: custom fields (data)
Contacts
Contacts: companies
Contacts: custom fields (data)
Deals
Deals: custom fields (data)
Deals: custom fields (meta)
Deals: pipelines
Deals: pipelines: stages
Deals: products
Deals: quotes
Deals: quotes: products
Deals: stage history
Leads
Leads: custom fields (data)
Leads: products
Products

Diagrama de relacionamento

Clique para expandir

Activity

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Atividades do CRM

Campo	Tipo
id	float	[pt] Activity ID
associated_entity_id	float	[pt] ID of an entity associated with the activity
author_id	float
autocomplete_rule	float	[pt] Autocompletion
completed	text	[pt] Completed
created	timestamp	[pt] Created
deadline	timestamp	[pt] Deadline
description	text	[pt] Description
description_type	float	[pt] Description type
direction	float
editor_id	float	[pt] Editor
end_time	timestamp	[pt] Completion time
last_updated	timestamp
location	text	[pt] Location
notify_type	float	[pt] Notification type
notify_value	float
originator_id	text	[pt] Data source ID
origin_id	text	[pt] Element ID in the data source
owner_id	float	[pt] Owner
owner_type_id	float	[pt] Owner type
priority	float	[pt] Priority
provider_data	text
provider_group_id	text
provider_id	text	[pt] Provider ID
provider_type_id	text	[pt] Provider type ID
responsible_id	float
result_currency_id	text
result_mark	float
result_source_id	text
result_status	float
result_stream	float
result_sum	text
result_value	text
start_time	text	[pt] Start time
status	float	[pt] Status
subject	text	[pt] Subject
type_id	float	[pt] Type

Catalogs

Tipo de replicacao: Integral

Definições de catálogos de produtos

Campo	Tipo
id	float	[pt] Identificador do catálogo
name	text	[pt] Nome do catálogo
originator_id	text	[pt] Identificador da origem externa
origin_id	text	[pt] Identificador do catálogo no sistema de origem
xml_id	text	[pt] Identificador XML do catálogo

Companies

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

lead_id → Leads > lead_id

Registros de empresas

Campo	Tipo
company_id	float	[pt] Company ID
date_modify	timestamp
address	text	[pt] Company address
address_2	text	[pt] Second page of address string In some countries it is customary to split an address into 2 parts
address_city	text	[pt] City
address_country	text	[pt] Country
address_country_code	text	[pt] Country code
address_legal	text	[pt] string
address_loc_addr_id	text
address_postal_code	text	[pt] Postal code
address_province	text	[pt] Province
address_region	text	[pt] Region
assigned_by_id	float	[pt] Associated with user by ID
banking_details	text	[pt] Banking details
comments	text	[pt] Comments
company_type	text	[pt] Company type crm_status
created_by_id	float
currency_id	text	[pt] Currency
date_create	timestamp
employees	text
has_email	text
has_imol	text
has_phone	text	[pt] Telephone field fill-up check
industry	text	[pt] Sphere of activity
is_my_company	text	[pt] char
lead_id	float	[pt] ID of the lead, associated with the company Leads > > lead_id
logo_downloadurl	text
logo_id	float
logo_showurl	text
modify_by_id	float	[pt] Last modification author ID user
opened	text
originator_id	text	[pt] Data source ID string Used only to link to an external source.
origin_id	text	[pt] Element ID in the data source
origin_version	text	[pt] Original version
reg_address	text	[pt] Company legal address
reg_address_2	text
reg_address_city	text	[pt] City listed in legal address
reg_address_country	text	[pt] Country listed in legal address
reg_address_country_code	text	[pt] Country code listed in legal address
reg_address_loc_addr_id	text
reg_address_postal_code	text
reg_address_province	text
reg_address_region	text	[pt] Region listed in legal address
revenue	float	[pt] Annual revenue
title	text	[pt] Name
utm_campaign	text	[pt] Ad campaign designation
utm_content	text	[pt] Campaign content
utm_medium	text	[pt] Type of traffic
utm_source	text
utm_term	text	[pt] Campaign search condition

Companies: custom fields (data)

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

company_id → Companies > company_id

Objeto principal

Campo	Tipo
company_id	float	Companies > > company_id
date_modify	timestamp
fdjuighl	float
new_field	float

companies_custom_fields_data_crm_multiple_c

Campos personalizados de empresa (dummy)

Campo	Tipo
company_id	float	[pt] Company Id
crm_multiple_a	text

Contacts

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

company_id → Companies > company_id
lead_id → Leads > lead_id

Registros de contatos

Campo	Tipo
contact_id	float	[pt] Contact ID
address	text	[pt] Contact address
address_2	text	[pt] Second page of the address
address_city	text	[pt] City
address_country	text	[pt] Country
address_loc_addr_id	text
address_postal_code	text	[pt] Postal code
address_province	text	[pt] Province
address_region	text	[pt] Region
assigned_by_id	float	[pt] Associated with user by ID
birthdate	timestamp
comments	text	[pt] Comments
company_id	float	[pt] Associating a contact to a company crm_company Outdated. Companies > > company_id
created_by_id	float
date_create	timestamp
date_modify	timestamp
export	text	[pt] Specifies if the contact is included into export. If N, then it is not possible to upload it.
face_id	text	[pt] Linking to persons from faceid module
has_email	text
has_imol	text
has_phone	text	[pt] Telephone field fill-up check
honorific	text	[pt] Request type
last_name	text	[pt] Last name
lead_id	text	[pt] Lead ID, associated with the contact Leads > > lead_id
modify_by_id	float	[pt] Last modification author ID user
name	text	[pt] Name
opened	text	[pt] Accessible for all
originator_id	text	[pt] Data source ID string Used only to link to external source.
origin_id	text	[pt] Element ID in the data source
origin_version	text	[pt] Original version
photo_downloadurl	text
photo_id	float
photo_showurl	text
post	text	[pt] Position
second_name	text	[pt] Middle name
source_description	text
source_id	text
type_id	text	[pt] ID type
utm_campaign	text	[pt] Advertisement campaign designation
utm_content	text	[pt] Campaign content
utm_medium	text	[pt] Type of traffic
utm_source	text
utm_term	text	[pt] Campaign search condition

Contacts: companies

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

contact_id → Contacts > contact_id
company_id → Companies > company_id

Vínculos entre contatos e empresas

Campo	Tipo
contact_id	float	[pt] Identificador do contato Contacts > > contact_id
company_id	float	[pt] Identificador da empresa Companies > > company_id
is_primary	text	[pt] Indica se esta é a empresa principal do contato
role_id	float	[pt] Identificador do papel da empresa
sort	float	[pt] Ordem da relação

Contacts: custom fields (data)

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

contact_id → Contacts > contact_id

Objeto principal

Campo	Tipo
contact_id	float	[pt] Contact ID Contacts > > contact_id
date_modify	timestamp
uf_crm_x	text
uf_crm_y	timestamp
uf_crm_y	float
option_id	float

contacts_custom_fields_data_crm_multiple_c

Campos personalizados de contato (dummy)

Campo	Tipo
contact_id	float	[pt] Contact Id
crm_multiple_a	text

Deals

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

category_id → Deals: pipelines > id
company_id → Companies > company_id
lead_id → Leads > lead_id
quote_id → Deals: quotes > id
stage_id → Deals: pipelines: stages > status_id

Registros de negócios

Campo	Tipo
id	float	[pt] Deal ID. It is created automatically and is unique for the database.
additional_info	text	[pt] Additional information
assigned_by_id	float	[pt] Associated with a user by ID
begindate	timestamp	[pt] Deal opening date
category_id	float	[pt] Deal pipeline ID. Deals: pipelines > > id
closed	text	[pt] Checkmark 'The deal is closed'
closedate	timestamp	[pt] Deal closing date
comments	text	[pt] Comments
company_id	float	[pt] ID of a company that is a counterpart to the deal Companies > > company_id
contact_id	float	[pt] Contact person ID
created_by_id	float	[pt] Deal creator’s ID
currency_id	text	[pt] Deal currency
date_create	timestamp	[pt] Creation date
date_modify	timestamp	[pt] Modification date
is_manual_opportunity	text
is_new	text
is_recurring	text
is_repeated_approach	text
is_return_customer	text
lead_id	float	[pt] Lead ID Leads > > lead_id
location_id	text
modify_by_id	float	[pt] ID of a person who modified the deal
moved_by_id	float
moved_time	timestamp
opened	text	[pt] Checkmark 'Available to everyone'
opportunity	float	[pt] Amount in deal currency
originator_id	text	[pt] ID of the external information database. The field assignment can be modified by the end developer.
origin_id	text	[pt] External key used for exchange operations. ID of an object of the external information database. The field assignment can be modified by the end developer.
probability	float	[pt] Deal conclusion probability (in %)
quote_id	float	Deals: quotes > > id
source_description	text
source_id	text
stage_id	text	[pt] Deal stage ID Deals: pipelines: stages > > status_id
stage_semantic_id	text
tax_value	float
title	text	[pt] Deal name. A required field.
type_id	text	[pt] Deal type ID.
utm_campaign	text
utm_content	text
utm_medium	text
utm_source	text
utm_term	text

Deals: custom fields (data)

Tipo de replicacao: Incremental

Relacionamentos:

deal_id → Deals > id

Campo	Tipo
deal_id	float	Deals > > id
date_modify	timestamp
uf_crm_x	text
uf_crm_y	timestamp
uf_crm_y	float
option_id	float

Deals: custom fields (meta)

Esta integracao e gratuita

Tipo de replicacao: Integral

Objeto principal

Campo	Tipo
id	float	[pt] Custom field ID
edit_form_label_en	text
edit_in_list	text
entity_id	text	[pt] Type of custom field
error_message_en	text
field_name	text	[pt] Custom field Name
help_message_en	text
is_searchable	text
list_column_label_en	text
list_filter_label_en	text
mandatory	text
multiple	text
settings_caption_no_value	text
settings_default_value	text
settings_default_value	text
settings_display	text
settings_list_height	float
settings_max_length	float
settings_min_length	float
settings_popup	text
settings_regexp	text
settings_rows	float
settings_show_no_value	text
settings_size	float
settings_type	text
settings_value	text
show_filter	text
show_in_list	text
sort	float
user_type_id	text	[pt] Data type
xml_id	text

deals_pipelines__SECTIONS

Campo	Tipo
id	float	[pt] Custom field ID
sections_cal_type	text
sections_id	float
sections_name	text

deals_pipelines__LIST

Metadados de campos personalizados de negócios

Campo	Tipo
id	float	[pt] Custom field ID
list_def	text
list_id	float
list_sort	float
list_value	text

Deals: pipelines

Esta integracao e gratuita

Tipo de replicacao: Integral

Lista de funis de vendas

Campo	Tipo
id	float	[pt] Identificador do funil
isdefault	text	[pt] Indica se o funil é padrão
name	text	[pt] Nome do funil
originid	text	[pt] Identificador de origem externa
originatorid	text	[pt] Identificador da aplicação de origem
sort	float	[pt] Posição do funil na ordenação

Deals: pipelines: stages

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

pipeline_id → Deals: pipelines > id

Fases configuradas para cada funil de negócios

Campo	Tipo
id	float	[pt] Identificador da fase
pipeline_id	float	[pt] Identificador do funil Deals: pipelines > > id
color	text	[pt] Código de cor em hexadecimal
entity_id	text	[pt] Identificador completo da fase no funil
extra_color	text	[pt] Informação adicional de cor
extra_semantics	text	[pt] Semântica adicional atribuída à fase
name	text	[pt] Nome da fase
name_init	text	[pt] Nome inicial da fase
semantics	text	[pt] Código de semântica da fase
sort	float	[pt] Posição da fase dentro do funil
status_id	text	[pt] Tipo de progresso da fase
system	text	[pt] Indica se a fase é definida pelo sistema

Deals: products

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

deal_id → Deals > id
product_id → Products > product_id

Produtos vinculados aos negócios

Campo	Tipo
deal_id	float	[pt] Deal ID Deals > > id
deal_product_id	float	[pt] ID of Deal and product relation
customized	text
discount_rate	float
discount_sum	float
discount_type_id	float
measure_code	float
measure_name	text
owner_type	text
price_account	float
price_brutto	float
price_exclusive	float
price_netto	float
product_id	float	Products > > product_id
quantity	float
reserve_id	float
reserve_quantity	float
sort	float
tax_included	text
tax_rate	float

Deals: quotes

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

company_id → Companies > company_id
contact_id → Contacts > contact_id
deal_id → Deals > id

Registros de cotações

Campo	Tipo
id	float	[pt] Quote ID
assigned_by_id	float	[pt] Associated with a user by the ID.
begindate	timestamp
closed	text	[pt] Closed
closedate	timestamp
comments	text	[pt] Manager comment
company_id	float	[pt] Linking to company Companies > > company_id
contact_id	float	[pt] crm_contact (Outdated. Saved for compatibility.) Contacts > > contact_id
content	text	[pt] Quote content
created_by_id	float
currency_id	text	[pt] Quote currency
date_create	timestamp
date_modify	timestamp
deal_id	float	[pt] Deal, associated with a quote Deals > > id
lead_id	float	[pt] Lead, associated with a quote
location_id	text	[pt] Location
modify_by_id	float	[pt] ID of the last modification author
mycompany_id	float	[pt] Company ID, from which the quote is submitted
opened	text	[pt] Accessible for all
opportunity	float	[pt] Amount
person_type_id	float	[pt] Payer type ID
quote_number	float	[pt] Quote number
status_id	text	[pt] Status
storage_element_ids	text
storage_type_id	float
tax_value	float	[pt] Amount sum
terms	text	[pt] Conditions
title	text	[pt] Name
utm_campaign	text	[pt] Advertisement campaign designation
utm_content	text	[pt] Campaign content
utm_medium	text	[pt] Type of traffic
utm_source	text
utm_term	text	[pt] Campaign search condition
webform_id	text

Deals: quotes: products

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

product_id → Products > product_id

Produtos vinculados às cotações

Campo	Tipo
quote_id	float	[pt] Quote ID
id	float	[pt] Relationship quote-product ID
customized	text
discount_rate	float
discount_sum	float
discount_type_id	float
measure_code	float
measure_name	text
original_product_name	text
owner_type	text
price	float
price_account	float
price_brutto	float
price_exclusive	float
price_netto	float
product_description	text
product_id	float	Products > > product_id
product_name	text
quantity	float
reserve_id	text
reserve_quantity	float
sort	float
tax_included	text
tax_rate	float

Deals: stage history

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

pipeline_id → Deals: pipelines: stages > pipeline_id
deal_id → Deals > id
stage_id → Deals: pipelines: stages > status_id

Histórico de mudanças de fase dos negócios

Campo	Tipo
id	float	[pt] Identificador do registro
pipeline_id	float	[pt] Identificador do funil Deals: pipelines: stages > > pipeline_id
created_time	timestamp	[pt] Data e hora em que a fase foi registrada
deal_id	float	[pt] Identificador do negócio Deals > > id
stage_id	text	[pt] Código da fase Deals: pipelines: stages > > status_id
stage_semantic_id	text	[pt] Status semântico da fase
type_id	float	[pt] Tipo do registro. Pode assumir os valores: 1 - criação da entidade, 2 - movimento para fase intermediária, 3 - movimento para fase final

Leads

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

company_id → Companies > company_id
contact_id → Contacts > contact_id

Registros de leads

Campo	Tipo
lead_id	float	[pt] Lead ID
address	text	[pt] Contact address
address_2	text	[pt] Second page of the address
address_city	text	[pt] City
address_country	text	[pt] Country
address_country_code	text	[pt] Country
address_loc_addr_id	float
address_postal_code	text	[pt] Postal code
address_province	text	[pt] Province
address_region	text	[pt] Region
assigned_by_id	float	[pt] Associated with user by ID
birthdate	timestamp
comments	text	[pt] Comments
company_id	float	[pt] Linking a contact to a company Companies > > company_id
company_title	text	[pt] Name of company, associated with a lead
contact_id	float	[pt] Linking a lead to a contact Contacts > > contact_id
created_by_id	float
currency_id	text
date_closed	text
date_create	timestamp
date_modify	timestamp
has_email	text
has_imol	text
has_phone	text	[pt] Telephone field fill-up check
honorific	text	[pt] Request
is_manual_opportunity	text
is_return_customer	text
last_name	text
modify_by_id	float	[pt] Last modification author ID user
moved_by_id	float
moved_time	timestamp
name	text	[pt] Name
opened	text	[pt] Accessible for all
opportunity	float
originator_id	text	[pt] Data source ID
origin_id	text	[pt] Element ID in the data source
post	text	[pt] Position
second_name	text	[pt] Second name
source_description	text	[pt] Source description?
source_id	text	[pt] Source ID
status_description	text
status_id	text
status_semantic_id	text
title	text	[pt] Lead name
utm_campaign	text	[pt] Advertisement campaign designation
utm_content	text	[pt] Campaign content
utm_medium	text	[pt] Type of traffic
utm_source	text	[pt] Advertisement system
utm_term	text	[pt] Campaign search condition
webform_id	text

Leads: custom fields (data)

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

lead_id → Leads > lead_id

Campo	Tipo
lead_id	float	[pt] Lead ID Leads > > lead_id
date_modify	timestamp
uf_crm_x	text
uf_crm_y	timestamp
uf_crm_y	float
option_id	float

Leads: products

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Relacionamentos:

lead_id → Leads > lead_id
product_id → Products > product_id

Produtos vinculados aos leads

Campo	Tipo
lead_id	float	[pt] Lead ID Leads > > lead_id
id	float	[pt] Relação produto-lead
customized	text
discount_rate	float	[pt] Product discount
discount_sum	float
discount_type_id	float
measure_code	float
measure_name	text
original_product_name	text
owner_type	text
price	float	[pt] Product price
price_account	float
price_brutto	float
price_exclusive	float
price_netto	float
product_description	text
product_id	float	[pt] Product ID Products > > product_id
product_name	text	[pt] product name
quantity	float	[pt] product quantity
reserve_id	text
reserve_quantity	float
sort	float
tax_included	text
tax_rate	float

Products

Tipo de replicacao: Integral

Relacionamentos:

catalog_id → Catalogs > id

Registros de produtos (dummy)

Campo	Tipo
product_id	float	[pt] Product Id
active	text
catalog_id	float	Catalogs > > id
code	text
created_by	float
currency_id	text
date_create	timestamp
description	text
description_type	text
detail_picture	text
measure	float
modified_by	float
name	text
preview_picture	text
price	float
section_id	float
sort	float
timestamp_x	timestamp
vat_id	text
vat_included	text
xml_id	float
uf_crm_x	text
uf_crm_y	timestamp
uf_crm_y	float
option_id	float

Notas

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

Configurar o conector Bitrix24 CRM na Kondado

Siga estes passos para integrar os dados do Bitrix24 CRM ao seu Data Warehouse ou Data Lake usando a plataforma Kondado.

Verifique os requisitos do Bitrix24

Certifique-se de que sua conta possui um plano comercial do Bitrix e que você está logado como usuário administrador, pois será necessário acessar as configurações de aplicações e permissões de API.

Gerar o Webhook no Bitrix24

No painel do Bitrix, acesse Applications > Developer resources, depois Import and export data. Em Assign permissions, selecione CRM (crm), role até Webhook to call REST API, copie o valor exibido e clique em SALVAR.

Adicionar o conector na Kondado

Acesse a página do conector Bitrix24 CRM na plataforma Kondado, vá para a seção de adicionar conectores e selecione o conector correspondente.

Configurar e salvar o conector

Dê um nome ao seu conector, cole o Inbound Webhook URL obtido no passo 2 no campo correspondente e clique em SALVAR. Agora seus dados do Bitrix24 CRM já podem ser enviados para o seu destino de dados.

Explore os dados disponíveis

O conector oferece integrações gratuitas com diversas entidades como Activity, Companies, Contacts, Deals, Leads, Products e campos personalizados. Consulte a documentação completa das tabelas para planejar suas análises.

Perguntas frequentes

Quais sao os requisitos para usar o conector Bitrix24 CRM na Kondado?▼

Voce precisa de um plano comercial do Bitrix e executar a configuracao com um usuario administrador da conta, ja que e necessario acessar Applications > Developer resources e atribuir permissoes de API.

Como obtenho o Webhook do Bitrix24 para configurar o conector?▼

No Bitrix24, acesse Applications > Developer resources > Import and export data. Em Assign permissions, marque CRM (crm), role ate o final, copie o valor exibido em Webhook to call REST API e clique em SALVAR. Esse valor sera colado em Inbound Webhook URL na Kondado.

Quais entidades do Bitrix24 CRM sao disponibilizadas pela integracao?▼

O conector disponibiliza Activity, Catalogs, Companies (com campos customizados), Contacts (com vinculo a empresas e campos customizados), Deals (com pipelines, estagios, produtos, cotacoes, historico de estagios e campos customizados), Leads (com produtos e campos customizados) e Products.

O conector Bitrix24 CRM ja esta em versao final?▼

Nao. Conforme indicado no proprio artigo, o conector do Bitrix24 CRM na Kondado esta em modo beta, baseado na documentacao da API do Bitrix. A funcionalidade principal esta disponivel, mas pode receber ajustes.

Para onde posso enviar os dados do Bitrix24 CRM?▼

Os dados podem ser enviados para um Data Warehouse ou Data Lake conectado a Kondado. Confira todos os destinos disponiveis para escolher a opcao adequada a sua arquitetura.

Como configuro o conector na Kondado depois de gerar o Webhook?▼

Faca login na plataforma da Kondado, va para a secao de adicionar conectores, selecione Bitrix24 CRM, de um nome ao conector e cole o valor copiado em Inbound Webhook URL. Clique em SALVAR para finalizar.

Escrito por

Thassyo Pereira·Publicado em 2022-08-22·Atualizado em 2026-06-01