# SoluCX

### Overview

### Requirements

To enable the integration, Birdie needs the following from your SoluCX environment:

* **Public API base URL** (Public API endpoint)
* **Instance token** (`x-solucx-api-key`)
* **User token** (`x-solucx-user-token`)

SoluCX’s Public API authentication requires these tokens to be sent in the request headers.

### Setup in SoluCX

#### 1) Identify the Public API base URL

SoluCX documents the Public API endpoints as:

* Public API endpoint: `https://api.solucx.com.br/public`
* Public API endpoint (V2 route): `https://public-api.gke-prd.solucx.com.br`

Use the endpoint that applies to your SoluCX environment.

#### 2) Obtain the required tokens

SoluCX’s official documentation defines the required authentication headers:

* `x-solucx-api-key`: Instance token
* `x-solucx-user-token`: User token

The public documentation does not include step-by-step UI instructions for generating these tokens. To obtain them, request the following from your **SoluCX administrator** or **SoluCX support/CS team**:

1. Your **instance token** (`x-solucx-api-key`)
2. A **user token** (`x-solucx-user-token`) for the user that will be used by the integration
3. Confirmation of which **Public API base URL** to use (standard vs V2 route)

Reference docs:

* [https://docs.solucx.com.br/en/integrations/solucx-api](https://docs.solucx.com.br/en/integrations/solucx-api?utm_source=chatgpt.com)
* [https://docs.solucx.com.br/integrations/solucx-api](https://docs.solucx.com.br/integrations/solucx-api?utm_source=chatgpt.com)

### Connect to Birdie

Share the following with the Birdie team:

* Public API base URL
* `x-solucx-api-key` (instance token)
* `x-solucx-user-token` (user token)

Once received, Birdie will configure and validate the integration.

### References

* SoluCX API (English): [https://docs.solucx.com.br/en/integrations/solucx-api](https://docs.solucx.com.br/en/integrations/solucx-api?utm_source=chatgpt.com)
* SoluCX API (Portuguese): [https://docs.solucx.com.br/integrations/solucx-api](https://docs.solucx.com.br/integrations/solucx-api?utm_source=chatgpt.com)