PhoneBook — Listado de Números Conocidos¶
El módulo PhoneBook permite registrar y mantener un listado de números telefónicos conocidos por la empresa. Su función principal es que el sistema pueda reconocer automáticamente a los clientes cuando envían un mensaje por WhatsApp, mostrando su nombre en lugar del número y habilitando el uso de sus datos en flujos, mensajes y campañas.
Listado de contactos¶
Esta pantalla muestra todos los contactos registrados en la base de datos, con herramientas de búsqueda, selección y exportación.
| Campo | Descripción |
|---|---|
| Id | Identificador único de solo lectura. |
| Teléfono | Número en formato internacional (por ejemplo, 5493515895645). |
| Nombre | Nombre completo del contacto. |
| Tags | Etiquetas asignadas al contacto. Se usan para filtrar y segmentar. |
| Atributos | Pares clave-valor personalizados. Por ejemplo: zona: rural, empresa: central. |
| Acciones | Editar o eliminar el registro. |
Búsqueda y filtrado¶
El campo Search filtra los resultados en tiempo real sobre todos los campos visibles. Esto permite, por ejemplo, escribir VIP para ver solo los contactos con esa etiqueta, o escribir parte de un número o nombre para ubicar un registro rápidamente.
Selección y exportación CSV¶
Los contactos se pueden seleccionar individualmente o en conjunto para exportarlos en formato CSV. Este archivo puede importarse directamente en el módulo de Campañas para crear envíos segmentados.
Flujo típico:
- Buscar por etiqueta o atributo (por ejemplo,
morosoozona: rural). - Seleccionar los contactos filtrados.
- Hacer clic en Exportar CSV.
- Importar el archivo en una campaña nueva.
El contador Seleccionados indica cuántos registros están activos en la selección actual.
Memoria de selección entre páginas¶
La selección se mantiene al navegar entre páginas del listado. Si el usuario avanza a la siguiente página y vuelve, los contactos previamente seleccionados siguen marcados. El indicador "Selección previa restaurada" aparece cuando el sistema recupera una selección guardada de la sesión anterior.
Para borrar la selección acumulada, usar el botón Limpiar selección.
Agregar un nuevo contacto¶
El botón + Agregar abre un formulario para registrar un nuevo número.
| Campo | Obligatorio | Descripción |
|---|---|---|
| Teléfono Contacto | Sí | Número en formato internacional, sin el símbolo +. |
| Nombre Contacto | Sí | Nombre completo del cliente. |
| Tags | No | Etiquetas de clasificación (por ejemplo: VIP, moroso, zona_norte). |
| Notas | No | Campo libre para observaciones internas. |
| Atributos | No | Pares clave-valor personalizados. Se pueden agregar tantos como se necesiten con el botón + Add attribute. |
Editar un contacto existente¶
Al hacer clic en el ícono de edición de cualquier fila, se abre un modal directamente en la misma pantalla, sin redirigir a otra página.
El modal muestra todos los campos del contacto y permite modificarlos, agregar o eliminar atributos, y guardar los cambios sin perder el contexto del listado.
Variables de sistema¶
Los datos del PhoneBook se exponen como variables de sistema que pueden usarse en mensajes, flujos y comandos de API.
| Variable | Descripción |
|---|---|
_PHONE_NUMBER |
Número de teléfono del contacto. Disponible en el encabezado de conversaciones del agente, en mensajes y en llamadas a API externas. |
_NAME |
Nombre registrado en el PhoneBook. |
_ATTR.xxxx |
Valor de un atributo personalizado, donde xxxx es el nombre de la clave. Por ejemplo, _ATTR.zona o _ATTR.empresa. |
Estas variables pueden usarse como comodines en el texto de Anuncios (ANN), Menús (ITR), Respuestas (REP) y en los parámetros de llamadas a API externas. También pueden mostrarse en el encabezado de conversaciones en la vista del agente, permitiendo ver datos clave del cliente sin abrir su ficha.
Relación con otros módulos¶
- Campañas: la exportación CSV del PhoneBook es el método recomendado para crear listas de destinatarios segmentadas.
- Agentes: al iniciar una conversación saliente, el agente busca el contacto en el PhoneBook antes de seleccionar un template.
- Flujos y mensajes: los comodines
_NAME,_PHONE_NUMBERy_ATTR.xxxxpersonalizan el contenido enviado a cada cliente. - API externa: los atributos del PhoneBook se pueden incluir en los payloads enviados a sistemas externos durante el flujo de conversación.