Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Directory Number (DN) entry
How-to guide

How to assign a Directory Number to a Service Cloud Voice agent

In Service Cloud Voice, the agent''s DN is effectively their Amazon Connect user identity plus the soft-phone they sign into. Provisioning an agent involves creating both the Salesforce user and the corresponding Amazon Connect user.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 20, 2026

In Service Cloud Voice, the agent''s DN is effectively their Amazon Connect user identity plus the soft-phone they sign into. Provisioning an agent involves creating both the Salesforce user and the corresponding Amazon Connect user.

  1. Create the Salesforce user

    Setup, then Users, then New User. Provide the agent''s name, email, and assign a profile that includes Service Cloud Voice access. The Salesforce user is the primary identity.

  2. Provision the matching Amazon Connect user

    In the Amazon Connect console, navigate to User Management, then Add new user. Match the Salesforce user''s email and assign the appropriate Routing Profile and Security Profile.

  3. Assign the Service Cloud Voice permission set

    Back in Salesforce Setup, assign the Service Cloud Voice permission set to the new user. This grants the Voice console access and the soft-phone capability.

  4. Configure the agent''s Routing Profile

    In Amazon Connect, the Routing Profile controls which queues the agent can take calls from. Set the queues, channel concurrency (typically 1 voice call, 5 chats), and priority order.

  5. Test the soft-phone login

    Have the agent log into Salesforce, open the Voice console, and confirm the soft-phone shows Available. Place a test inbound call to a DID that routes to their queue; the soft-phone should ring.

  6. Document the agent''s effective DN

    Record the agent''s Connect username and the queues they are routed to. This is the DN in the modern sense and the answer to how do I route a call to this agent.

Key options
Salesforce Userremember

The primary identity. Drives profile-based permissions and Salesforce data access.

Amazon Connect Userremember

The telephony identity. Drives routing profile, soft-phone access, and call handling.

Routing Profileremember

Controls which queues the agent takes calls from. Effectively the agent''s call mix configuration.

Security Profile (Connect)remember

Permissions within Amazon Connect, distinct from Salesforce profiles.

Gotchas
  • Salesforce and Amazon Connect users are separate. Provisioning one without the other leaves the agent in a half-configured state where Salesforce thinks they exist but routing does not.
  • Routing Profile changes take effect immediately. Switching an agent from Support queue to Sales queue mid-shift can produce surprising call assignments.
  • Soft-phone connections need a working microphone and stable internet. Headset issues are the most common reason a properly configured agent cannot take calls.
  • DN concepts from legacy PBX (specific 4-digit extensions) do not directly translate to Service Cloud Voice. Train agents on the soft-phone model if migrating from PBX.

See the full Directory Number (DN) entry

Directory Number (DN) includes the definition, worked example, deep dive, related terms, and a quiz.