Documentación API
Integra Kotkot con tus sistemas y flujos de trabajo existentes mediante nuestra API RESTful.
REST API
API RESTful completa para gestionar conversaciones, cotizaciones, clientes y más.
Webhooks
Recibe notificaciones en tiempo real sobre eventos importantes en tu cuenta.
Autenticación
Autenticación segura mediante API keys con permisos granulares.
Rate Limiting
Límites justos de rate limiting para garantizar disponibilidad para todos.
Quick Start
# Instalación
npm install @kotkot/sdk
# Configuración
import Kotkot from '@kotkot/sdk';
const client = new Kotkot({
apiKey: 'tu_api_key',
environment: 'production', // o 'sandbox'
});
# Ejemplo: Listar conversaciones
const conversations = await client.conversations.list({
limit: 10,
status: 'active',
});
# Ejemplo: Crear una cotización
const quote = await client.quotes.create({
clientId: 'cli_123',
productType: 'auto',
coverageAmount: 25000,
duration: 12,
});
Autenticación Requerida
Para usar la API, necesitas un API key. Puedes generar una desde tu dashboard en Configuración → API Keys.
Endpoints Disponibles
Conversaciones
Gestiona conversaciones de WhatsApp
/api/v1/conversationsListar conversaciones/api/v1/conversations/:idObtener conversación/api/v1/conversationsCrear conversación/api/v1/conversations/:idActualizar conversación
Cotizaciones
Gestiona cotizaciones de seguros
/api/v1/quotesListar cotizaciones/api/v1/quotes/:idObtener cotización/api/v1/quotesCrear cotización/api/v1/quotes/:idActualizar cotización
Clientes
Gestiona tu base de clientes
/api/v1/clientsListar clientes/api/v1/clients/:idObtener cliente/api/v1/clientsCrear cliente/api/v1/clients/:idActualizar cliente/api/v1/clients/:idEliminar clienteWebhooks
Configura webhooks para eventos
/api/v1/webhooksListar webhooks/api/v1/webhooksCrear webhook/api/v1/webhooks/:idEliminar webhookDocumentación Completa
Esta página es un resumen de la API. Para documentación completa con todos los parámetros, respuestas, códigos de error y ejemplos, visita nuestra documentación interactiva.