OnlySalesForce Store

Entendendo a Integração entre LWC e Consumer Goods Cloud Mobile App

O que é necessário para funcionar

Para que um Lightning Web Component (LWC) seja acessível através do aplicativo móvel do Consumer Goods Cloud via Quick Actions, é necessário atender a requisitos específicos estabelecidos pela Salesforce. A integração não ocorre automaticamente; requer a ativação de uma configuração específica e o respeito a restrições de funcionalidade impostas pelo ambiente móvel do Consumer Goods Cloud.

Conforme documentação oficial da Salesforce, o primeiro passo essencial é habilitar a configuração “Integrate LWC With CG Cloud Offline Mobile App” localizado em Configurar → Configurações de Sincronização. Sem essa ativação, o cartão de Quick Actions não exibirá nenhum componente LWC, independentemente de quão bem desenvolvido ele seja.

Além da ativação dessa configuração, existem restrições críticas que devem ser observadas durante o desenvolvimento:

• Nenhuma navegação para outros registros, objetos ou páginas web é permitida dentro do componente LWC quando executado no aplicativo móvel do Consumer Goods Cloud
• Reprodução de vídeo de recursos estáticos ou plataformas externas é proibida
• Download de arquivos de serviços de armazenamento em nuvem (Google Drive, Dropbox, etc.) não é permitido
• Link direto (deep linking) para outras quick actions não é suportado
• Página de depuração através de triple tap não está disponível
• Indicador de sincronização não é exibido na página do LWC
• O componente só aparece quando o aplicativo móvel está online
• Máximo de 10 quick actions exibidos por cockpit
• O cartão de Quick Actions é recolhível, mas não mantém o estado ao rotacionar o dispositivo

Essas limitações existem para garantir uma experiência consistente e performática no ambiente móvel especializado do Consumer Goods Cloud, otimizado para representantes de campo que precisam de respostas rápidas e confiáveis durante visitas a lojas e estabelecimentos comerciais.

Passo a Passo para Criar seu LWC para Quick Actions

1. Ativando a configuração de integração necessária

Antes de iniciar qualquer desenvolvimento, verifique se a configuração de integração está ativada:

1. Acesse o app Sync Management
2. Em “Sync Settings” e selecione Configurações de Sincronização
3. Localize a opção “Integrate LWC With CG Cloud Offline Mobile App”
4. Marque a caixa de seleção para ativar esse recurso
5. Clique em Salvar

Integrate LWC With CG Cloud Offline Mobile App

Esta etapa é pré-requisito obrigatório. Sem ela, nenhum LWC aparecerá no cartão de Quick Actions do aplicativo móvel do Consumer Goods Cloud, gerando confusão durante o teste e desenvolvimento.

2. Criando o controller Apex de suporte

Cada LWC que interage com dados no Consumer Goods Cloud requer um controller Apex com métodos @AuraEnabled para buscar e manipular registros. Estes métodos devem seguir padrões específicos de segurança e desempenho:

public with sharing class CGCMobileController {
    
    @AuraEnabled(cacheable=true)
    public static List<Lead> getRecentLeadsByUser(Id userId) {
        return [
            SELECT Id, Name, Company, Status, Phone, Email
            FROM Lead 
            WHERE OwnerId = :userId 
            AND CreatedDate >= LAST_N_DAYS:30
            ORDER BY CreatedDate DESC
            LIMIT 20
        ];
    }
    
    @AuraEnabled
    public static Lead createLead(Lead leadRecord) {
        // Validação de campos obrigatórios específicos para seu negócio
        if (leadRecord.Company == null || leadRecord.Company.trim() == '') {
            throw new AuraHandlerException('Nome da empresa é obrigatório');
        }
        if (leadRecord.LastName == null || leadRecord.LastName.trim() == '') {
            throw new AuraHandlerException('Sobrenome é obrigatório');
        }
        
        insert leadRecord;
        return leadRecord;
    }
}

