# Grabaciones

# Envio Almacenamiento Externo

Adicionalmente al respaldo de grabaciones en el servidor en la nube, es posible enviarlas a un servidor de almacenamiento externo que el cliente puede ofrecer.

Las grabaciones podran ser enviadas en formato MP3 o WAV stereo con el audio de agente en el canal izquierdo y el audio del cliente en el canal derecho y con METADATA en el nombre del archivo para poder realizar un analisis mas detallado.

FORMATO

(instancia) & (fecha) & (hora) & (origen) & (destino) & (campaña) & (agente) & (tipificacion) & (calidad) & (duracion) & (guid)

clever&20240131&141929&13612393100&3252126294&LOANS\_IN<-&Epineda&Leads&Voicemail&&0&4&d9f25bd0-ab4b-4e01-9ef2-8e4e8361414e.mp3

La definición y orden de los campos es el siguiente delimitado por un amperson (&):

- Nombre de la instancia

- Fecha (YYYMMDD)
- Hora (HHMMSS)
- Origen
- Destino
- Campaña
- Usuario
- Disposición 1
- Disposición 2
- Disposición 3
- Quality (opcional)
- Duracion
- Guid

# Envio de Almacenamiento Externo (WhatsApp)

Adicionalmente al respaldo de conversaciones en el servidor en la nube, es posible enviarlas a un servidor de almacenamiento externo que el cliente puede ofrecer.

Las conversaciones de WhatsApp podrán ser enviadas en formato **JSON**, con un archivo por conversación y con toda la METADATA contenida dentro del archivo para poder realizar un análisis más detallado.

---

### FORMATO

| Aspecto | Definición |
|---|---|
| Formato del archivo | JSON (UTF-8) |
| Unidad de envío | Un archivo = una conversación completa |
| Ruta de depósito | `/whatsapp/YYYYMMDD/` (subcarpeta diaria) |
| Nombre del archivo | `(conversation_id).json` |
| Orden de los mensajes | Cronológico ascendente |
| Versión del esquema | `1.0` |

**Ejemplo de nombre de archivo:**

```
/whatsapp/20240416/0a1aec28-90c7-43af-afaf-91b58ded8baf.json
```

---

### ESTRUCTURA

```json
{
  "schema_version": "1.0",
  "source": "whatsapp_channel",
  "generated_at": "2024-04-16T14:00:00Z",
  "conversation": {
    "conversation_id": "0a1aec28-90c7-43af-afaf-91b58ded8baf",
    "client_id": "5215733215563",
    "agent_name": "Jmartinez",
    "agent_group": "Cobranza WhatsApp",
    "conversation_status": "closed",
    "disposition_1": "Contacto efectivo",
    "disposition_2": "Promesa de pago",
    "disposition_3": "",
    "disposition_4": "",
    "disposition_5": "",
    "messages": [
      {
        "timestamp": "2024-04-16T09:12:00-05:00",
        "content": "Buenos días, quiero saber el saldo de mi cuenta",
        "message_category": "client",
        "message_type": "client_message",
        "agent_name": "",
        "extras": {
          "channel": "whatsapp",
          "attachments_available": false
        }
      },
      {
        "timestamp": "2024-04-16T09:13:20-05:00",
        "content": "Buen día, con gusto le ayudo. Su saldo actual es de $1,250.00",
        "message_category": "agent",
        "message_type": "agent_message",
        "agent_name": "Jmartinez",
        "extras": {
          "channel": "whatsapp",
          "attachments_available": true
        }
      }
    ]
  }
}
```

---

### DEFINICIÓN DE CAMPOS

#### Nivel raíz

- **schema_version** — Versión del esquema de datos. Valor fijo: `1.0`
- **source** — Canal de origen de la conversación. Valor fijo: `whatsapp_channel`
- **generated_at** — Fecha y hora de generación del archivo en formato ISO 8601. Ejemplo: `2024-04-16T14:00:00Z`
- **conversation** — Objeto que contiene la conversación completa. No es un arreglo: cada archivo corresponde a una sola conversación

#### Objeto `conversation`

- **conversation_id** — Identificador único de la conversación de WhatsApp
- **client_id** — Número de teléfono del cliente
- **agent_name** — Nombre del agente que atendió la conversación (tomado del primer mensaje enviado por el agente)
- **agent_group** — Nombre de la cola o campaña a la que pertenece la conversación
- **conversation_status** — Estado o evento final registrado al cierre de la conversación
- **disposition_1** — Tipificación de primer nivel asignada al cierre de la conversación (puede estar vacío)
- **disposition_2** — Tipificación de segundo nivel (puede estar vacío)
- **disposition_3** — Tipificación de tercer nivel (puede estar vacío)
- **messages** — Arreglo con todos los mensajes de la conversación, ordenados cronológicamente de forma ascendente

#### Objeto `messages[]`

- **timestamp** — Fecha y hora del mensaje en formato ISO 8601 con zona horaria. Ejemplo: `2024-04-16T09:12:00-05:00`
- **content** — Cuerpo del mensaje de texto
- **message_category** — Categoría del emisor del mensaje: `client` si fue enviado por el cliente, `agent` si fue enviado por el agente
- **message_type** — Tipo de mensaje: `client_message` si fue enviado por el cliente, `agent_message` si fue enviado por el agente
- **agent_name** — Nombre del agente asociado al mensaje (puede estar vacío en mensajes del cliente)
- **extras** — Objeto con metadatos adicionales del mensaje

#### Objeto `messages[].extras`

- **channel** — Canal de la conversación. Valor fijo: `whatsapp`
- **attachments_available** — Indica si el mensaje incluye archivos adjuntos (imágenes, documentos, etc.). Valor: `true` o `false`

---

### CONSIDERACIONES

- **Adjuntos:** el contenido de los archivos adjuntos no se incluye en el JSON. Únicamente se indica su existencia mediante la bandera `attachments_available`
- **Tipificaciones:** la tipificación se asigna al cierre de la conversación. Se envían hasta 3 niveles y los niveles no utilizados se envían como cadena vacía (`""`)
- **Transferencias:** cuando una conversación es atendida por más de un agente, el campo `agent_name` del encabezado corresponde al primer agente que respondió; el `agent_name` de cada mensaje refleja al agente que lo envió
- **Conversaciones cerradas:** únicamente se envían conversaciones que ya cuentan con evento de cierre registrado