Obter oportunidades para ação personalizada de ID de conta

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • A ação Obter oportunidades para ID de conta recupera registros de oportunidade da conta específica do Salesforce. Esta ação é invocada quando o agente exibe uma oportunidade do Salesforce disponível para a conta do cliente com base na conta do Salesforce associada a ela.

    Esta ação é semelhante à ação Obter todas as oportunidades.

    Entradas de ação

    Além do número máximo de registros a serem retornados pela consulta, esta ação também usa uma ID de conta do Salesforce como entrada a ser usada como um parâmetro de consulta. O valor deste parâmetro é fornecido pelo relacionamento que vincula a conta do cliente e a oportunidade do Salesforce por meio da ID de conta do Salesforce associada. Para obter mais informações, consulte Criar listas relacionadas definidas.

    O relacionamento específico necessário para o exemplo de referência também é descrito no tópico Como usar uma lista relacionada para criar a conexão entre a conta do cliente e as oportunidades do Salesforce.

    O parâmetro de entrada da ação ID de conta do Salesforce não tem valor padrão.

    Tela de entradas mostrando as entradas de ação e seus valores padrão.

    Descrição da ação com entradas: script de pré-processamento, etapa REST, script de pós-processamento. Entrada de ação mostrando Rótulo, Nome, Tipo e uma alternância para Obrigatório.

    Etapa de pré-processamento

    A etapa de script de pré-processamento usa a entrada de ação como sua.

    Tela da etapa de pré-processamento mostrando as entradas de ação com seletores de cápsula para gerar consultas.

    O script da etapa de pré-processamento cria uma consulta SELECT semelhante à criada para a ação Obter todas as oportunidades com a adição da verificação em relação à ID da conta do Salesforce.

    (function execute(inputs, outputs) {
      
      outputs.query = "query/?q=SELECT+Name,Id,AccountId,CloseDate,Amount,” +
                      “StageName,Probability,Type+FROM+Opportunity”         +
                      
                      "+WHERE+AccountId='" + inputs.salesforce_account_id + "
    
                      “+LIMIT+” + inputs.max_number_of_opportunity_records; 
      
    })(inputs, outputs);
    

    A saída de pré-processamento é uma consulta, semelhante à ação Obter todas as oportunidades.

    Etapa REST, etapa de pós-processamento e saídas de ação

    Essas etapas e saídas são as mesmas da ação Obter todas as oportunidades.