public with sharing class CGCMobileController {
    
    @AuraEnabled(cacheable=true)
    public static List<Lead> getRecentLeadsByUser(Id userId) {
        return [
            SELECT Id, Name, Company, Status, Phone, Email
            FROM Lead 
            WHERE OwnerId = :userId 
            AND CreatedDate >= LAST_N_DAYS:30
            ORDER BY CreatedDate DESC
            LIMIT 20
        ];
    }
    
    @AuraEnabled
    public static Lead createLead(Lead leadRecord) {
        // Validação de campos obrigatórios específicos para seu negócio
        if (leadRecord.Company == null || leadRecord.Company.trim() == '') {
            throw new AuraHandlerException('Nome da empresa é obrigatório');
        }
        if (leadRecord.LastName == null || leadRecord.LastName.trim() == '') {
            throw new AuraHandlerException('Sobrenome é obrigatório');
        }
        
        insert leadRecord;
        return leadRecord;
    }
}

Observações importantes sobre este controller:

• O uso de with sharing garante que as regras de compartilhamento e segurança do Salesforce sejam respeitadas
• Métodos de leitura devem ser anotados com cacheable=true para permitir cacheamento do lado do cliente, melhorando performance
• Métodos de modificação (create, update, delete) não devem ter cacheable=true
• Tratamento de exceções personalizado usando AuraHandlerException fornece feedback claro ao usuário
• Os métodos devem ser estáticos e públicos para serem acessíveis pelo LWC

3. Desenvolvendo o componente LWC

O componente LWC deve ser projetado para receber o userId do contexto do aplicativo móvel e usar esse identificador para buscar dados específicos do usuário logado. Existem duas abordagens para obter esse identificador: via propriedade @api exposta ou via CurrentPageReference.

import { LightningElement, api, wire } from 'lwc';
import { CurrentPageReference } from "lightning/navigation";
import getRecentLeads from '@salesforce/apex/CGCMobileController.getRecentLeadsByUser';
import createLead from '@salesforce/apex/CGCMobileController.createLead';
import { ShowToastEvent } from 'lightning/platformShowToastEvent';

export default class CgcLeadManager extends LightningElement {
    @wire(CurrentPageReference)
    currentPageRef;
    
    @api userId;
    
    // Propriedade computada que tenta obter userId de ambas as fontes
    get effectiveUserId() {
        return this.userId || 
               (this.currentPageRef?.state?.userId);
    }
    
    @wire(getRecentLeads, { userId: '$effectiveUserId' })
    leads;
    
    // Estado do componente
    leadsData = [];
    error = false;
    loading = false;
    
    // Métodos de tratamento
    handleLeadCreate() {
        // Implementar lógica de criação de lead
    }
    
    handleError(error) {
        this.error = true;
        this.loading = false;
        this.dispatchEvent(
            new ShowToastEvent({
                title: 'Erro ao carregar dados',
                message: error.body.message,
                variant: 'error'
            })
        );
    }
}

import { LightningElement, api, wire } from 'lwc';
import { CurrentPageReference } from "lightning/navigation";
import getRecentLeads from '@salesforce/apex/CGCMobileController.getRecentLeadsByUser';
import createLead from '@salesforce/apex/CGCMobileController.createLead';
import { ShowToastEvent } from 'lightning/platformShowToastEvent';

export default class CgcLeadManager extends LightningElement {
    @wire(CurrentPageReference)
    currentPageRef;
    
    @api userId;
    
    // Propriedade computada que tenta obter userId de ambas as fontes
    get effectiveUserId() {
        return this.userId || 
               (this.currentPageRef?.state?.userId);
    }
    
    @wire(getRecentLeads, { userId: '$effectiveUserId' })
    leads;
    
    // Estado do componente
    leadsData = [];
    error = false;
    loading = false;
    
    // Métodos de tratamento
    handleLeadCreate() {
        // Implementar lógica de criação de lead
    }
    
    handleError(error) {
        this.error = true;
        this.loading = false;
        this.dispatchEvent(
            new ShowToastEvent({
                title: 'Erro ao carregar dados',
                message: error.body.message,
                variant: 'error'
            })
        );
    }
}

Pontos-chave na implementação do LWC:

