SoluCX

This integration connects Birdie to SoluCX’s Public API so Birdie can import survey-related data from your SoluCX environment.

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/integrations/solucx-api

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

• SoluCX API (Portuguese): https://docs.solucx.com.br/integrations/solucx-api