Overview
Conversa Labs 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
- Generate an access token in your profile/account settings.
- Call the REST API authenticating with the token.
- Configure webhooks to receive events at your endpoint.
- Use Custom Scripts to customize the dashboard, the portal and the widget.
- 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.