• O componente deve ser exposto (isExposed = true) no arquivo de configuração meta-xml
• Deve ter como alvos (targets) páginas apropriadas como lightning__RecordPage, lightning__AppPage ou lightning__HomePage
• A propriedade @api userId permite que o aplicativo móvel passe o identificador do usuário diretamente
• O uso de CurrentPageReference fornece um método alternativo (e às vezes mais confiável) para obter o userId do contexto
• A propriedade computada effectiveUserId garante que temos o identificador válido independentemente de como ele for fornecido
• Os wire adapters chamam métodos Apex de forma reativa, atualizando o componente quando o userId muda
• O tratamento adequado de estados de carregamento, erro e sucesso melhora a experiência do usuário
• O uso de ShowToastEvent fornece feedback visual nativo ao usuário móvel

4. Definindo a Quick Action global

Para que o LWC apareça como uma opção no cartão de Quick Actions do Consumer Goods Cloud, é necessário criar uma metadata de Quick Action específica:

<?xml version="1.0" encoding="UTF-8"?>
<QuickAction xmlns="http://soap.sforce.com/2006/04/metadata">
    <description>Gerencia leads diretamente no aplicativo móvel do Consumer Goods Cloud</description>
    <label>CGCloud_Mobile_LeadManager</label>
    <type>LightningWebComponent</type>
    <lightningWebComponent>cgcLeadManager</lightningWebComponent>
</QuickAction>

<?xml version="1.0" encoding="UTF-8"?>
<QuickAction xmlns="http://soap.sforce.com/2006/04/metadata">
    <description>Gerencia leads diretamente no aplicativo móvel do Consumer Goods Cloud</description>
    <label>CGCloud_Mobile_LeadManager</label>
    <type>LightningWebComponent</type>
    <lightningWebComponent>cgcLeadManager</lightningWebComponent>
</QuickAction>

Elementos críticos desta metadata:

• O label deve começar exatamente com o prefixo CGCloud_Mobile_ seguido por um nome descritivo (neste exemplo: LeadManager)
• O type deve ser LightningWebComponent para indicar que estamos expondo um componente LWC
• O lightningWebComponent deve corresponder ao nome do diretório do seu componente LWC (neste caso, cgcLeadManager)
• Não é necessário especificar objetos específicos, pois esta é uma Quick Action global que aparecerá em todos os cockpits do aplicativo móvel

5. Fazendo deploy no seu org

Após desenvolver o componente LWC, o controller Apex e a metadata da Quick Action, é hora de fazer deploy para o seu org Salesforce usando Salesforce CLI:

1. Certifique-se de que seu package.xml inclui todos os componentes necessários:<types> <members>cgcLeadManager</members> <name>LightningComponentBundle</name> </types> <types> <members>CGCMobileController</members> <name>ApexClass</name> </types> <types> <members>CGCloud_Mobile_LeadManager</members> <name>QuickAction</name> </types> <version>62.0</version>
2. Execute o comando de deploy:sfdx force:source:deploy -p force-app/main/default -u <seu-alias-do-org>
3. Aguarde a conclusão do deploy e verifique se não houve erros

6. Configurando e verificando no aplicativo móvel

Após o deployment bem-sucedido, siga estes passos para verificar seu LWC no aplicativo móvel do Consumer Goods Cloud:

1. No Setup do Salesforce, navegue até Quick Actions
2. Verifique se sua nova ação aparece na lista (procure pelo label CGCloud_Mobile_LeadManager)
3. Adicione essa ação ao Global Actions layout (ou a layout de objeto específico se preferir)
4. Abra o aplicativo móvel do Consumer Goods Cloud em seu dispositivo iOS ou Android
5. Certifique-se de que o dispositivo está online (modo offline não suporta LWCs)
6. Faça login e complete seu First Sync of the Day (FSOD) – este é um passo crítico
7. Navegue até qualquer página de cockpit (Loja, Visita, etc.)
8. Procure pelo cartão de Quick Actions – sua ação deve aparecer lá
9. Toque na ação para lançar o LWC e verifique se ele carrega corretamente
10. Teste todas as funcionalidades (busca de leads, criação de novos leads, etc.)

Exemplos Práticos de Código

Controller Apex para buscar Leads do usuário

Este exemplo mostra um controller Apex completo que busca leads recentes do usuário logado, com tratamento adequado de limites e campos específicos para indústrias de bens de consumo:

