Configuring field-based callback number selection

If enabled for your account, you can configure Vonage Contact Center to dynamically select a callback number based on the value in any field of the record you're dialling from. This method does not require Apex code as the code is provided in the managed package.

For example, you might want Vonage Contact Center to present one callback number when your agents click to dial contacts in the finance department and another for contacts in the legal department. Vonage Contact Center will present the default callback number when dialing contacts in any other department.

Before you can configure this feature, you or your Salesforce administrator must perform the following tasks. The administrator needs to perform these tasks one time only.

  • Specify which class Vonage Contact Center must use to select the callback number. You specify the class in the custom settings data for your org, profile or user. Type VCCCore.SelectPresentedCLIDByField in the Callback Number Selector Class field. For more information about configuring custom setttings, see Configuring custom settings for optional Vonage Contact Center features in Salesforce.
  • Assign Vonage Contact Center - Auto Presented CLID user permission set to all agents and supervisors using this feature. For detailed information about this permission set, see ContactWorld Auto Presented CLID user permissions.
  • Assign the ContactWorld Supervisor permission set to any supervisor who needs to configure this feature. For detailed information about this permission set, see ContactWorld Supervisor permissions.
  • Configure sharing settings for the Vonage Field-Based Mapping object if you want to restrict the access different profiles have to other profiles' records. For information about sharing settings, see Salesforce help.
  • Set the Vonage Field-Based Mapping object tab to Default On for supervisors.
  • If you are using Salesforce Lightning Experience, you must add the Vonage Field-Based Mappings tab to the applicable app or apps.

How do I configure field-based callback number selection?

When your administrator has enabled the feature, you can create mappings. These map the value in specific fields to specific callback numbers. To create a new mapping, perform the following steps:

  1. Go to the Vonage Field-Based Mapping object tab, click Vonage Field-Based Mappings in the View list and click Go!. Any existing mappings appear.
  2. Click New Vonage Field-Based Mapping. A new Vonage Field-Based Mapping record appears.
  3. Provide the following information. Ignore other fields.

    FieldDescriptionExample
    Mapping NameA name for this mapping.Callback for VIP accounts
    ObjectThe type of Salesforce object that the agent has clicked to dial from. The object type contains the field which the callback number is based on.Account
    Field

    The field on the Salesforce record that contains the value which the callback number is based on.

    You must specify the full API name of the field, including the package name if relevant. For example, NVMContactWorld__CustomerPriority__c.

    You must provide the correct API name in this field. If you provide an incorrect value in any of your mappings, this feature may not work.

    Account_type
    ValueThe value that the field must contain to return the number in the Presented Callback Number field. The Value field can contain any alphanumeric value or you can leave the field empty. If you do not provide a value in the Value field, if the field on the record is also empty, Vonage Contact Center presents the number in the Presented Callback Number field.VIP
    Presented Callback Number

    The callback number that Vonage will display when the field's value matches the value in the Value field.

    You can only use callback numbers that are configured for your account. If you use a number that is not configured for your account, Vonage Contact Center cannot make outbound calls that use this prefix mapping record. The error message "The call to number dialed number could not be made as the presented CLID presented callback number is restricted or is not available on your account." appears in your agent's ContactPad.

    02072068888
  4. Click Save.
    Now when an agent clicks to dial a phone number in an account record with a value of 'VIP' in the Account_type field, Vonage Contact Center uses 0207206888 as the callback number.
    In the absence of any other mappings, when an agent clicks to dial a phone number from an account record with any other value in the Account_type field or from any other object, Vonage Contact Center uses the default callback number. This default callback number can be for the account or for the agent. Which callback number Vonage Contact Center uses depends on the current configuration. For more information about callback numbers, see Callback numbers.

The configuration only applies when the agent makes a call using Connect or Click to dial.

A note about performance

Although the system has no limit on the number of mappings objects you have, we recommend that you have no more than a few hundred. If you have thousands of mappings, your outbound call might be delayed by several seconds while Salesforce searches all the mappings for a matching rule. You must never exceed 50,000 mappings for a single object or 100,000 mappings in total.

 Example

Your company sells in both the insurance and banking industries. You want to present a different callback number when your sales agents make outbound calls to either of those industries. (Your sales agents must belong to the Sales profile.) The rest of the users will use the default callback. Your callback number for Insurance is 01234567890 and your callback number for Banking is 123456789.

To configure this example, you must perform the following tasks:

  • Create a custom settings record for the Sales profile and set the value of the Callback Number Selector Class field to VCCCore.SelectPresentedCLIDByField.

    Leave the Callback Number Selector Class field value empty in the default custom settings for the organization level.
  • Create one Vonage Field-Based Mapping record, with the following values:
    • Object: Account
    • Field: Industry
    • Value: Insurance
    • Presented Callback Number: 0123456789
    • Mapping Name: Callback for Insurance Accounts numbers
  • Create another Vonage Field-Based Mapping record with these values:
    • Object: Account
    • Field: Industry
    • Value: Banking
    • Presented Callback Number: 123456789
    • Mapping Name: Callback for Banking Accounts numbers

Now, whenever your sales agents make an outbound call to an account from the banking industry, Vonage Contact Center presents the banking industry's callback number. Similarly, when a sales agent makes an outbound call to an account in the insurance industry, Vonage Contact Center presents the insurance industry's callback number. When any other agent makes a click to dial call, Vonage Contact Center presents the default callback number because you have not configured the agents to use this feature.

Support and documentation feedback

For general assistance, please contact Customer Support.

For help using this documentation, please send an email to docs_feedback@vonage.com. We're happy to hear from you. Your contribution helps everyone at Vonage! Please include the name of the page in your email.