1. Mobile
Titov
  • Titov
    • Enviar Mensagens
      • Enviar template HSM
      • Enviar mensagem livre
      • Enviar mídia
    • Contatos
      • Listar contatos
      • Listar conversa do contato
      • Criar contato
      • Atualizar contato
      • Excluir contato
    • Mobile
      • Widget de Chat — Guia de Implementação (Web e App Mobile)
      • Cria uma sessão anônima
        POST
      • Histórico da sessão
        GET
      • Envia mensagem de texto
        POST
      • Envia arquivo (imagem, áudio ou documento)
        POST
      • Stream SSE das respostas em tempo real
        GET
      • Continuar a conversa no WhatsApp
        POST
    • Grupos de Contatos
      • Listar grupos de contatos
      • Criar grupo de contatos
      • Atualizar grupo de contatos
      • Excluir grupo de contatos
    • Respostas Rápidas
      • Listar respostas rápidas
      • Criar resposta rápida
      • Atualizar resposta rápida
      • Excluir resposta rápida
    • Template
      • Listar templates aprovados por número
    • Webhooks
      • Mensagens
        • Mensagem recebida de um contato
        • Mensagem enviada pela plataforma
      • Tickets
        • Ticket de atendimento aberto
        • Ticket de atendimento fechado
      • Contatos
        • Contato criado
        • IA pediu atendimento humano
        • Lead qualificado como quente (score ≥ 70)
        • IA converteu o contato
      • Rádio
        • Áudio de ouvinte aprovado (Rádio)
    • Esquemas
      • Error
      • Contact
      • Envelope
      • HistoryMessage
      • ContactInput
      • ContactRef
      • SseMessage
      • Message
      • MessageEvent
      • PhoneTemplates
      • TicketCreatedEvent
      • ContactGroup
      • TicketClosedEvent
      • ContactGroupInput
      • ContactCreatedEvent
      • CannedReply
      • ContactHelpEvent
      • CannedReplyTextInput
      • ContactHotEvent
      • CannedReplyMediaInput
      • ContactConvertedEvent
      • PaginationLinks
      • RadioAudioEvent
      • PaginationMeta
      • CodedError
      • LegacyError
  1. Mobile

Envia mensagem de texto

POST
/widget/{token}/messages
Envia texto do visitante. Dispara a resposta da IA em background (~2s) — a resposta
chega pelo GET /sse, não no corpo desta chamada.
Na primeira mensagem, o contato é criado automaticamente (canal web_chat).
Limitado a 20/min por sessão (padrão, ajustável em settings.rate_limits.messages_per_minute).

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Exemplo
{
    "session_token": "2fd36934-ce82-489f-960b-a15640ab0c0f",
    "text": "Olá, preciso de ajuda"
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://titov.com.br/widget//messages' \
--header 'Content-Type: application/json' \
--data '{
    "session_token": "2fd36934-ce82-489f-960b-a15640ab0c0f",
    "text": "Olá, preciso de ajuda"
}'

Respostas

🟢201Criado
application/json
Mensagem aceita
Bodyapplication/json

Exemplo
{
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}
🟠401Não Autorizado
🟠403Proibido
🟠422Erro de Parâmetro
🟠429
🔴503Serviço Indisponível
Modificado em 2026-07-17 11:20:51
Página anterior
Histórico da sessão
Próxima página
Envia arquivo (imagem, áudio ou documento)
Built with