Registros de WhatsApp
La sección de Registros de WhatsApp proporciona un registro completo de todas las interacciones automatizadas procesadas por el módulo WhatsApp Cloud API Chat & Marketing. Esto incluye entregas de campañas, respuestas activadas por bots y mensajes basados en plantillas. Usa esta sección para monitorear la actividad, solucionar problemas de entrega y mantener un registro de auditoría completo de tus comunicaciones de WhatsApp.
Acceder a los Registros de WhatsApp
Navega a WhatsApp Module > WhatsApp Logs desde la barra lateral de Perfex CRM. Los registros se muestran en una tabla ordenable y con búsqueda que muestra toda la actividad de mensajes automatizados.
Columnas de la Tabla de Registros
Cada entrada de registro contiene la siguiente información:
| Columna | Descripción |
|---|---|
| # | Un ID único auto-incrementado para cada entrada de registro |
| Category | El tipo de interacción automatizada — por ejemplo, Marketing Campaign, Template Bot |
| Name | El nombre de la campaña, bot o automatización que generó la entrada de registro |
| Template Name | La plantilla de mensaje de WhatsApp utilizada para la interacción |
| Response Code | El código de respuesta HTTP devuelto por la WhatsApp Cloud API (por ejemplo, 200 para éxito, 400 para solicitud incorrecta) |
| Type | El tipo de destinatario — por ejemplo, Leads, Customers, Contacts |
| Recorded On | La fecha y hora en que se registró la interacción |
| Actions | Acciones disponibles para cada entrada: View detalles o Delete el registro |
Comprender los Códigos de Respuesta
La columna de código de respuesta te ayuda a identificar rápidamente si los mensajes se entregaron exitosamente o encontraron errores.
| Código de Respuesta | Significado | Acción Requerida |
|---|---|---|
| 200 | Éxito — mensaje aceptado por la WhatsApp API | No se requiere acción |
| 400 | Solicitud Incorrecta — parámetros inválidos o problema con la plantilla | Revisa la plantilla y los parámetros |
| 401 | No Autorizado — token de acceso inválido o expirado | Regenera tu token de acceso en la configuración de Meta Business |
| 403 | Prohibido — permisos insuficientes | Verifica los permisos de tu System User |
| 404 | No Encontrado — Phone Number ID o endpoint inválido | Verifica tu Phone Number ID en la configuración del módulo |
| 429 | Límite de Velocidad — demasiadas solicitudes enviadas | Reduce la frecuencia de envío; reintenta después del período de espera |
| 500 | Error Interno del Servidor — problema de la WhatsApp API | Reintenta más tarde; verifica la página de estado de Meta si persiste |
Un código de respuesta exitoso (200) confirma que la WhatsApp Cloud API aceptó el mensaje para su entrega. No garantiza la entrega final al dispositivo del destinatario — la confirmación de entrega llega a través de actualizaciones de estado del webhook visibles en la interfaz de chat.
Filtrar Registros
Usa los filtros integrados para reducir las entradas de registro y encontrar registros específicos rápidamente:
- Category — filtra por tipo de interacción (Marketing Campaign, Template Bot, etc.)
- Response Code — filtra por éxito (
200) o códigos de error específicos - Type — filtra por tipo de destinatario (Leads, Customers, Contacts)
- Date Range — selecciona una fecha de inicio y fin para ver registros dentro de un período específico
- Search — búsqueda de texto libre en nombres de campañas, nombres de plantillas y otros campos
Ver Detalles del Registro
Haz clic en la acción View en cualquier entrada de registro para ver los detalles completos de la interacción, incluyendo:
- Payload completo de la solicitud enviada a la WhatsApp API
- Cuerpo completo de la respuesta de la API
- Número de teléfono del destinatario y referencia del contacto
- Parámetros de la plantilla y valores de variables utilizados
- Marca de tiempo con información de zona horaria
Esta vista detallada es invaluable para solucionar problemas de entregas fallidas o auditar el contenido específico de los mensajes.
Eliminar Registros
Para eliminar entradas de registro individuales:
- Haz clic en la acción Delete en la fila del registro objetivo.
- Confirma la eliminación cuando se te solicite.
Para eliminar registros masivamente, usa la selección de casillas para seleccionar múltiples entradas y haz clic en Delete Selected.
Los registros eliminados no pueden recuperarse. Si necesitas conservar registros para fines de cumplimiento o auditoría, considera exportar los datos antes de la eliminación.
Mejores Prácticas
- Revisa los registros regularmente — verifica las entregas fallidas (códigos de respuesta distintos de 200) y aborda los problemas de inmediato para mantener la efectividad de las campañas
- Monitorea los límites de velocidad — si ves respuestas
429frecuentes, reduce la tasa de envío de campañas o escálona las entregas en ventanas de tiempo más largas - Mantén los tokens actualizados — los errores
401indican que tu token de acceso ha expirado o fue revocado; actualízalo inmediatamente para restaurar la funcionalidad - Archiva antes de limpiar — antes de eliminar registros antiguos, exporta o documenta cualquier registro necesario para cumplimiento, informes o resolución de disputas
- Usa filtros para auditoría — al investigar una campaña o bot específico, usa los filtros de Category y Name para aislar las entradas de registro relevantes rápidamente
Los Registros de WhatsApp solo capturan interacciones automatizadas (campañas, bots, envíos de plantillas). Los mensajes de chat manuales entre el personal y los clientes se almacenan en el historial de chat y no se duplican en esta sección de registros.