Objetos personalizados (custom_objects.*)

Objetos do negócio (imóveis, veículos, contratos, turmas…): definição com nome, ícone, cor e gênero, campos com tipos, grupo, único, uso e quem preencheu, ligações com contatos, oportunidades, empresas e outros objetos (1 → vários ou vários ↔ vários), registros com responsável, vínculos, notas, histórico, visões salvas, filtros (inclusive por campos do outro lado de uma ligação: relation_filter_fields; operadores começa com e termina com), ações em massa, exportar e importar registros (CSV/TSV) e foto de campo (image_upload). Exportar, importar e ações em massa acima de 200 registros viram tarefas assíncronas: a operação devolve uma tarefa (jobId, state waiting), o worker processa em lotes e record_job_get/record_jobs_list mostram o progresso; a exportação pode avisar por e-mail (notifyEmail). Importar: records_import_upload_url devolve uma URL assinada para enviar o arquivo (até 100 MB, 100.000 linhas) e records_import recebe o uploadId com columnMappings, matchFieldId, conflictStrategy e responsibleAttendantId; records_import_ai_mapping e records_import_ai_column sugerem o mapeamento com IA (sem ANTHROPIC_API_KEY devolvem aiFailed e o mapeamento é por nome da coluna). Exigem o módulo de plano crm.custom-objects (fora do plano padrão; sem ele a resposta é forbidden) e uma migration (sem ela a escrita responde migration_pendente).

Operações: 50. Todas são POST https://app.atomiks.com.br/api/v1/<id>.

• `custom_objects.list`: Listar objetos personalizados (crm:read)
• `custom_objects.overview`: Visão geral dos objetos e ligações (crm:read)
• `custom_objects.get`: Ver um objeto (crm:read)
• `custom_objects.create`: Criar objeto personalizado (crm:write)
• `custom_objects.update`: Editar objeto personalizado (crm:write)
• `custom_objects.archive`: Arquivar objeto (crm:write)
• `custom_objects.unarchive`: Desarquivar objeto (crm:write)
• `custom_objects.fields_list`: Listar campos de um objeto (crm:read)
• `custom_objects.field_create`: Criar campo em um objeto (crm:write)
• `custom_objects.field_update`: Editar campo de um objeto (crm:write)
• `custom_objects.fields_reorder`: Reordenar os campos de um objeto (crm:write)
• `custom_objects.field_insights`: Uso de um campo de objeto (crm:read)
• `custom_objects.field_records`: Quem preencheu um campo de objeto (crm:read)
• `custom_objects.field_groups`: Grupos de campos de um objeto (crm:read)
• `custom_objects.fields_bulk_update`: Alterar vários campos de um objeto (crm:write)
• `custom_objects.relations_list`: Listar ligações dos objetos (crm:read)
• `custom_objects.relation_create`: Criar ligação de um objeto (crm:write)
• `custom_objects.relation_update`: Editar ligação (crm:write)
• `custom_objects.relation_delete`: Excluir ligação (crm:write)
• `custom_objects.access_list`: Cargos e permissões de objetos (crm:read)
• `custom_objects.records_query`: Listar registros de um objeto (crm:read)
• `custom_objects.relation_filter_fields`: Campos filtráveis do outro lado de uma ligação (crm:read)
• `custom_objects.records_search`: Buscar registros de um objeto por título (crm:read)
• `custom_objects.record_get`: Ver um registro (crm:read)
• `custom_objects.record_create`: Criar registro de um objeto (crm:write)
• `custom_objects.record_update`: Editar registro (crm:write)
• `custom_objects.record_delete`: Excluir registro (crm:write)
• `custom_objects.records_bulk_delete`: Excluir registros em massa (crm:write)
• `custom_objects.records_bulk_update`: Alterar registros em massa (crm:write)
• `custom_objects.record_notes_list`: Listar notas de um registro (crm:read)
• `custom_objects.record_note_create`: Criar nota em um registro (crm:write)
• `custom_objects.record_note_update`: Editar nota de um registro (crm:write)
• `custom_objects.record_note_delete`: Excluir nota de um registro (crm:write)
• `custom_objects.record_activities`: Histórico de um registro (crm:read)
• `custom_objects.links_list`: Vínculos de um registro ou de um contato, oportunidade ou empresa (crm:read)
• `custom_objects.link_create`: Vincular registros (crm:write)
• `custom_objects.link_delete`: Desfazer um vínculo (crm:write)
• `custom_objects.links_opportunity_badges`: Selos de objetos nos cards de oportunidade (crm:read)
• `custom_objects.views_list`: Listar visões salvas de um objeto (crm:read)
• `custom_objects.view_create`: Salvar visão de um objeto (crm:write)
• `custom_objects.view_update`: Atualizar visão salva (crm:write)
• `custom_objects.view_delete`: Excluir visão salva (crm:write)
• `custom_objects.records_export`: Exportar registros de um objeto em CSV (crm:write)
• `custom_objects.records_import_upload_url`: Pedir URL para enviar a planilha de importação (crm:write)
• `custom_objects.records_import`: Importar registros de uma planilha (crm:write)
• `custom_objects.records_import_ai_mapping`: Sugerir o mapeamento das colunas da planilha com IA (crm:read)
• `custom_objects.records_import_ai_column`: Sugerir o campo de uma coluna da planilha com IA (crm:read)
• `custom_objects.record_job_get`: Ver uma tarefa de registros (crm:read)
• `custom_objects.record_jobs_list`: Listar tarefas de registros de um objeto (crm:read)
• `custom_objects.image_upload`: Enviar foto de um registro (crm:write)