---
schema_version: "1"
id: d398f2ac844ede3c8f16dbc3eb99aecb384a11afb2aa829ba775fd2c6ca55557
title: Search the Transfer and Conference Destination List
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/messaging-byoc-ccaas/guides/search-transfer-destinations.md
canonical_url: https://developer.salesforce.com/docs/service/messaging-byoc-ccaas/guide/search-transfer-destinations.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 86eefa03d3fd377c3f477d633d80b0229fcc257d647f6442b4cdfbe1367b6ae6
products:
  - Bring Your Own Channel for CCaaS
  - Service Cloud Developer Content
---
# Search the Transfer and Conference Destination List

When a rep transfers a Messaging session or initiates a conference for Bring Your Own Channel for CCaaS, Salesforce provides a UI to search for transfer destinations. These instructions are for implementations with partner-owned routing (`ConversationChannelDefinition.routingOwner` is `Partner`).

## Search Transfer Destinations

The transfer destinations are returned from the vendor when implementing [getContacts()](/docs/service/service-connector-api/references/connector-api/service-connector-interface-getcontacts.html).

The API supports a long list of transfer destinations and lets reps search for contacts that they want to transfer to.

![Select a transfer destination](https://developer.salesforce.com/docs/media/messaging-byoc-ccaas/byoc-ccaas-messaging-transfer-destination-selected.png '{"class": "image-sm"}')

## Search Conference Destinations

The start conference destination list is also returned from the vendor when implementing [getContacts()](/docs/service/service-connector-api/references/connector-api/service-connector-interface-getcontacts.html).

The API supports a long list of request conference destinations and lets reps search for contacts, queues, or flows that they want to add to a conference.

![Select a conference destination](https://developer.salesforce.com/docs/media/messaging-byoc-ccaas/messaging_conference_destination_list.png '{"class": "image-sm"}')

## Search and Pagination

Salesforce calls [getContacts()](/docs/service/service-connector-api/references/connector-api/service-connector-interface-getcontacts.html) with a filter argument. The filter object has the keys `contains`, `limit`, and `offset`. `limit` is a constant set to 50 and `offset` is calculated by the UI.  
If the vendor supports contact search (by specifying [AgentConfigResult.hasContactSearch](/docs/service/service-connector-api/references/connector-api/service-connector-objects-agentconfigresult.html) as `true`), the following events occur.

- When the transfer UI is shown, `getContacts({limit: 50})` is called and the vendor can return the most recent 50 items.
- With every search or filtering request, Salesforce calls `getContacts({contains: string, limit: 50, offset: number })`.
- When scrolling down (progressive loading), Salesforce calls `getContacts({contains: string, filter: string, limit: 50, offset: calculated})`.

Example scenarios:

- At initialization time: `getContacts({limit: 50}) → \[a1,b2... x50\]` (most recent contacts)
- When searching for "xyz": `getContacts({contains: "xyz", limit: 50, offset: 0}) → \[xyz1,xyz2... xyz50\]`
- When scrolling down: `getContacts({contains: "xyz", offset: 50, limit: 50}) → \[xyz51,xyz52... xyz100\]`

## Pseudo Contact Search

If a vendor doesn’t implement contact search, the [AgentConfigResult.hasContactSearch](/docs/service/service-connector-api/references/connector-api/service-connector-objects-agentconfigresult.html) capability is set to false or undefined.

If the capability is false or undefined, Salesforce gets all phone contacts (up to 1000\) and stores them in memory. Then, for every scroll or search, Salesforce does a pseudo search, or a simple filtering, and shows the data that matches the filter. getContacts() is called one time.

**See Also**

- _Service Connector API Reference_: [getContacts](/docs/service/service-connector-api/references/connector-api/service-connector-interface-getcontacts.html)
- _Service Connector API Reference_: [AgentConfigResult](/docs/service/service-connector-api/references/connector-api/service-connector-objects-agentconfigresult.html)