Documentacion API

Primeros Pasos

La API de sem.chat te permite gestionar conversaciones programáticamente, enviar mensajes y acceder a analíticas. Todas las solicitudes API requieren autenticación usando una clave API.

URL Base

https://api.sem.chat/v1

Autenticación

Incluye tu clave API en el encabezado Autorización de todas las solicitudes:

Autorización: Bearer your_api_key_here

Conversaciones

Listar Conversaciones

GET /conversations

Obtén una lista de todas las conversaciones de tu cuenta.

Parámetro	Tipo	Descripción
limit	integer	Número de resultados a retornar (máx 100)
offset	integer	Número de resultados a omitir
status	string	Filtrar por estado: active, closed, pending

Obtener Conversación

GET /conversations/{id}

Obtén detalles de una conversación específica incluyendo todos los mensajes.

Crear Conversación

POST /conversations

Inicia una nueva conversación programáticamente.

Mensajes

Enviar Mensaje

POST /conversations/{id}/messages

Envía un mensaje a una conversación existente.

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

Webhooks

Configura webhooks para recibir notificaciones en tiempo real sobre eventos de conversación.

Eventos Disponibles

Evento	Descripción
conversation.started	Se ha iniciado una nueva conversación
message.received	Se recibió un nuevo mensaje de un visitante
conversation.closed	Una conversación ha sido cerrada
lead.captured	Se recopiló información de contacto

Límites de Tasa

Las solicitudes API están limitadas para garantizar un uso justo:

Plan	Límite de Tasa
Gratis	100 solicitudes/hora
Pro	1,000 solicitudes/hora
Negocios	10,000 solicitudes/hora