Integrations · Quickstart

Get started in 10 minutes

Four steps from `npm install` to first event received.

1. Install the SDK

In your Node.js project, install the official package.

bash
npm install @vaidesk/sdk-node

2. Configure the token

Get a token from your V Ai Desk account (admin panel → tokens) and save it in an environment variable.

bash
VAIDESK_API_KEY=vd_live_a3b1f7e2_...

3. Create your first conversation

Use the SDK to create a conversation on the end-customer side.

typescript
integrations.quickstart.steps.s3.code

4. Configure a webhook

Point a URL in your system to receive events from V Ai Desk. Use the HMAC validation helper.

typescript
integrations.quickstart.steps.s4.code

Done. From here you can explore all REST API endpoints and the complete list of webhook events.

Ready to integrate robust customer support into your product?

Tell us about your case. We get back within one business day.