Guías

SDK

Un único SDK publicado, el widget de Flutter, más una API REST y una especificación OpenAPI que puedes llamar desde cualquier lenguaje.

AskAIs adopta un enfoque de protocolo primero: una única especificación OpenAPI 3.1, un único protocolo WebSocket y webhooks firmados con HMAC. Puedes llamar a la API desde cualquier lenguaje y renderizar tu propia interfaz. Hoy publicamos un único SDK de interfaz empaquetado, el widget de Flutter nativo.

El SDK publicado: el widget de Flutter

El único SDK que entregamos hoy está en sdks/flutter-widget/. Es una interfaz de chat completa y personalizable que se comunica por ti con la API REST y el WebSocket. Agrégalo a tu pubspec.yaml como un paquete local:

# pubspec.yaml
dependencies:
  singchat_widget:
    path: ../sdks/flutter-widget

iOS y Android

No hay un SDK nativo aparte para iOS o Android. Se admiten dos rutas:

WebView (recomendado), carga el widget Web desde /api/widget-embed. Es el widget completo y se actualiza automáticamente, así que nunca tienes que publicar una versión de la aplicación solo para obtener nuevas funciones de chat.
API REST, llama a la API directamente y renderiza tu propia interfaz nativa.

No hay vistas de chat listas para usar en SwiftUI ni en Jetpack Compose. O bien incrustas el WebView o construyes la interfaz tú mismo sobre la API.

Cualquier otro lenguaje: llama a la API REST

No ofrecemos clientes precompilados para Python, Go, Rust, C#, Java, PHP, Ruby o similares, y no hay SDK oficiales de React Native, Unity ni Unreal. En su lugar, hay una API REST pública con una especificación OpenAPI 3.1, que puedes llamar por HTTP puro o para la que generar tu propio cliente:

OpenAPI: GET /api/v1/openapi.json
WebSocket: consulta la documentación del widget Web para el JSON de eventos

Genera un cliente para el lenguaje que quieras con openapi-generator:

# generate a client from the public spec
npx @openapitools/openapi-generator-cli generate \
  -i https://singchat.org/api/v1/openapi.json \
  -g python \
  -o ./singchat-client

Lo que ofrece AskAIs

Más allá del widget, estas capacidades del producto están disponibles hoy:

Bandeja de entrada unificada en el widget Web, Telegram y WhatsApp, con un espacio para X (Twitter) listo.
IA alojada en la plataforma: sin necesidad de clave de API, facturación por token con recarga automática y respaldo humano, o usa tu propia clave.
Centro de Entrenamiento de IA: rastrea tu sitio, sube archivos PDF, Word o DOCX, agrega pares de preguntas y respuestas desde un CSV y ensaya en un Playground antes del lanzamiento.
Centro de ayuda en 50 idiomas para artículos de autoservicio y preguntas frecuentes.
Marca blanca completa en todas las superficies de cara al cliente.
Entrega multidominio antibloqueo para el widget.

Ejemplos rápidos

Flutter widget

import 'package:singchat_widget/singchat_widget.dart';

// mount the themeable chat UI
SingChatWidget(
  appId: 'ws_abc123',
  user: SingChatUser(
    externalId: 'user_42',
    email: 'ada@example.com',
  ),
)

iOS WebView

import WebKit

let webView = WKWebView(frame: view.bounds)
let url = URL(string: "https://singchat.org/api/widget-embed?appId=ws_abc123")!
webView.load(URLRequest(url: url))
view.addSubview(webView)

Android WebView

val webView = WebView(this)
webView.settings.javaScriptEnabled = true
webView.loadUrl("https://singchat.org/api/widget-embed?appId=ws_abc123")
setContentView(webView)

curl puro

# identify against the REST API (any language, no library)
curl https://singchat.org/api/v1/auth/identify \
  -H "Content-Type: application/json" \
  -d '{ "appId": "ws_abc123", "email": "ada@example.com" }'

AnteriorAutoalojamiento con Docker SiguienteSDK para móviles