Cria uma sessão anônima

POST

/widget/{token}/session

Cria a sessão do visitante e devolve o session_token, que deve ser persistido no
dispositivo e enviado nas demais rotas.

Limitado por IP (padrão 10/hora, ajustável em settings.rate_limits.sessions_per_hour).
Nenhum contato é criado aqui — o contato só nasce na primeira mensagem enviada.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/json

Exemplo

{
    "user_agent": "MeuApp/1.0 (iOS 17)"
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://titov.com.br/widget//session' \
--header 'Content-Type: application/json' \
--data '{
    "user_agent": "MeuApp/1.0 (iOS 17)"
}'

Respostas

🟢201Criado

application/json

Sessão criada

Bodyapplication/json

Exemplo

{
    "session_token": "3f2a1c8e-7b4d-4f9a-9c2e-1d8b6a5f0e33"
}

🟠403Proibido

🟠429

Modificado em 2026-07-17 11:20:51

Página anterior

Widget de Chat — Guia de Implementação (Web e App Mobile)

Próxima página

Histórico da sessão