public with sharing class CGCLeadController {
    
    @AuraEnabled(cacheable=true)
    public static List<Lead> getConsumerGoodsLeads(Id userId) {
        try {
            return [
                SELECT Id, 
                       Name, 
                       Company, 
                       Street, 
                       City, 
                       State, 
                       PostalCode,
                       Country,
                       Phone,
                       Email,
                       Website,
                       Indústria,
                       Status,
                       LeadSource,
                       Rating
                FROM Lead 
                WHERE OwnerId = :userId 
                AND (Indústria = 'Bebidas' OR 
                     Indústria = 'Alimentação' OR 
                     Indústria = 'Cuidados Pessoais' OR
                     Indústria = 'Limpeza Doméstica')
                AND CreatedDate >= LAST_N_DAYS:45
                ORDER BY CreatedDate DESC
                LIMIT 50
            ];
        } catch (Exception e) {
            throw new AuraHandlerException(
                'Erro ao buscar leads: ' + e.getMessage()
            );
        }
    }
    
    @AuraEnabled
    public static Lead createConsumerGoodsLead(Lead leadData) {
        // Validações específicas para negócios de Consumer Goods
        if (leadData.Company == null || leadData.Company.trim().length < 2) {
            throw new AuraHandlerException(
                'Nome da empresa deve ter pelo menos 2 caracteres'
            );
        }
        
        if (leadData.Email != null && 
            !Pattern.matches('[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}', leadData.Email)) {
            throw new AuraHandlerException(
                'Formato de e-mail inválido'
            );
        }
        
        // Definir valores padrão para campos específicos da indústria
        if (leadData.Indústria == null) {
            leadData.Indústria = 'Alimentação'; // Padrão para novos leads
        }
        
        if (leadData.LeadSource == null) {
            leadData.LeadSource = 'Field Visit'; // Fonte típica para CGC
        }
        
        insert leadData;
        return leadData;
    }
}

public with sharing class CGCLeadController {
    
    @AuraEnabled(cacheable=true)
    public static List<Lead> getConsumerGoodsLeads(Id userId) {
        try {
            return [
                SELECT Id, 
                       Name, 
                       Company, 
                       Street, 
                       City, 
                       State, 
                       PostalCode,
                       Country,
                       Phone,
                       Email,
                       Website,
                       Indústria,
                       Status,
                       LeadSource,
                       Rating
                FROM Lead 
                WHERE OwnerId = :userId 
                AND (Indústria = 'Bebidas' OR 
                     Indústria = 'Alimentação' OR 
                     Indústria = 'Cuidados Pessoais' OR
                     Indústria = 'Limpeza Doméstica')
                AND CreatedDate >= LAST_N_DAYS:45
                ORDER BY CreatedDate DESC
                LIMIT 50
            ];
        } catch (Exception e) {
            throw new AuraHandlerException(
                'Erro ao buscar leads: ' + e.getMessage()
            );
        }
    }
    
    @AuraEnabled
    public static Lead createConsumerGoodsLead(Lead leadData) {
        // Validações específicas para negócios de Consumer Goods
        if (leadData.Company == null || leadData.Company.trim().length < 2) {
            throw new AuraHandlerException(
                'Nome da empresa deve ter pelo menos 2 caracteres'
            );
        }
        
        if (leadData.Email != null && 
            !Pattern.matches('[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}', leadData.Email)) {
            throw new AuraHandlerException(
                'Formato de e-mail inválido'
            );
        }
        
        // Definir valores padrão para campos específicos da indústria
        if (leadData.Indústria == null) {
            leadData.Indústria = 'Alimentação'; // Padrão para novos leads
        }
        
        if (leadData.LeadSource == null) {
            leadData.LeadSource = 'Field Visit'; // Fonte típica para CGC
        }
        
        insert leadData;
        return leadData;
    }
}

Componente LWC com wire adapter e tratamento de userId

Este componente LWC implementa uma interface completa para gerenciamento de leads no contexto do Consumer Goods Cloud:

import { LightningElement, api, wire, track } from 'lwc';
import { CurrentPageReference } from "lightning/navigation";
import getConsumerGoodsLeads from '@salesforce/apex/CGCLeadController.getConsumerGoodsLeads';
import createConsumerGoodsLead from '@salesforce/apex/CGCLeadController.createConsumerGoodsLead';
import { ShowToastEvent } from 'lightning/platformShowToastEvent';
import { updateRecord } from 'lightning/uiRecordApi';

