Visão geral
A Conversa Labs 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
- Gere um token de acesso nas configurações do seu perfil/conta.
- Faça chamadas à API REST autenticando com o token.
- Configure webhooks para receber eventos no seu endpoint.
- Use Custom Scripts para personalizar o dashboard, o portal e o widget.
- 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.