Saltar para o conteúdo
Navegar na documentação

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 Chave

Atendimento

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.

POST/chat/widgets

Cria ou devolve o primeiro widget da conta.

namestringopcional

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.