Configurar blocos de ação de Objeto personalizado

Aprenda como configurar blocos de ação de objeto personalizado no Advanced Flow Builder

Written By Frieda Yip (Super Administrator)

Updated at December 29th, 2025

Todos os blocos de ação exigem configuração por meio de um formulário do bloco, onde você define os parâmetros da ação selecionada.

Neste artigo, vamos orientar você sobre como configurar um bloco de ação de objeto personalizado, permitindo que seu fluxo execute as tarefas corretas para alcançar o resultado desejado.
 

Antes de configurar blocos de ação de objeto personalizado, é necessário que pelo menos um objeto personalizado já tenha sido criado na sua empresa. Consulte este artigo da Central de Ajuda para saber mais sobre objetos personalizados.

 

 

Criar registros de objeto personalizado

O bloco de ação Criar registros de objeto personalizado permite criar automaticamente um novo registro em um objeto personalizado. Isso ajuda a evitar erros manuais, manter os dados precisos e garantir que os registros estejam sempre atualizados.

No Advanced Flow Builder, esse bloco é útil quando você deseja capturar dados estruturados durante um fluxo e salvá-los em seus objetos personalizados.

Use este bloco para:

  • Gerenciar associações: criar um registro de Associação para acompanhar nível, datas de início/fim e status de renovação.
  • Salvar registros de pedidos: gerar automaticamente um registro de Pedido com propriedades como valor do pedido, itens comprados e contato associado.
  • Acompanhar assinaturas: registrar detalhes como tipo de plano, ciclo de cobrança e status de pagamento em um objeto de Assinatura.
  • Registrar devoluções ou trocas de produtos: armazenar solicitações de devolução em um objeto personalizado de Devolução para acompanhamento e processamento de reembolsos ou substituições.

Configurar o bloco de ação “Criar registros de objeto personalizado”:

  1. Clique no bloco de ação Criar registros de objeto personalizado para abrir o formulário do bloco, que será exibido no lado direito da tela.
  2. O formulário do bloco contém os seguintes campos:
    1. Objeto personalizado: selecione um objeto personalizado. Caso nenhum objeto tenha sido criado, consulte este artigo da Central de Ajuda para criar um objeto personalizado.
    2. Preencher detalhes do registro: o formulário exibirá campos com base no objeto selecionado, incluindo:
      1. Campos obrigatórios: são necessários para criar o registro com sucesso. Exemplo: Valor do pedido pode ser obrigatório em um objeto de Pedido, ou Número de contato pode ser exigido para vincular um registro de Associação ou Assinatura a um cliente.
      2. Você também pode inserir variáveis (por exemplo, variáveis de gatilho, de contato ou do meio do fluxo) para preencher os dados automaticamente a partir do fluxo.
        1. Usar a variável Número de contato para associar um novo registro de assinatura ao cliente correto.
        2. Usar a variável Canal para registrar por qual canal o pedido foi realizado.

 

Atualizar registros de objeto personalizado

O bloco de ação Atualizar registros de objeto personalizado permite modificar registros existentes em seus objetos personalizados. Isso mantém os dados do workspace precisos e atualizados sem a necessidade de edições manuais.

Use este bloco para:

  • Atualizar status de pedidos: alterar um registro de Pedido de Pendente para Enviado.
  • Gerenciar detalhes de associações: atualizar um registro de Associação com um novo nível ou data de renovação.
  • Ajustar informações de assinaturas: modificar ciclo de cobrança, status de pagamento ou tipo de plano em um registro de Assinatura.
  • Editar registros de clientes: atualizar dados armazenados, como preferências de contato ou pontos de fidelidade.

Configurar o bloco de ação “Atualizar registros de objeto personalizado”:

  1. Clique no bloco de ação Atualizar registros de objeto personalizado para abrir o formulário do bloco, que será exibido no lado direito da tela.
  2. O formulário do bloco contém os seguintes campos:
    1. Objeto personalizado: selecione um objeto personalizado. Caso nenhum objeto tenha sido criado, consulte este artigo da this Help Center article para criar um objeto personalizado.
    2. Identificar registro por: escolha como o sistema deve localizar o registro a ser atualizado:
      1. Último registro do objeto: atualiza o registro criado mais recentemente no objeto selecionado.
      2. Variável: utiliza uma variável (por exemplo, de um gatilho ou etapa intermediária do fluxo) para localizar o registro correto.
      3. ID do registro: insira manualmente o ID do registro ou passe-o por meio de uma variável.
    3. Propriedades a serem atualizadas: defina quais campos do registro devem ser modificados.
      1. Propriedade: selecione a propriedade do objeto (por exemplo, status do pedido, nível da associação, data de renovação da assinatura).
      2. Valor: insira o novo valor ou utilize uma variável para atualizar dinamicamente.
      3. Clique em Adicionar para atualizar várias propriedades de uma só vez.
        1. Usar a variável ID do registro para localizar o pedido correto e atualizar seu status para Entregue.
        2. Usar a variável Número de contato para atualizar o ciclo de cobrança da assinatura do cliente correto.