Integration overview

AskAIs es un único backend con muchas formas de conectar. 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. Tus clientes también pueden escribirte por canales de entrada como Telegram y WhatsApp. Cada cliente y canal 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

¿Funcionan juntos todos los clientes y canales?

Sí. Son distintas puertas de entrada al mismo workspace de AskAIs, 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.
• No solo integraciones, también canales de entrada: además del widget en la web y en la app, tus clientes pueden escribirte por Telegram y WhatsApp (ambos operativos de extremo a extremo), y cada mensaje llega a la misma bandeja de entrada; hay un espacio para X listo.
• Configuración compartida: tu agente de IA (alojado por la plataforma o con tu propia clave), 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://singchat.org/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://singchat.org"
        async></script>

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

Carga siempre el widget desde https://singchat.org/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 singchat.org, 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: SDK de Flutter o embed en WebView

En móvil tienes tres opciones reales. Primero, el SDK nativo del widget de Flutter ofrece una interfaz de chat completa y personalizable (burbuja flotante y pantalla de chat nativa, no una WebView); agrégalo a tu pubspec y publica. Segundo, en iOS y Android (y React Native) puedes integrar el widget web completo dentro de una WebView, la misma experiencia que en el sitio, y se mantiene actualizado por sí solo. Tercero, usa la REST API con webhooks firmados y renderiza tu propia interfaz. No hay un SDK de chat nativo aparte para iOS, Android o React Native que instalar; estas son las vías admitidas.

# Flutter, native chat widget (floating bubble + native chat UI, not a WebView).
# In your app's pubspec.yaml (download and unzip the SDK package first):
dependencies:
  singchat_widget:
    path: ../singchat_widget

# iOS / Android / React Native without Flutter: load the hosted web widget in a
# WKWebView / WebView (same experience as the website), or drive the REST API
# with signed webhooks and render your own chat UI.

Cualquier backend o lenguaje

No se requiere SDK: llama directamente a la REST API para identificar un contacto y enviar o recibir mensajes, y verifica los eventos de entrada con webhooks firmados. Toda la API sigue una especificación OpenAPI publicada, así que puedes generar un cliente en tu propio lenguaje o simplemente llamar a los endpoints directamente.

# Any backend / language, talk to the REST API directly
curl -X POST https://singchat.org/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)
• Móvil: SDK de Flutter y embed en WebView
• SDK y la especificación OpenAPI
• Referencia de la REST API