AskAIsVisão geral da integração
As formas de conectar o AskAIs hoje: seu site, seu app, o Telegram e clientes de IA.
Nomes técnicos como
window.SingChatfazem parte do widget e da API. Mantenha-os exatamente como estão no seu código.
O AskAIs é um serviço hospedado: seu espaço de trabalho, sua caixa de entrada, seu agente de IA e sua base de conhecimento ficam em askais.com. Você conecta seus clientes a ele das formas abaixo, e todas as conversas chegam à mesma caixa de entrada compartilhada, onde são respondidas pelo mesmo agente de IA, com o mesmo conhecimento e as mesmas configurações.
Formas de conectar
| Onde | Como conectar | Atualizações |
|---|---|---|
| Seu site | Uma tag <script> | Nenhuma: cada carregamento de página recebe o widget atual |
| Seu app iOS, Android, Flutter, React Native ou desktop | Uma WebView que abre sua página de chat | Nenhuma: a WebView carrega o widget atual |
| Telegram | Um token de bot em Configurações → Channels | Nenhuma |
| Claude Code, Cursor ou Gemini CLI (para a sua equipe) | O servidor MCP, com uma chave MCP | Nenhuma |
Seu site
Adicione isto antes de </body>. Copie seu App ID em Configurações → Caixas de entrada; ele é público e pode ir para produção com segurança.
<script src="https://askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://askais.com"
async></script>⚠️ Carregue o widget.js a partir de askais.com
Não baixe o widget.js nem o inclua no seu próprio código. Carregado a partir de askais.com, ele sempre roda a versão atual; uma cópia fica congelada e perde todas as correções e novos recursos.
Apps móveis e desktop
Não há SDK para instalar. Abra https://askais.com/api/widget-embed?appId=YOUR_APP_ID em uma WebView e seu app mostra o mesmo chat do seu site, em tela cheia. Adicione à URL o ID, o e-mail e o nome do usuário logado para que sua equipe saiba com quem está falando. A página Chat no app tem o guia completo, com código para Flutter, iOS, Android e JavaScript.
Visitantes logados e identidade verificada
Para usuários logados, passe externalId, email e name para que as conversas os acompanhem entre dispositivos. Para impedir que alguém se passe por outro usuário, passe também hmac: um HMAC-SHA256 do externalId, calculado no seu servidor usando como chave a chave secreta da caixa de entrada. A página Widget web mostra como.
Telegram
Crie um bot com o @BotFather, cole o token dele em Configurações → Channels e conecte. As mensagens enviadas ao bot chegam à mesma caixa de entrada, onde o agente de IA e sua equipe respondem.
Clientes de IA (MCP)
O servidor MCP permite que o Claude Code, o Cursor ou o Gemini CLI trabalhem no seu espaço de trabalho: ler e responder conversas, treinar a IA, editar o FAQ e ver análises. Ele é para você e sua equipe, não para seus clientes. Um proprietário ou administrador do espaço de trabalho cria a chave MCP.
Não disponível no momento
- Pacotes de SDK instaláveis (npm, pub.dev, CocoaPods, Gradle). Use a tag script na web e a página WebView nos apps.
- Uma API REST pública para o seu próprio backend. Chaves de API são aceitas apenas pelo servidor MCP.
- Webhooks para eventos de conversa ou de mensagem. Em Configurações → Webhooks é possível salvar um endpoint e enviar um ping de teste assinado, mas nenhum evento é entregue ainda.
- Métodos JavaScript para abrir, fechar ou escutar eventos do widget.
window.SingChat.start()é o único método que o script oferece.