## Overview

ConversaLabs offers a **REST API**, **MCP** tools for governed agents, **webhooks** for real-time events,
a **Dashboard Apps SDK** for secure embedded context, a **Custom Scripts SDK** to extend interfaces,
and **per-module events** to react to changes.

## Prerequisites

- An account with permission to generate API tokens.
- Basic HTTP/JSON knowledge.

## Step by step

1. Generate an **access token** in your profile/account settings.
2. Call the REST API authenticating with the token.
3. Configure **webhooks** to receive events at your endpoint.
4. Use Custom Scripts to customize the dashboard, the portal and the widget.
5. Use the V2 Dashboard Apps SDK for a bounded embedded app, and REST or MCP to administer its native
   installations.

## Settings & options

- **Tokens**: per user/account, with access scope.
- **Webhooks**: subscribe to events per inbox/account.
- **Custom Scripts**: JS/CSS injected into the supported surfaces.
- **Dashboard Apps**: a versioned read-only context bridge; configuration writes stay in REST/MCP.

## Use cases

- Sync contacts and conversations with an external CRM.
- Trigger automations in your system when something changes on the platform.

## Tips, limits & best practices

- Treat tokens as secrets; never expose them in the front-end.
- Respect rate limits and handle errors/retries.

## Troubleshooting

- **401/403**: check the token and permissions.
- **Webhook not arriving**: verify the URL, the endpoint status and the signature.

## See also

- [Dashboard Apps SDK, REST API and MCP](/hc/ajuda/articles/api-developers-dashboard-apps-sdk-rest-mcp-en)
- [REST API, tokens and webhooks](/hc/ajuda/articles/api-developers-rest-tokens-webhooks-en)
- [Custom Scripts SDK](/hc/ajuda/articles/api-developers-custom-scripts-sdk-en)
- [API reference (Swagger / OpenAPI)](/hc/ajuda/articles/api-developers-swagger-reference-en)