salvar_campo_formulario_pipeline
Add or move a field in a pipeline deal form. Specify the field key, form ID, and optionally section and order to update the form layout.
Instructions
Adicionar ou mover um campo no formulário de negócios de um pipeline.
Se o campo (FieldKey) já existir no formulário, ele é movido para a
seção/posição indicada em vez de ser duplicado.
Passe o ID do campo para atualizar diretamente sem busca prévia.
Observacoes:
1. Use buscar_formulario_pipeline para obter o form_id, secao_id e IDs de campos.
2. chave_campo (FieldKey) deve ser uma das chaves nativas de negócio:
- deal_title: Título do negócio
- deal_amount: Valor
- deal_currency: Moeda
- deal_contact: Empresa (contato principal)
- deal_person: Pessoa de contato
- deal_tags: Marcadores
- deal_origin: Origem
- deal_owner: Responsável
- deal_start_date: Data de início
- deal_collaborating_users: Usuários colaboradores
- deal_products: Produtos
Para campos customizados, use a chave retornada por buscar_campos_entidades.
3. largura_total=True faz o campo ocupar a linha inteira do formulário.
4. ordenacao define a posição dentro da seção (menor = mais acima).
5. Se secao_id não for informado, o campo fica no topo do formulário (sem seção).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| form_id | Yes | ||
| secao_id | No | ||
| ordenacao | No | ||
| chave_campo | Yes | ||
| largura_total | No |