Referência API
KambaChat
Widget e conversas
Já tens uma chave? Personaliza os exemplos temporariamente
Opcional. A chave ficará visível nos exemplos de código. Fica apenas na memória desta página: sem guardar nem enviar. Limpa-a antes de partilhar o ecrã ou capturas.
Os exemplos usam valores ilustrativos. Para enviar, cria uma conta e uma chave API e aguarda a aprovação do Sender ID.
$ Gerar ChaveAtendimento
KambaChat
O dashboard gere o widget e a caixa de entrada. O browser do visitante usa um token temporário próprio e nunca recebe a chave API da conta.
Cria ou devolve o primeiro widget da conta.
Nome apresentado no cabeçalho do widget
curl -X POST https://api.kambasms.ao/chat/widgets \
-H "X-API-Key: SUA_API_KEY" -H "Content-Type: application/json" \
-d '{"name":"Atendimento"}'Conta autenticada: GET/PATCH /chat/widgets, GET /chat/conversations, GET/POST /chat/conversations/:id/messages e PATCH /chat/conversations/:id.
Estados: open, in_progress, closed. responsible_name é uma identificação interna e não concede acesso. GET/POST /chat/conversations/:id/notes guarda notas privadas (50 por conversa, 90 dias); as notas nunca são devolvidas ao visitante. GET /chat/conversations/:id/contact-history devolve até 20 conversas do mesmo contacto no mesmo widget.
Instalação pública:GET /chat/widget.js?key=.... Os endpoints /chat/public são utilizados internamente pelo widget.