### Simple Integration service endpoint (SISE)

- Punto final: /!/sise/add-event/

Endpoint destinado al registro de eventos en un calendario.

Permite crear nuevas entradas asociadas a una fecha y hora específicas, incluyendo información como descripción y metadatos adicionales. El endpoint valida solapamientos, respeta reglas de disponibilidad y almacena el evento para su posterior consulta.

#### Campos esperados

- *calendar_id -* Identificador de un calendario existente. **Requerido**
- *type -* tipo de evento. **Requerido**
- *caption -* Descripción del evento. **Requerido**
- *start -* Fecha y hora del evento en formato yyyy-MM-dd H:mm. **Requerido**
- *duration -* Duración del evento en minutos.
- *important -* Sí o No (true/false).
- *backcolor -* Color de fondo del evento. (Predeterminado: Color configurado en el tipo de evento)
- *color -* Color de texto del evento. (Predeterminado: Color configurado en el tipo de evento)
- *detsrc -* Un identificador del tipo de elemento de datos o proceso donde se generó el evento (opcional).
- *srcid -* Un identificador numérico (entero) correspondiente a la instancia del tipo de elemento de datos que originó el evento (opcional).
- *tag -* Una cadena con información de propósito general (opcional).
- *data -* Un objeto con datos de propósito general asociados al evento (opcional).
- *response_type -* Si se omite, la respuesta será texto en lenguaje natural, si se establece como "json", la respuesta será estructurada (opcional).
- *suggested_days -* La cantidad de días en el futuro a una fecha solicitada que devolverá disponibilidades si la hora indicada no está libre (opcional, el valor predeterminado es 7)

##### Tipos de eventos

Puede proporcionar tanto el id como el nombre del tipo de evento para `type`.
Los eventos corresponden a la tabla `pim_events_type` de la base de datos v12 usado para la gestión de los calendarios.

(Tipos de eventos predeterminados en la instalación de V12)

- *01cf7e04160f470092bf5469cb15b2c8 -* Llamada.
- *b03cfc4698c742108e9e56283f5ff51a -* Video conferencia.
- *7ccfe477bc31474ca686d123b5d8275a -* Reunión presencial.
- *9e7c5942b2934476ad1f3b03338364b7 -* Visita a domicilio.
- *e7d120f36732461f8c1096401b7a768b -* Reservado.

##### Integración con la plataforma de agentes de Induxsoft

Si no se indican en la solicitud del servicio los campos: detsrc, tag o data. Serán llenados automáticamente 
por los valores provistos por el invocador del agente IA de la siguiente forma:

- detsrc = "ai_chat" (cadena constante)
- tag = Id del agente (agent_id)
- data = La carga útil completa definida en el [protocolo de integración](https://docs.induxsoft.net/es/iae/agentes/protocolo-integracion.md)


#### Retorno

###### Respuesta exitosa

Se ha agregado el evento `{nombre_tipo_evento}` (`event_id:{id del evento}`) al calendario `{nombre_del_calendario}` (`calendar_id:{id_calendario}`) el `{fecha_y_hora}` con una duración prevista de `{minutos}` minutos.

##### Respuesta fallida

No se ha podido agendar el evento `{fecha_y_hora}` porque es un día u horario no laborable o sin disponibilidad.<br>Las siguientes fechas y horarios están disponibles cerca de esa fecha:
- 2025-12-23
    - 13:30
    - 14:00
    - 16:00
    - 17:30
- 2025-12-26
    - 8:00
    - 8:30
...

ó 

No fue posible agendar el evento: ...detalles