Documentação API

Primeiros Passos

A API do sem.chat permite que você gerencie conversas programaticamente, envie mensagens e acesse analytics. All API requests require authentication using an API key.

Base URL

https://api.sem.chat/v1

Autenticação

Inclua sua chave API no header de Authorization de todas as solicitações:

Authorization: Bearer your_api_key_here

Conversas

List Conversas

GET /conversations

Recuperar uma lista de todas as conversas da sua conta.

Parameter	Type	Descrição
limit	integer	Number of results to return (max 100)
offset	integer	Number of results to skip
status	string	Filter by status: active, closed, pending

Get Conversa

GET /conversations/{id}

Recuperar detalhes de uma conversa específica incluindo todas as mensagens.

Create Conversa

POST /conversations

Start a new conversation programmatically.

Messages

Enviar Mensagem

POST /conversations/{id}/messages

Send a message to an existing conversation.

                // Example request body
{
  "content": "Hello, how can I help you today?",
  "sender": "agent"
}
            

Webhooks

Configure webhooks para receber notificações em tempo real sobre eventos de conversas.

Eventoos Disponíveis

Evento	Descrição
conversation.started	Uma nova conversa foi iniciada
message.received	Uma nova mensagem foi recebida de um visitante
conversation.closed	Uma conversa foi encerrada
lead.captured	Contact information was collected

Limites de Taxa

Solicitações API são limitadas para garantir uso justo:

Plano	Rate Limit
Free	100 requests/hour
Pro	1,000 requests/hour
Business	10,000 requests/hour