# Simple Integration Service Endpoint (SISE)

Un SISE está diseñado para ser usado a través de un Agente de IA de Induxsoft, por lo que espera como carga útil la estructura que define el [protocolo de integración](https://docs.induxsoft.net/es/iae/agentes/protocolo-integracion.md#invocacion-de-herramienta-externa) para la invocación de herramienta externa.

**Autenticación**

El endpoint requiere un **token personalizado**, configurado en el catálogo de **"Integración, puntos finales"** del sitio V12.

**Estructura de invocación**

El SISE espera la estructura estándar de invocación de herramienta externa:

Ejemplo del payload:

```json
{
    ...SISE
    "data": {
        ...
    }
}
```

---

## Crear notificación programada

### Descripción

Este SISE permite programar el envío de notificaciones a destinatarios externos en una fecha y hora futura.

Está diseñado para ser invocado por agentes de IA mediante el protocolo de herramientas externas de Induxsoft.

- Soporta múltiples canales (email, WhatsApp, etc.)
- Utiliza plantillas configuradas
- Permite parámetros dinámicos por notificación

### Solicitud

- **Punto final:** `/!/sise/scheduled-notification/`
- **Método:** `POST`
- **Authorization:** `cadena configurada tal cual`

#### Campos esperados (`data`)

| Campo             | Tipo   | Requerido | Descripción                                  |
| ----------------- | ------ | --------- | -------------------------------------------- |
| `notif_type`      | string | Sí        | Nombre o `sys_guid` del tipo de notificación |
| `scheduled_for`   | string | Sí        | Fecha y hora (`yyyy-MM-dd H:mm`)             |
| `recipient_name`  | string | Sí        | Nombre del destinatario                      |
| `recipient_email` | string | No*       | Correo del destinatario                      |
| `recipient_phone` | string | No*       | Teléfono del destinatario                    |
| `params`          | object | No        | Variables dinámicas del tipo                 |
| `detsrc`          | string | No        | Tipo de origen (ej. `DET014`)                |
| `srcid`           | number | No        | ID del registro origen                       |
| `tag`             | string | No        | Etiqueta libre                               |

**Nota**

- `notif_type` debe existir y estar activo.
- `scheduled_for` debe ser una fecha válida futura.
- `recipient_email` y `recipient_phone` son opcionales individualmente pero al menos uno debe enviarse.
- `recipient_phone` Número de teléfono precedido del código de país e indicador de número móvil, ej: +52 1 123 456 7890.
- `params` debe cumplir con las variables definidas en el tipo.

##### Ejemplos

Recordatorio de pago (WhatsApp):

```json
{
  "data": {
    "notif_type": "Recordatorio de pago",
    "scheduled_for": "2026-04-10 09:00",
    "recipient_name": "Juan Pérez",
    "recipient_phone": "+525512345678",
    "params": {
      "concept": "Factura #F-2026-0342",
      "due_date": "2026-04-12"
    },
    "detsrc": "DET014",
    "srcid": 87
  }
}
```
Seguimiento a prospecto (Email):

```json
{
  "data": {
    "notif_type": "Seguimiento prospecto",
    "scheduled_for": "2026-04-15 10:30",
    "recipient_name": "Acme Corp",
    "recipient_email": "contacto@acme.com",
    "params": {
      "concept": "Llamada de seguimiento",
      "message": "Revisar propuesta enviada"
    }
  }
}
```

### Respuesta

**Respuesta exitosa**

```text
Notificación programada exitosamente (id: 9feaf18326674df1950dd71c27f9eb53) para el 2026-04-10 a las 09:00.
```

**Respuesta fallida**

```text
No fue posible programar la notificación: {detalle}
```

## Cancelar notificación programada

### Solicitud

- **Punto final:** `/!/sise/scheduled-notification-cancel/`
- **Método:** `POST`
- **Authorization:** `cadena configurada tal cual`

#### Campos esperados (`data`)

| Campo      | Tipo   | Requerido | Descripción                   |
| ---------- | ------ | --------- | ----------------------------- |
| `notif_id` | string | Sí        | `sys_guid` de la notificación |

**Nota**

- Solo puede cancelar eventos pendientes.

##### Ejemplo

```json
{
  "data": {
    "notif_id": "9feaf18326674df1950dd71c27f9eb53"
  }
}
```

### Respuesta

**Respuesta exitosa**

```text
La notificación (id: 9feaf18326674df1950dd71c27f9eb53) ha sido cancelada exitosamente.
```

**Respuesta fallida**

```text
No fue posible cancelar la notificación: {detalle}
```

## Integración con Agentes IA de Induxsoft

### Programar notificación

El agente debe recolectar:

- Tipo de notificación
- Fecha y hora
- Destinatario
- Variables dinámicas (params)

### Cancelar notificación

Recolectar:

- `notif_id`