Documentación API

Beta

Qué puedes hacer hoy con la API de Sice. La referencia completa, con cada campo y ejemplo, se entrega por solicitud mientras la publicamos.

Recursos

Autenticación

Claves que creas en Espacio de trabajo › Conexiones › Claves de API y envías en la cabecera Authorization: Bearer sk_…. Cada clave pertenece al espacio de trabajo en el que la creas y solo llega a sus datos.

Permisos por clave

Cada clave tiene solo los permisos que le das, por recurso y acción: por ejemplo, crear contactos pero no leer tickets. Cada endpoint dice el permiso que pide.

CRM

Crea y actualiza contactos, envía y lee los mensajes de cada contacto, y abre y consulta tickets.

Documentos

Consulta las categorías y los documentos de Recursos, con su contenido. La clave lee todos los documentos del espacio de trabajo, sin mirar quién puede verlos dentro de Sice: dale este permiso sólo a sistemas de confianza.

Agentes de IA

Con Automatizaciones: lista tus agentes, conversa con uno desde tu aplicación y recupera el historial de la conversación.

Sitios web

Tu propio servidor registra lo que solo él sabe (un pago, un registro completado) en los mismos eventos que mide el sitio, y lees el resumen de analítica y las visitas que muestra la app.

Límites y errores

Por defecto, 60 solicitudes por minuto, 1.000 por hora y 10.000 por día por clave; al pasarlas responde 429 con Retry-After. 401 es una clave que falta o no vale; 403, un permiso que la clave no tiene, una IP fuera de su lista o un módulo apagado (los agentes piden Automatizaciones activo).

Webhooks

Cuando tu equipo responde a un contacto desde el CRM, Sice envía ese mensaje a la URL que configures en la clave.

Endpoints

POST/api/crm/contactsPermiso: crm:contacts:createCrear contacto

PATCH/api/crm/contacts/:idPermiso: crm:contacts:updateActualizar contacto

POST/api/crm/contacts/:id/messagesPermiso: crm:messages:sendEnviar mensaje

GET/api/crm/contacts/:id/messagesPermiso: crm:messages:readLeer mensajes

GET/api/crm/ticketsPermiso: crm:tickets:listListar tickets

GET/api/crm/tickets/:idPermiso: crm:tickets:readVer un ticket

POST/api/crm/ticketsPermiso: crm:tickets:createCrear ticket

GET/api/resources/categoriesPermiso: resources:categories:listListar categorías

GET/api/resources/documentsPermiso: resources:documents:listListar documentos

GET/api/resources/documents/:idPermiso: resources:documents:readLeer un documento

GET/api/automations/agentsPermiso: automations:agents:readListar agentes

GET/api/automations/agents/:idPermiso: automations:agents:readVer un agente

POST/api/automations/chatPermiso: automations:chat:sendConversar con un agente

GET/api/automations/chat/historyPermiso: automations:chat:readLeer el historial de la conversación

POST/api/websites/eventsPermiso: websites:events:createRegistrar eventos de un sitio

GET/api/websites/analyticsPermiso: websites:analytics:readLeer la analítica

GET/api/websites/sessionsPermiso: websites:sessions:listListar las visitas

¿Vas a integrar tu sistema con Sice? Escríbenos y te enviamos la referencia completa.

Solicitar acceso a la API