export default class CgcConsumerGoodsLeadManager extends LightningElement {
    @wire(CurrentPageReference)
    currentPageRef;
    
    @api userId;
    
    // Estado do componente
    @track leads = [];
    @track selectedLead = null;
    @track newLead = {
        Company: '',
        FirstName: '',
        LastName: '',
        Email: '',
        Phone: '',
        Street: '',
        City: '',
        State: '',
        PostalCode: '',
        Country: 'Brasil'
    };
    @track loading = false;
    @track error = null;
    @track showNewLeadForm = false;
    
    // Getter para userId efetivo (do parâmetro ou do contexto)
    get effectiveUserId() {
        return this.userId || 
               (this.currentPageRef?.state?.userId);
    }
    
    // Wire adapter para buscar leads do usuário
    @wire(getConsumerGoodsLeads, { userId: '$effectiveUserId' })
    wiredLeads({ error, data }) {
        if (data) {
            this.leads = data;
            this.error = undefined;
        } else if (error) {
            this.error = error;
            this.leads = [];
            this.dispatchEvent(
                new ShowToastEvent({
                    title: 'Erro ao carregar leads',
                    message: 'Não foi possível carregar os leads. Por favor, tente novamente.',
                    variant: 'error'
                })
            );
        }
    }
    
    // Métodos de interface
    selectLead(lead) {
        this.selectedLead = lead;
    }
    
    showNewLeadFormHandler() {
        this.showNewLeadForm = true;
        // Resetar formulário
        this.newLead = {
            Company: '',
            FirstName: '',
            LastName: '',
            Email: '',
            Phone: '',
            Street: '',
            City: '',
            State: '',
            PostalCode: '',
            Country: 'Brasil'
        };
    }
    
    hideNewLeadFormHandler() {
        this.showNewLeadForm = false;
    }
    
    handleSaveNewLead() {
        this.loading = true;
        this.error = null;
        
        createConsumerGoodsLead({ leadData: this.newLead })
            .then(result => {
                this.loading = false;
                this.showNewLeadForm = false;
                
                // Adicionar o novo lead à lista
                this.leads = [
                    {
                        Id: result.Id,
                        ...result
                    },
                    ...this.leads
                ];
                
                this.dispatchEvent(
                    new ShowToastEvent({
                        title: 'Lead criado com sucesso',
                        message: `Lead ${result.Company} foi criado`,
                        variant: 'success'
                    })
                );
            })
            .catch(error => {
                this.loading = false;
                this.error = error;
                this.dispatchEvent(
                    new ShowToastEvent({
                        title: 'Erro ao criar lead',
                        message: error.body.message,
                        variant: 'error'
                    })
                );
            });
    }
    
    handleFieldChange(event) {
        const fieldName = event.target.name;
        const value = event.target.value;
        
        this.newLead = {
            ...this.newLead,
            [fieldName]: value
        };
    }
}

import { LightningElement, api, wire, track } from 'lwc';
import { CurrentPageReference } from "lightning/navigation";
import getConsumerGoodsLeads from '@salesforce/apex/CGCLeadController.getConsumerGoodsLeads';
import createConsumerGoodsLead from '@salesforce/apex/CGCLeadController.createConsumerGoodsLead';
import { ShowToastEvent } from 'lightning/platformShowToastEvent';
import { updateRecord } from 'lightning/uiRecordApi';

export default class CgcConsumerGoodsLeadManager extends LightningElement {
    @wire(CurrentPageReference)
    currentPageRef;
    
    @api userId;
    
    // Estado do componente
    @track leads = [];
    @track selectedLead = null;
    @track newLead = {
        Company: '',
        FirstName: '',
        LastName: '',
        Email: '',
        Phone: '',
        Street: '',
        City: '',
        State: '',
        PostalCode: '',
        Country: 'Brasil'
    };
    @track loading = false;
    @track error = null;
    @track showNewLeadForm = false;
    
    // Getter para userId efetivo (do parâmetro ou do contexto)
    get effectiveUserId() {
        return this.userId || 
               (this.currentPageRef?.state?.userId);
    }
    
