Guias para desenvolvedores
O Kavchat é um chat de atendimento que responde com base nos scripts que você escreve. Não há modelo de linguagem: o script publicado roda no dispositivo do usuário, por isso as respostas são rápidas, previsíveis e continuam funcionando mesmo sem internet. Aqui você encontra como tudo se conecta e por onde começar.
Como o Kavchat funciona
- Painel. Você e sua equipe acessam app.kavchat.com. Cada espaço de trabalho tem uma chave pública (
pk_live_...) e uma chave secreta (sk_live_...), ambas disponíveis na página Instalação. - Scripts. No editor visual, você monta scripts com etapas. Cada etapa tem uma mensagem, botões e palavras-chave. Um botão leva a outra etapa, outro script, um link, uma tela do seu app ou ao formulário de contato.
- Publicação. Cada publicação é salva como uma versão numerada. Você define quem vê o bot: ninguém, apenas usuários de teste (por número de telefone) ou todos. É possível restaurar uma versão anterior a qualquer momento, sem atualizar o app.
- Widget ou SDK. O site carrega o widget com a chave pública, e o app usa um dos SDKs para dispositivos móveis. Eles baixam a versão publicada, salvam no dispositivo e conduzem a conversa nele.
- Token de identidade (opcional). Quando um usuário está conectado, seu servidor assina um JWT curto com a chave secreta. Assim, o Kavchat associa o identificador do usuário no seu sistema à conversa e ao chamado, e pode exibir um bot restrito a usuários de teste para as pessoas certas.
- Chamados e webhook. Quando o script não resolve o problema, o formulário de contato abre um chamado com a conversa completa. Ele aparece na caixa de entrada de chamados do painel e, no Premium, também é enviado ao seu sistema por um webhook assinado. Seu servidor também pode consultar e encerrar chamados pela Server API.
Duas chaves, dois lugares
| Chave | Onde fica | Para que serve |
|---|---|---|
Chave pública pk_live_... | Nas páginas do site e nos apps. Pode ficar exposta. | Carregar o bot, registrar o andamento da conversa e abrir chamados. |
Chave secreta sk_live_... | Somente no seu servidor. Nunca no navegador ou no app. | Assinar tokens de identidade, verificar webhooks e fazer chamadas à Server API. |
Início rápido
No site, basta esta linha antes de </body>. Copie a linha com sua chave na página Instalação do painel:
<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>Publique um script, libere o bot para todos (ou para os números de telefone dos usuários de teste) e atualize a página.
Guias
Botões e perguntas
Botões curtos e perguntas completas em cada etapa, com busca quando há muitos assuntos.
Widget para sites
Uma linha de código, interface JavaScript opcional, eventos e CSP.
React Native
Provider, tela de chat e botão flutuante. Funciona em qualquer app React Native (a partir da versão 0.72), com ou sem Expo.
Flutter
Controlador, botão flutuante e tela de chat, com suporte integrado a RTL.
iOS
Pacote Swift com componentes SwiftUI e UIKit. Para iOS 15 ou superior.
Android
Componentes Jetpack Compose e Activity para apps Views. Para API 23 ou superior.
Identificar usuários
Assine um token de curta duração no servidor. Exemplos em 7 idiomas.
Webhook
Cada novo chamado chega ao seu sistema, assinado. No Premium.
Server API
Chamados, relatórios, público e versões, direto do seu servidor.
Precisa de ajuda?
Escreva para support@kavchat.com. A API completa está descrita no arquivo openapi.yaml (OpenAPI 3.1).