## Visão geral

A ConversaLabs oferece **API REST**, ferramentas **MCP** para agentes governados, **webhooks** em tempo
real, um **SDK de Dashboard Apps** para contexto incorporado seguro, um **SDK de Custom Scripts** para
estender as interfaces e **eventos por módulo** para reagir a mudanças.

## Pré-requisitos

- Conta com permissão para gerar tokens de API.
- Conhecimento básico de HTTP/JSON.

## Passo a passo

1. Gere um **token de acesso** nas configurações do seu perfil/conta.
2. Faça chamadas à API REST autenticando com o token.
3. Configure **webhooks** para receber eventos no seu endpoint.
4. Use Custom Scripts para personalizar o dashboard, o portal e o widget.
5. Use o SDK V2 de Dashboard Apps para um app incorporado limitado e REST ou MCP para administrar
   suas instalações nativas.

## Configurações & opções

- **Tokens**: por usuário/conta, com escopo de acesso.
- **Webhooks**: assinatura de eventos por inbox/conta.
- **Custom Scripts**: JS/CSS injetados nas superfícies suportadas.
- **Dashboard Apps**: ponte versionada de contexto somente leitura; escritas ficam no REST/MCP.

## Casos de uso

- Sincronizar contatos e conversas com um CRM externo.
- Disparar automações no seu sistema quando algo muda na plataforma.

## Dicas, limites e boas práticas

- Trate tokens como segredos; nunca os exponha no front-end.
- Respeite limites de taxa e trate erros/retentativas.

## Solução de problemas

- **401/403**: verifique o token e as permissões.
- **Webhook não chega**: confira a URL, o status do endpoint e a assinatura.

## Veja também

- [SDK, API REST e MCP de Dashboard Apps](/hc/ajuda/articles/api-developers-dashboard-apps-sdk-rest-mcp-pt-br)
- [API REST, tokens e webhooks](/hc/ajuda/articles/api-developers-rest-tokens-webhooks-pt-br)
- [SDK de Custom Scripts](/hc/ajuda/articles/api-developers-custom-scripts-sdk-pt-br)
- [Referência de API (Swagger / OpenAPI)](/hc/ajuda/articles/api-developers-swagger-reference-pt-br)