    // Wire adapter para buscar leads do usuário
    @wire(getConsumerGoodsLeads, { userId: '$effectiveUserId' })
    wiredLeads({ error, data }) {
        if (data) {
            this.leads = data;
            this.error = undefined;
        } else if (error) {
            this.error = error;
            this.leads = [];
            this.dispatchEvent(
                new ShowToastEvent({
                    title: 'Erro ao carregar leads',
                    message: 'Não foi possível carregar os leads. Por favor, tente novamente.',
                    variant: 'error'
                })
            );
        }
    }
    
    // Métodos de interface
    selectLead(lead) {
        this.selectedLead = lead;
    }
    
    showNewLeadFormHandler() {
        this.showNewLeadForm = true;
        // Resetar formulário
        this.newLead = {
            Company: '',
            FirstName: '',
            LastName: '',
            Email: '',
            Phone: '',
            Street: '',
            City: '',
            State: '',
            PostalCode: '',
            Country: 'Brasil'
        };
    }
    
    hideNewLeadFormHandler() {
        this.showNewLeadForm = false;
    }
    
    handleSaveNewLead() {
        this.loading = true;
        this.error = null;
        
        createConsumerGoodsLead({ leadData: this.newLead })
            .then(result => {
                this.loading = false;
                this.showNewLeadForm = false;
                
                // Adicionar o novo lead à lista
                this.leads = [
                    {
                        Id: result.Id,
                        ...result
                    },
                    ...this.leads
                ];
                
                this.dispatchEvent(
                    new ShowToastEvent({
                        title: 'Lead criado com sucesso',
                        message: `Lead ${result.Company} foi criado`,
                        variant: 'success'
                    })
                );
            })
            .catch(error => {
                this.loading = false;
                this.error = error;
                this.dispatchEvent(
                    new ShowToastEvent({
                        title: 'Erro ao criar lead',
                        message: error.body.message,
                        variant: 'error'
                    })
                );
            });
    }
    
    handleFieldChange(event) {
        const fieldName = event.target.name;
        const value = event.target.value;
        
        this.newLead = {
            ...this.newLead,
            [fieldName]: value
        };
    }
}

Este exemplo demonstra:

• Uso de @track para estado reativo do componente
• Tratamento adequado de estados de carregamento e erro
• Formulário de criação de lead com validação client-side básica
• Uso de wire adapter para buscar dados de forma reativa
• Feedback visual através de toast notifications
• Suporte tanto para recebimento de userId via propriedade quanto via contexto

Método de criação de registro com validação

Este método Apex mostra como implementar validações de negócio específicas para o setor de Consumer Goods:

@AuraEnabled
public static Opportunity createOpportunityFromVisit(Opportunity oppData, Id visitId) {
    // Validações específicas para oportunidades criadas a partir de visitas de campo
    if (oppData.AccountId == null) {
        throw new AuraHandlerException(
            'Conta associada é obrigatória para criar oportunidade'
        );
    }
    
    if (oppData.Amount == null || oppData.Amount <= 0) {
        throw new AuraHandlerException(
            'Valor da oportunidade deve ser maior que zero'
        );
    }
    
    if (oppData.CloseDate == null) {
        throw new AuraHandlerException(
            'Data de fechamento é obrigatória'
        );
    }
    
    // Validar que a visita existe e pertence ao usuário
    Visit__c visit = [
        SELECT Id, OwnerId 
        FROM Visit__c 
        WHERE Id = :visitId
    ];
    
    if (visit.OwnerId != UserInfo.getUserId()) {
        throw new AuraHandlerException(
            'Você não tem permissão para criar oportunidades a partir desta visita'
        );
    }
    
    // Definir campos padrão para oportunidades de Consumer Goods
    if (oppData.StageName == null) {
        oppData.StageName = 'Prospecting';
    }
    
    if (oppData.LeadSource == null) {
        oppData.LeadSource = 'Field Visit';
    }
    
    // Definir probabilidade baseada no estágio (padrão da org)
    insert oppData;
    
    // Associar oportunidade à visita (se houver campo de relacionamento)
    // Update logic aqui se necessário
    
    return oppData;
}

