Integration overview

O AskAIs é um único backend com muitas formas de conectar. Você configura seu workspace uma vez e, em seguida, incorpora o chat em qualquer lugar, um site, um aplicativo móvel ou qualquer serviço de backend. Seus clientes também podem falar com você por canais de entrada como Telegram e WhatsApp. Cada cliente e canal se comunica com a mesma caixa de entrada, o mesmo agente de IA e a mesma base de conhecimento.

Um backend, todas as plataformas

Seja qual for a plataforma que você usar, a instalação é rápida e a conversa, o contato, as respostas de IA e as configurações são compartilhados. Veja como cada plataforma é instalada e, o mais importante, como ela recebe atualizações futuras:

Plataformas em resumo

Todos os clientes e canais funcionam juntos?

Sim. Eles são portas de entrada diferentes para o mesmo workspace do AskAIs, então são totalmente interoperáveis:

• Mesmo backend, mesmo app-id: cada cliente se conecta à mesma caixa de entrada no seu workspace.
• Um mesmo visitante em vários dispositivos: identifique-o com o mesmo externalId e um chat iniciado na web continua no seu app.
• Não é só incorporação, há também canais de entrada: além do widget na web e no app, seus clientes podem falar com você no Telegram e no WhatsApp (ambos em operação de ponta a ponta), e cada mensagem chega à mesma caixa de entrada; um espaço para o X está pronto.
• Configuração compartilhada: seu agente de IA (hospedado pela plataforma ou com sua própria chave), base de conhecimento, horário comercial, respostas por palavra-chave e FAQs são configurados uma vez e se aplicam a todos os canais.

Web, a incorporação oficial (recomendada)

Insira esta única linha antes de </body>. Essa é toda a instalação. O app-id é público e seguro para publicar; copie-o em Configurações → Caixas de entrada.

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

⚠️ Não baixe nem hospede o widget.js por conta própria

Sempre carregue o widget a partir de https://singchat.org/widget.js. Se você baixar o arquivo e hospedá-lo por conta própria, ou compilá-lo no seu próprio bundle, ele ficará congelado em uma versão, nossas futuras atualizações de estilo, correções de bugs e novos recursos nunca chegarão até você. Carregado de singchat.org, o widget se atualiza automaticamente; você não muda nada.

Controle-o a partir da sua página (opcional)

Depois que o script é carregado, um objeto global window.SingChat fica disponível:

// 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" });

Aplicativos móveis: SDK Flutter ou incorporação em WebView

No mobile, você tem três opções reais. Primeiro, o SDK nativo do widget Flutter oferece uma interface de chat completa e personalizável (bolha flutuante e tela de chat nativa, não uma WebView); adicione-o ao seu pubspec e publique. Segundo, no iOS e no Android (e no React Native), você pode incorporar o widget web completo dentro de uma WebView, a mesma experiência do site, e ele se mantém atualizado sozinho. Terceiro, use a REST API com webhooks assinados e renderize sua própria interface. Não há um SDK de chat nativo separado para iOS, Android ou React Native a instalar; esses são os caminhos suportados.

# 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.

Qualquer backend ou linguagem

Nenhum SDK necessário, chame a REST API diretamente para identificar um contato e enviar ou receber mensagens, e verifique os eventos de entrada com webhooks assinados. Toda a API segue uma especificação OpenAPI publicada, então você pode gerar um cliente na sua própria linguagem ou simplesmente chamar os endpoints diretamente.

# 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"}'

Aprofunde-se

• Widget web, referência completa (eventos, temas, segurança)
• Mobile, SDK Flutter e incorporação em WebView
• SDKs e a especificação OpenAPI
• Referência da REST API