Page Comparison

When an agent makes a call using NewVoiceMedia, the agent can set a disposition code associated with that call. For more information about disposition codes, see Disposition codes for NewVoiceMedia in Salesforce.

You have three different ways to configure disposition codes:

• Configuring disposition codes using Log a Call
• Configuring setting the disposition code for a call based on the call's outcome
• Configuring disposition codes using custom components and Apex

1. Configuring disposition codes using Log a Call

If your agents use Log a Call to add notes and other details during a call, you can configure disposition codes in the Log a Call area. If your agents do not use Log a Call, you can still configure disposition codes using custom components and Apex. For information about configuring disposition codes using custom components and Apex, see Configuring disposition codes for NewVoiceMedia in Salesforce227154569.

How do I enable agents to select a disposition code for a call?

...

...

When an agent clicks to save their changes in Log a Call, Salesforce notifies NewVoiceMedia whether the agent has provided a value in the specified disposition code field.

2. Configuring setting the disposition code for a call based on the call's outcome

If enabled for your account, you can configure NewVoiceMedia in Salesforce to automatically set the disposition code for an outbound call based on what happened to the call. To configure this feature, you must map call outcomes to disposition codes.

3. Configuring disposition codes using custom components and Apex

If the enforced disposition codes feature is enabled for your account and your agents use custom components during a call rather than Log a Call, you can configure the custom component to set disposition codes as required.

...

To configure the custom component to set disposition codes, use call the SetDispositionCodeForCurrentCall method in the DispositionCodeService class provided in the NewVoiceMedia package. Use the following Apex code to in your component:

...

When your custom component runs the configured Apex code, the DispositionCodeService sets the disposition code for the call in NewVoiceMedia.

Visualforce example

You can use the DispositionCodeService Visualforce or Lightning @AuraEnabled methods.

public with sharing class SampleDispositionController {
 
    public String dispositionCode { get; set; }
     
    public PageReference DispositionCall() {
         
        System.debug('Code: ' + dispositionCode);
        NVMContactWorld.DispositionCodeService dispositionCodeService = new NVMContactWorld.DispositionCodeService();
        dispositionCodeService.SetDispositionCodeForCurrentCall(dispositionCode);
         
        return null;
    }
}

<apex:page controller="SampleDispositionController">
    <apex:form >
        <apex:selectList multiselect="false" size="1" value="{!dispositionCode}">
            <apex:selectOption itemLabel="Call back in 7 days" itemValue="CallBack" />
            <apex:selectOption itemLabel="Do not contact" itemValue="DoNotContact" />
        </apex:selectList>
        <apex:commandButton value="Disposition Call" action="{!DispositionCall}"/>
    </apex:form>
</apex:page>

Flows example

You can use the DispositionCodeService in a Flow.

global class DispositionFlow {
     
    @InvocableMethod (label = 'Set Disposition Code for Current Call' description = 'Set the disposition code for the users current call in NewVoiceMedia.')
    global static void SetDispositionCode(List<String> params) {
         
        if (params.size() != 1) {
            // Error?
            System.debug('You should pass only 1 disposition code to this method.');
        }
         
        String dispositionCode = params[0];
 
        NVMContactWorld.DispositionCodeService dispositionCodeService = new NVMContactWorld.DispositionCodeService();
        dispositionCodeService.SetDispositionCodeForCurrentCall(dispositionCode);
         
    }
}

DML statements, asynchronous Apex, scheduled Apex, sending email

The SetDispositionCodeForCurrentCall method makes HTTP callouts to NewVoiceMedia, so you cannot run DML statements, asynchronous Apex (such as future methods and batch Apex jobs), or scheduled Apex, or send email before calling this code. For further information, see Salesforce help.

If you need to perform any such tasks before calling the SetDispositionCodeForCurrentCall method, wrap the call in a future method. For information about future methods and Salesforce limits with future methods, see Salesforce help.

public class DispositionCodeServiceFutureWrapper
{
    @future(callout=true)
    public static void SetDispositionCodeForCurrentCallInFuture(String dispositionCode)
    {  
         NVMContactWorld.DispositionCodeService dispositionCodeService = new NVMContactWorld.DispositionCodeService();
         dispositionCodeService.SetDispositionCodeForCurrentCall(dispositionCode);
    }
}

public class YourCode
{
    public void YourMethod()
    {
        // --EXAMPLE-- DML statement require before callout
        Example__c obj = new Example__c(Name = 'Test');
        insert obj;
 
        // Call to @future method, which will then callout to NewVoiceMedia
        DispositionCodeServiceFutureWrapper.SetDispositionCodeForCurrentCallInFuture('DISPOSITION_CODE_VALUE');
    }
}

How do I display the disposition code in the call's task record in Salesforce?

...

Next you must add the field to the task's page layout.

Configuring setting the disposition code for a call based on the call's outcome

If enabled for your account, you can configure NewVoiceMedia in Salesforce to automatically set the disposition code for an outbound call based on what happened to the call. To configure this feature, you must map call outcomes to disposition codes.

...