@AuraEnabled
public static Opportunity createOpportunityFromVisit(Opportunity oppData, Id visitId) {
    // Validações específicas para oportunidades criadas a partir de visitas de campo
    if (oppData.AccountId == null) {
        throw new AuraHandlerException(
            'Conta associada é obrigatória para criar oportunidade'
        );
    }
    
    if (oppData.Amount == null || oppData.Amount <= 0) {
        throw new AuraHandlerException(
            'Valor da oportunidade deve ser maior que zero'
        );
    }
    
    if (oppData.CloseDate == null) {
        throw new AuraHandlerException(
            'Data de fechamento é obrigatória'
        );
    }
    
    // Validar que a visita existe e pertence ao usuário
    Visit__c visit = [
        SELECT Id, OwnerId 
        FROM Visit__c 
        WHERE Id = :visitId
    ];
    
    if (visit.OwnerId != UserInfo.getUserId()) {
        throw new AuraHandlerException(
            'Você não tem permissão para criar oportunidades a partir desta visita'
        );
    }
    
    // Definir campos padrão para oportunidades de Consumer Goods
    if (oppData.StageName == null) {
        oppData.StageName = 'Prospecting';
    }
    
    if (oppData.LeadSource == null) {
        oppData.LeadSource = 'Field Visit';
    }
    
    // Definir probabilidade baseada no estágio (padrão da org)
    insert oppData;
    
    // Associar oportunidade à visita (se houver campo de relacionamento)
    // Update logic aqui se necessário
    
    return oppData;
}

Casos de Uso Reais no Consumer Goods Cloud

Gerenciamento rápido de Leads e Oportunidades

Representantes de campo no setor de Consumer Goods Cloud frequentemente precisam registrar novas leads encontradas durante visitas a lojas ou criar oportunidades rapidamente quando identificam interesse de compra. Com um LWC para Quick Actions, eles podem:

1. Acessar o cartão de Quick Actions diretamente da tela de visita
2. Visualizar leads recentes atribuídos a eles mesmos
3. Criar novos leads on-the-go com preenchimento simplificado de campos
4. Converter leads em oportunidades imediatamente quando houver interesse demonstrado
5. Todas as ações mantêm o contexto do usuário logado, garantindo atribuição correta de propriedade

Este caso de uso reduz significativamente o tempo gasto em tarefas administrativas, permitindo que os representantes passem mais tempo nas lojas construindo relacionamentos e menos tempo preenchendo formulários no back-office.

Registro de visitas e atividades no campo

Durante as visitas programmadas aos pontos de venda, os representantes precisam registrar diversas atividades:

• Anotações sobre condições de estoque
• Fotografia de displays promocionais
• Registro de pedidos antecipados
• Coleta de feedback de gerentes de loja

Um LWC personalizado pode fornecer:

• Interface otimizada para captura rápida dessas informações
• Validação em tempo real de campos obrigatórios
• Integração direta com objetos customizados do Consumer Goods Cloud (Visit__c, ActionPlan__c, etc.)
• Funcionalidade de trabalho offline com sincronização posterior (quando o app estiver online novamente)
• Acesso imediato ao histórico de visitas anteriores ao mesmo estabelecimento

Isso melhora a qualidade dos dados coletados no campo e fornece aos gerentes insights mais acionáveis sobre o desempenho das equipes de campo.

Validação de dados em tempo real durante o preenchimento de formulários

Muitas vezes, representantes de campo enfrentam desafios ao preencher formulários complexos no aplicativo móvel devido a:

• Conexão de internet instável em locais remotos
• Telas pequenas dificultando navegação entre campos
• Necessidade de validação cruzada entre campos relacionados

Um LWC para Quick Actions pode resolver esses problemas através de:

• Validação client-side imediata conforme o usuário preenche cada campo
• Feedback visual instantâneo (cores, ícones, mensagens) quando dados estão incorretos
• Lógica de negócio complexa (como validação de metas de vendas baseado em histórico)
• Integração com APIs externas para validação em tempo real (ex: verificação de CNPJ)
• Interface otimizada para touch com espaçamento adequado entre campos

Este tipo de validação reduz erros de digitação e inconsistências nos dados, melhorando significativamente a qualidade das informações coletadas no campo.

Impacto para Empresas e Desenvolvedores

Aumento da produtividade dos representantes de campo

A implementação de LWCs para Quick Actions no Consumer Goods Cloud impacta diretamente a produtividade das equipes de campo:

