> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing connections to Customer Care platforms

Customer Care platform connections define how you connect watsonx Orchestrate to external customer engagement systems, such as Genesys Cloud, during runtime.

You use these connections in the Agent Assist dashboard to subscribe to live customer conversations. By configuring a Customer Care platform connection, you decide which customer care tenant and credentials watsonx Orchestrate uses when it interacts with active conversations.

Use the ADK CLI commands in this topic to configure, list, and remove Customer Care platform connections for your tenant.

## Configuring a Customer Care platform connection

Use the following command to set up a new connection or update one you already manage.

```bash BASH theme={null}
orchestrate customer-care platform configure \
  --type genesys
  --name <connection unique name>
  --endpoint <Customer Care connection endpoint> \
  --client-id  <client ID> \
  --client-secret-stdin | --client-secret <client secret> \
```

<Expandable title="command flags">
  <ResponseField name="--type / -t" type="string">
    The type of contact center platform to configure. Valid platform type are: <code>genesys</code>, <code>five9</code>, or <code>twilio</code>.
  </ResponseField>

  <ResponseField name="--name / -n" type="string">
    The name of the contact center connection you wish to create or update. This value identifies the connection together with a platform‑specific suffix.
  </ResponseField>

  <ResponseField name="--client-id" type="string">
    The <code>client\_id</code> used to authenticate with the selected platform.
  </ResponseField>

  <ResponseField name="--client-secret" type="string">
    The <code>client\_secret</code> used for authentication. Prefer using <code>--client-secret-stdin</code> for improved security.
  </ResponseField>

  <ResponseField name="--client-secret-stdin" type="string|stdin">
    Read the <code>client\_secret</code> from standard input for secure, non‑echoed entry such as a piped or prompted input. When provided, this option takes precedence over <code>--client-secret</code>.
  </ResponseField>

  <ResponseField name="--endpoint" type="string">
    The authentication or API endpoint for the platform, such as a base URL or token endpoint, when you need to use a value different from the default.
  </ResponseField>
</Expandable>

<Note>
  **Note:**

  The connection name you specify configures the watsonx Orchestrate Agent Assist dashboard and determines which Customer Care platform instance the dashboard uses during runtime.
</Note>

## Listing Customer Care platform connections

Use this command when you need to view your configured connections.

```bash BASH theme={null}
orchestrate customer-care platform list
```

<Expandable title="command flags">
  <ResponseField name="--type / -t" type="string">
    Optional filter for the list of configured contact center platform connections based on platform type.\
    If not defined, the command lists all configured connections.
  </ResponseField>
</Expandable>

## Deleting a Customer Care platform connection

Use this command when you need to remove a connection you no longer use.

```bash BASH theme={null}
orchestrate customer-care platform remove <connection unique name>
```

<Expandable title="command flags">
  <ResponseField name="--name / -n" type="string">
    The name of the contact center connection to remove. You can provide the full connection ID or a prefix. If you provide a prefix, the command removes the matching connection.
  </ResponseField>

  <ResponseField name="--type / -t" type="enum | optional">
    Optional platform type to remove.\
    When used together with <code>--name</code>, the command removes the connection that matches both values.
  </ResponseField>
</Expandable>
