Visión general
Conversa Labs ofrece una API REST, herramientas MCP para agentes gobernados, webhooks en tiempo real, un SDK de Dashboard Apps para contexto incrustado seguro, un SDK de Custom Scripts para extender interfaces y eventos por módulo para reaccionar a cambios.
Requisitos previos
- Una cuenta con permiso para generar tokens de API.
- Conocimientos básicos de HTTP/JSON.
Paso a paso
- Genera un token de acceso en la configuración de tu perfil/cuenta.
- Llama a la API REST autenticando con el token.
- Configura webhooks para recibir eventos en tu endpoint.
- Usa Custom Scripts para personalizar el dashboard, el portal y el widget.
- Usa el SDK V2 de Dashboard Apps para una app incrustada limitada y REST o MCP para administrar sus instalaciones nativas.
Configuración y opciones
- Tokens: por usuario/cuenta, con alcance de acceso.
- Webhooks: suscripción a eventos por bandeja/cuenta.
- Custom Scripts: JS/CSS inyectados en las superficies compatibles.
- Dashboard Apps: puente versionado de contexto de solo lectura; escrituras en REST/MCP.
Casos de uso
- Sincronizar contactos y conversaciones con un CRM externo.
- Disparar automatizaciones en tu sistema cuando algo cambia en la plataforma.
Consejos, límites y buenas prácticas
- Trata los tokens como secretos; nunca los expongas en el front-end.
- Respeta los límites de tasa y maneja errores/reintentos.
Solución de problemas
- 401/403: verifica el token y los permisos.
- El webhook no llega: revisa la URL, el estado del endpoint y la firma.