Integration overview

AskAIs Customer Service es un único backend con muchos SDK de cliente. Configuras tu workspace una sola vez y luego integras el chat en cualquier lugar: un sitio web, una app móvil o cualquier servicio de backend. Cada cliente se comunica con la misma bandeja de entrada, el mismo agente de IA y la misma base de conocimiento.

Un backend, todas las plataformas

Sea cual sea la plataforma que uses, la instalación es breve y la conversación, el contacto, las respuestas de IA y la configuración se comparten. Así es como se instala cada plataforma y, lo que es más importante, cómo recibe las actualizaciones futuras:

Plataformas de un vistazo

¿Son compatibles todos los SDK?

Sí. Son distintas puertas de entrada al mismo workspace de AskAIs Customer Service, por lo que son totalmente interoperables:

• Mismo backend, mismo app-id: cada cliente se conecta a la misma bandeja de entrada de tu workspace.
• Un mismo visitante en todos los dispositivos: identifícalo con el mismo externalId y un chat iniciado en la web continúa en tu app.
• Configuración compartida: tu agente de IA, base de conocimiento, horario comercial, respuestas por palabra clave y preguntas frecuentes se configuran una vez y se aplican a todos los canales.

Web: el embed oficial (recomendado)

Coloca esta única línea antes de </body>. Esa es toda la instalación. El app-id es público y seguro de publicar; cópialo desde Settings → Inboxes.

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"
        async></script>

⚠️ No descargues ni alojes widget.js por tu cuenta

Carga siempre el widget desde https://cs.askais.com/widget.js. Si descargas el archivo y lo alojas tú mismo, o lo compilas dentro de tu propio bundle, lo congelas en una sola versión: nuestras futuras actualizaciones de estilo, correcciones de errores y nuevas funciones nunca llegarán a ti. Cargado desde cs.askais.com, el widget se actualiza solo de forma automática; tú no cambias nada.

Contrólalo desde tu página (opcional)

Una vez cargado el script, queda disponible un objeto global window.SingChat:

// Open / close the widget
window.SingChat.open();
window.SingChat.close();

// Identify a logged-in user (so chats follow them across devices)
window.SingChat.identify({ externalId: "user_123", name: "Ada", email: "ada@acme.com" });

Apps móviles (iOS / Android / Flutter / React Native)

Los SDK nativos se compilan dentro de tu app, así que no se actualizan automáticamente como el widget web. Para obtener una nueva versión, sube la versión del SDK en tu gestor de paquetes y publica una nueva compilación de la app. La inicialización sigue la misma idea en todas partes: apunta a https://cs.askais.com e identifícate con tu app-id:

// Swift Package Manager
.package(url: "https://github.com/singlink/singlink-ios", from: "0.1.0")

let client = SingChatClient(baseURL: "https://cs.askais.com")
try await client.identify(.deviceAnonymous(appId: "YOUR_APP_ID"))

Cualquier backend o lenguaje

No se requiere SDK: llama directamente a la REST API para identificar un contacto y enviar o recibir mensajes. También publicamos SDK generados a partir de nuestra especificación OpenAPI para 30+ lenguajes.

# Any backend / language — talk to the REST API directly
curl -X POST https://cs.askais.com/api/v1/auth/identify \
  -H 'Content-Type: application/json' \
  -d '{"appId":"YOUR_APP_ID","externalId":"user_123"}'

Profundiza más

• Widget web: referencia completa (eventos, temas, seguridad)
• SDK móviles: iOS, Android, Flutter, React Native
• Todos los SDK y generación de código
• Referencia de la REST API