AskAIsResumen de la integración
Las formas de conectar AskAIs hoy: tu sitio web, tu app, Telegram y clientes de IA.
Los nombres técnicos como
window.SingChatforman parte del widget y de la API. Mantenlos tal cual en tu código.
AskAIs es un servicio alojado: tu espacio de trabajo, tu bandeja de entrada, tu agente de IA y tu base de conocimientos están en askais.com. Conectas a tus clientes con él de las formas que se indican abajo, y todas las conversaciones llegan a la misma bandeja de entrada compartida, donde las responde el mismo agente de IA con el mismo conocimiento y la misma configuración.
Formas de conectar
| Dónde | Cómo se conecta | Actualizaciones |
|---|---|---|
| Tu sitio web | Una etiqueta <script> | No hace falta: cada carga de página obtiene el widget actual |
| Tu app de iOS, Android, Flutter, React Native o de escritorio | Un WebView que abre tu página de chat | No hace falta: el WebView carga el widget actual |
| Telegram | Un token de bot en Configuración → Channels | No hace falta |
| Claude Code, Cursor o Gemini CLI (para tu equipo) | El servidor MCP, con una clave MCP | No hace falta |
Tu sitio web
Añade esto antes de </body>. Copia tu App ID de Configuración → Bandejas de entrada; es público y puedes publicarlo sin riesgo.
<script src="https://askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://askais.com"
async></script>⚠️ Carga widget.js desde askais.com
No descargues widget.js ni lo incluyas en tu propio código. Cargado desde askais.com, siempre ejecuta la versión actual; una copia se queda congelada y se pierde todas las correcciones y funciones nuevas.
Apps móviles y de escritorio
No hay ningún SDK que instalar. Abre https://askais.com/api/widget-embed?appId=YOUR_APP_ID en un WebView y tu app mostrará el mismo chat que tu sitio web, a pantalla completa. Añade a la URL el ID, el correo y el nombre del usuario con sesión iniciada para que tu equipo sepa con quién habla. La página «Chat dentro de la app» tiene la guía completa, con código para Flutter, iOS, Android y JavaScript.
Visitantes con sesión iniciada e identidad verificada
Para los usuarios con sesión iniciada, pasa externalId, email y name para que sus chats los sigan de un dispositivo a otro. Para que nadie pueda hacerse pasar por otro usuario, pasa también hmac: un HMAC-SHA256 del externalId, calculado en tu servidor con la clave secreta de la bandeja de entrada como clave. La página «Widget web» explica cómo hacerlo.
Telegram
Crea un bot con @BotFather, pega su token en Configuración → Channels y conéctalo. Los mensajes al bot llegan a la misma bandeja de entrada, donde los responden el agente de IA y tu equipo.
Clientes de IA (MCP)
El servidor MCP permite que Claude Code, Cursor o Gemini CLI trabajen en tu espacio de trabajo: leer y responder conversaciones, entrenar a la IA, editar las FAQ y consultar las analíticas. Es para ti y tu equipo, no para tus clientes. La clave MCP la crea un propietario o un administrador del espacio de trabajo.
No disponible por ahora
- Paquetes de SDK instalables (npm, pub.dev, CocoaPods, Gradle). Usa la etiqueta script en la web y la página WebView en las apps.
- Una API REST pública para tu propio backend. Las claves de API solo las acepta el servidor MCP.
- Webhooks para eventos de conversaciones o mensajes. En Configuración → Webhooks puedes guardar un endpoint y enviar un ping de prueba firmado, pero todavía no se envía ningún evento.
- Métodos de JavaScript para abrir, cerrar o escuchar el widget.
window.SingChat.start()es el único método que ofrece el script.