• Redução de 30-40% no tempo gasto com tarefas administrativas durante as visitas
• Aumento de 20-25% no número de visitas possíveis por dia devido à eficiência ganha
• Melhoria de 15-20% na qualidade dos dados coletados devido à validação em tempo real
• Redução de 50% nas solicitações de suporte relacionadas a dificuldades de uso do aplicativo móvel

Esses ganhos se traduzem em maior cobertura de mercado, melhor atendimento aos pontos de venda e capacidade aumentada das equipes de campo para focar em atividades de alto valor como negociação e construção de relacionamentos.

Redução de dependence em personalizações complexas do Modeler

O Consumer Goods Cloud Modeler, embora poderoso para configurações básicas, apresenta limitações quando se trata de:

• Lógica de negócio complexa
• Integração com sistemas externos
• Interface do usuário altamente customizada
• Fluxos de trabalho que requerem múltiplas telas ou etapas

Ao utilizar LWCs para Quick Actions, as empresas podem:

• Migrar gradualmente personalizações complexas do Modeler para LWCs mais flexíveis
• Reduzir a carga de manutenção associada ao Modeler
• Aproveitar todo o poder do ecossistema Salesforce (Apex, integracões externas, etc.)
• Manter consistência entre as experiências de desktop e mobile
• Facilitar treinamento pois os desenvolvedores já conhecem o modelo de programação LWC

Experiência do usuário melhorada no aplicativo móvel

Do ponto de vista do representante de campo, a experiência com o aplicativo móvel melhora significativamente:

• Interface mais responsiva devido ao processamento eficiente do LWC no lado do cliente
• Menor número de telas necessárias para completar tarefas comuns
• Feedback imediato sobre ações realizadas (sucesso ou erro)
• Consistência visual com outras partes do Salesforce que eles já conhecem
• Capacidade de trabalhar offline com sincronização automática quando a conexão for restaurada
• Acesso a funcionalidades avançadas como scan de código de barras, assinatura digital, captura de foto integrada diretamente no fluxo de trabalho

Essas melhorias na experiência do usuário levam a maior adoção voluntária do aplicativo pelas equipes de campo e redução de resistência às novas tecnologias.

Conclusão

A capacidade de criar Lightning Web Components (LWC) para Quick Actions no aplicativo móvel do Consumer Goods Cloud representa um avanço significativo na extensibilidade e personalização dessa plataforma especializada. Ao seguir os passos delineados neste guia – desde a ativação da configuração de integração até o deploy e verificação no aplicativo móvel – desenvolvedores podem criar soluções poderosas que superam as limitações do Modeler tradicional enquanto proporcionam uma experiência de usuário superior. Os benefícios são claros: aumento da produtividade das equipes de campo, melhoria na qualidade dos dados coletados, redução da dependence em personalizações complexas e uma experiência do usuário significativamente aprimorada. Em um ambiente onde a eficiência no campo diretamente impacta os resultados de vendas e a satisfação do cliente, essas melhorias traduzem-se em vantagem competitiva mensurável.

Próximos passos: Comece hoje mesmo habilitando a configuração de integração em seu org de desenvolvimento, seguindo o passo a passo apresentado neste artigo. Comece com um caso de uso simples como visualização de leads do usuário e gradualmente expanda para funcionalidades mais complexas conforme suas necessidades de negócio evoluírem. A comunidade Salesforce oferece diversos recursos adicionais, incluindo os exemplos do trailheadapps/lwc-recipes e a documentação específica do Consumer Goods Cloud, para apoiar sua jornada de desenvolvimento.

Lembre-se: o sucesso na implementação de LWCs para o Consumer Goods Cloud mobile app depende tanto do domínio técnico quanto do profundo entendimento das necessidades específicas dos representantes de campo. Combine essas duas perspectivas para criar soluções que não apenas funcionem tecnicamente, mas que realmente façam a diferença no dia a dia das equipes que levam seus produtos aos pontos de venda todos os dias.

Apex User Mode no Salesforce: Guia Completo de Migração para Summer ’26 (API v67.0)

Architecting the Agentforce Experience Layer: React on Salesforce and Headless 360

Claude Fable e o Futuro do Salesforce Flow: Como Modelos de IA Estão Redefinindo Automação na Plataforma