Integration overview

O AskAIs Customer Service é um único backend com vários SDKs de cliente. 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. Todos os clientes se comunicam 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 SDKs são compatíveis?

Sim. Eles são portas de entrada diferentes para o mesmo workspace do AskAIs Customer Service, 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.
• Configuração compartilhada: seu agente de IA, 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://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"
        async></script>

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

Sempre carregue o widget a partir de https://cs.askais.com/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 cs.askais.com, 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 (iOS / Android / Flutter / React Native)

Os SDKs nativos são compilados no seu app, portanto não se atualizam automaticamente como o widget web. Para obter uma nova versão, aumente a versão do SDK no seu gerenciador de pacotes e publique um novo build do app. A inicialização segue a mesma ideia em todos os lugares — aponte para https://cs.askais.com e identifique com seu 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"))

Qualquer backend ou linguagem

Nenhum SDK necessário — chame a REST API diretamente para identificar um contato e enviar/receber mensagens. Também publicamos SDKs gerados a partir da nossa especificação OpenAPI para mais de 30+ linguagens.

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

Aprofunde-se

• Widget web — referência completa (eventos, temas, segurança)
• SDKs móveis — iOS, Android, Flutter, React Native
• Todos os SDKs e geração de código
• Referência da REST API