Referência do conector Zoho CRM
Beta
Este recurso está em Beta. Para usá-lo, um administrador de workspace deve habilitar o Lakeflow Connect para Zoho CRM na página Prévias . Consulte Gerenciar prévias do Databricks.
Esta página contém informações de referência para o conector Zoho CRM gerenciado, incluindo tabelas de origem suportadas e esquemas de tabela de destino.
Tabelas de origem suportadas
O conector Zoho CRM oferece suporte às seguintes tabelas de origem, todas no esquema de origem default:
Tabela de origem | Chave primária | Descrição | Modo de sincronização | Campo do cursor |
|---|---|---|---|---|
|
| Registros de lead. | Incremental |
|
|
| Registros de contato. | Incremental |
|
|
| Registros da account. | Incremental |
|
|
| Registros de negócio. | Incremental |
|
|
| Registros de campanha. | Incremental |
|
|
| Registros de atividades de tarefas. | Incremental |
|
|
| Registros de atividades de chamadas. | Incremental |
|
|
| Registros de atividades de reuniões e eventos. | Incremental |
|
|
| Notas anexadas aos registros. | Incremental |
|
|
| Registros de fornecedor. | Incremental |
|
|
| Registros de orçamento. | Incremental |
|
|
| Registros de pedidos de ventas. | Incremental |
|
|
| Registros de pedido de compra. | Incremental |
|
|
| Registros de solução. | Incremental |
|
|
| Registros de caso. | Incremental |
|
|
| Registros de fatura. | Incremental |
|
|
| Registros de produto. | Incremental |
|
|
| Entradas de história de estágio para negócios. | Incremental |
|
Tabelas de módulos personalizados |
| Uma tabela por módulo personalizado que o Zoho CRM relata como compatível com API e visualizável. Cada nome de tabela é o nome da API do módulo em letras minúsculas. | Incremental |
|
|
| Registros de lista de preços. | Incremental |
|
|
| Itens de linha em faturas. | Incremental |
|
|
| Itens de linha em cotações. | Incremental |
|
|
| Itens de linha em pedidos de ventas. | Incremental |
|
|
| Itens de linha em pedidos de compra. | Incremental |
|
|
| Funções na hierarquia de funções da organização. | Apenas refresh completo | |
|
| Perfis de usuário. | Apenas refresh completo | |
|
| Moedas configuradas para a organização. | Apenas refresh completo | |
|
| Detalhes da organização. | Apenas refresh completo | |
|
| Funções de contato disponíveis para negócios. | Apenas refresh completo | |
|
| Territórios configurados no Gerenciamento de Território. | Apenas refresh completo | |
|
| Usuários na organização. | Incremental |
|
|
| Estágios de negociação para cada pipeline e disposição. | Apenas refresh completo | |
|
| Tags definidas para cada módulo. | Incremental |
|
|
| Metadados do anexo para registros. | Incremental |
|
|
| Territórios atribuídos a cada usuário. | Apenas refresh completo |
Opções de conector
Para uso, veja Exemplos.
Opção | Tipo | Escopo | Obrigatório | Aplica-se a | Descrição |
|---|---|---|---|---|---|
| String | Pipeline | Sim | Todas as tabelas incrementais | Data e hora mais antigas para ingestão de dados, no formato |
Transformações automáticas de dados
Para tabelas de módulos, tabelas de itens e tabelas de módulos personalizados, o Databricks transforma os tipos de campo do Zoho CRM em tipos de dados compatíveis com Delta da seguinte forma. Cada tipo de campo mostra o nome da interface do usuário do Zoho CRM quando aplicável, seguido pelo seu valor de data_type na API de metadados de campos do Zoho CRM.
Tipo de campo Zoho CRM | Tipo de Delta |
|---|---|
Linha única ( | String |
Várias linhas ( | String |
email ( | String |
Telefone ( | String |
Website ( | String |
Lista de seleção ( | String |
| Matriz de strings ( |
Número automático ( | String |
Imagem de perfil ( | String |
| BigInt |
Inteiro longo ( | BigInt, ou String quando a API retorna o valor como uma strings |
Decimal ( | Double |
| Double |
Moeda ( | Decimal(19, 4) |
| Decimal(19, 4) |
| Booleana |
| Data |
| Carimbo de data/hora |
Fórmula ( | Com base no tipo de retorno da fórmula: Double ( |
Resumo acumulado ( | Com base no tipo de retorno: Duplo ( |
Pesquisa ( | Variante |
Proprietário ( | Variante |
Usuário ( | Variante |
| Variante |
Pesquisa de seleção múltipla ( | Variante |
Pesquisa de vários usuários ( | Variante |
Subformulário ( | Variante |
Upload de arquivo ( | Variante |
Upload de imagem ( | Variante |
Endereço ( | Variante |
| Variante |
| Variante |
| Variante |
| Variante |
Esquemas de tabela de destino
Tabelas de módulos e tabelas de módulos personalizados
O conector cria o esquema de cada tabela de módulo, tabela de itens e tabela de módulo personalizada a partir dos metadados de campo do módulo no Zoho CRM. Cada campo se torna uma coluna nomeada com o nome da API do campo, e o tipo de dados da coluna segue as Transformações de dados automáticas. As colunas, portanto, incluem campos personalizados e variam de acordo com a organização do Zoho CRM. Cada tabela também tem uma coluna id do tipo STRING.
Essas tabelas são leads, contacts, accounts, deals, campaigns, tasks, calls, events, notes, vendors, quotes, sales_orders, purchase_orders, solutions, cases, invoices, products, deal_history, price_books, invoiced_items, quoted_items, ordered_items_sales_order, purchase_items e attachments.
O conector cria uma tabela de módulo personalizado para cada módulo personalizado que o Zoho CRM relata como compatível com API e visível para o usuário da conexão. O nome da tabela é o nome da API do módulo em letras minúsculas. Por exemplo, um módulo personalizado com o nome da API Projects vai para a tabela projects.
key primária: id
Campo do cursor: Modified_Time
Tabelas com VARIANT colunas não oferecem suporte ao tipo 2 de dimensão que muda lentamente (SCD). A maioria das tabelas de módulo tem campos de pesquisa, como o proprietário do registro, que mapeiam para VARIANT.
roles
Primary key: id
Sync mode: Refresh somente completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
profiles
Primary key: id
Sync mode: Refresh somente completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
currencies
Chave key: id
Modo de sincronização: Apenas refresh completo
Disponibilidade: Requer Multi-Currency, que está disponível na edição Professional ou acima.
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
organization
Primary key: id
Sync mode: Refresh somente completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
contact_roles
Primary key: id
Sync mode: Refresh somente completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
territories
Primary key: id
Sync mode: Full refresh only
Availability: Requer o Gerenciamento de Território, que está disponível na edição Enterprise ou acima.
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte a SCD tipo 2 porque possui colunas VARIANT.
users
key primária: id
Campo do cursor: Modified_Time
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte a SCD tipo 2 porque possui colunas VARIANT.
stages
key primária: layout_id, pipeline_id, id
Modo de sincronização: Apenas refresh completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
tags
key primária: id
Campo do cursor: modified_time
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
user_territories
Primary key: user_id, id
Modo de sincronização: Apenas refresh completo
Disponibilidade: Requer o Gerenciamento de Território, que está disponível na edição Enterprise ou acima.
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
Permissões OAuth obrigatórias
O conector solicita os seguintes escopos OAuth somente leitura para o Zoho Self Client. Para obter mais informações, consulte Escopos OAuth do Zoho CRM.
Permissão | Necessário para |
|---|---|
| Tabelas de módulo, tabelas de item, tabelas de módulo personalizado, |
|
|
| Tabelas de módulo, tabelas de item, tabelas de módulo personalizado |
| Descoberta de módulo personalizado, |
| Descoberta de esquema para tabelas de módulo, tabelas de item e tabelas de módulo personalizadas |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|