Diccionario de datos
En esta guía encontrarás el diccionario de datos de las principales tablas utilizadas en las Bases de Datos de uContact. Este recurso te permitirá comprender la estructura, los tipos de datos y el propósito de cada columna, facilitando así la integración de desarrollos personalizados o la consulta de información relevante del sistema.
ccrepo.whatsapp_messages
Esta habla se utiliza para almacenar todos los mensajes de WhatsApp gestionados a través de uContact, ya sean entrantes o salientes, manuales o enviados mediante Hubs Salientes.
| Nombre del campo | Tipo de dato | Descripción |
|---|---|---|
| id | bigint | Es el identificador único y autoincremental para cada registro en la tabla. Es la clave primaria. |
| id_whatsapp | varchar(200) | Es el ID único del mensaje proporcionado por el proveedor de WhatsApp (ej. Gupshup, Meta). Este ID es fundamental para el seguimiento. Puede estar vacío en algunos registros iniciales de salida. |
| time | datetime | Es la fecha y hora en que el mensaje fue procesado por uContact. Siempre estará en zona horaria UTC-0. Ejemplo: 2025-05-28 15:25:59 |
| direction | varchar(8) | Indica la dirección del mensaje. Valores Posibles: - outbound: Mensaje enviado desde uContact al cliente. - inbound: Mensaje recibido del cliente. |
| callerid | varchar(100) | Es el número de teléfono del contacto de WhatsApp en formato internacional sin el caracter “+” |
| message | text | Es el contenido del mensaje. Para plantillas (HSM), puede contener un formato especial: el id unico del HSM seguido de los parametros, separados por “:”. Ejemplos: ¡Hola! ¿Cómo estás?, hsm:1234:param1:param2 |
| campaign | varchar(200) | Es el nombre de la campaña de uContact desde donde se recibió o se envió el mensaje. |
| agent | varchar(45) | Es el nombre de usuario del usuario que envió el mensaje en caso de mensajes salientes, para mensajes entrantes, es el usuario que tenia la interacción al momento de recibir el mensaje. Para mensajes enviados desde Hubs Salientes este campo es vacío. |
| result | varchar(900) | Es el estado de entrega o resultado del procesamiento del mensaje. Valores Posibles: - sent: Enviado. - delivered: Entregado al destinatario. - error: Mensaje falló al ser entregado - read: Mensaje leído por el cliente. |
| guid | varchar(64) | Es el guid de la interacción de uContact asociada al mensaje. |
| attachments | json | Almacena información sobre los archivos adjuntos en el mensaje (imágenes, documentos, etc.) en formato JSON. Cada archivo representa la ruta de almacenamiento del archivo en la instancia. Ejemplo: ["20250606/imagen.jpg"] |
| quotedid | varchar(200) | Si el mensaje es una respuesta, este campo contiene el id_whatsapp del mensaje original que se está citando. Es vacío si no es una respuesta. |