Integre sem.chat en sus aplicaciones con nuestro potente REST API.
El sem.chat API le permite administrar conversaciones, enviar mensajes y acceder mediante programación. analítica. Todas las API solicitudes requieren autenticación usando una clave API.
https://api.sem.chat/v1 Incluya su clave API en el encabezado de Autorización de todas las solicitudes:
Authorization: Bearer your_api_key_here Recuperar una lista de todas las conversaciones para su cuenta.
| Parámetro | Tipo | Descripción |
|---|---|---|
| límite | entero | Número de resultados a devolver (máximo 100) |
| offset | integer | Número de resultados para omitir |
| estado | cadena | Filtrar por estado: activo, cerrado, pendiente |
Recuperar detalles de una conversación específica, incluidos todos los mensajes.
Iniciar una nueva conversación mediante programación.
Enviar un mensaje a una conversación existente.
// Example request body { "content": "Hello, how can I help you today?", "sender": "agent" } Configure webhooks para recibir notificaciones en tiempo real sobre eventos de conversación.
| Evento | Descripción |
|---|---|
| conversación.iniciada | Se inició una nueva conversación |
| mensaje.recibido | Se recibió un nuevo mensaje de un visitante |
| conversación.cerrada | Se cerró una conversación |
| lead.captured | Se recopiló información de contacto |
API las solicitudes están limitadas para garantizar un uso justo:
| Plan | Calificar Limit |
|---|---|
| Trial | 100 requests/hour |
| Pro | 1,000 requests/hour |
| Business | 10,000 requests/hour |
Usa la referencia de la API para definir solo los datos y permisos necesarios para el flujo concreto. Guarda las credenciales en secretos del servidor, nunca en codigo del navegador, repositorios publicos, capturas o mensajes de soporte. Separa desarrollo y produccion, valida cada entrada, gestiona limites y reintentos con espera gradual y evita registrar contenido sensible. Prueba credenciales caducadas, eventos duplicados, interrupciones de red y una vuelta atras segura. Asigna responsables para la rotacion y los incidentes, revisa el acceso con frecuencia y elimina integraciones o permisos que ya no se utilicen.