WhatsApp Audit Logs

What Are WhatsApp Audit Logs?

WhatsApp Audit Logs are a feature within your CRM that provides a detailed record of changes made to your WhatsApp Business configuration at the sub-account level. Each log entry captures the user responsible, the action performed, the exact time it occurred, and the specific WhatsApp asset involved—such as a phone number, template, or flow. This helps you maintain transparency, troubleshoot effectively, and keep a reliable history of modifications.

Key Benefits of WhatsApp Audit Logs

• Instant Visibility: Quickly identify who modified a WhatsApp number, template, or flow, and when the change took place.
• Accountability: Assign responsibility for changes made to WhatsApp assets by team members within the sub-account.
• Efficient Troubleshooting: Use the audit trail to pinpoint when a change caused an issue and determine who can assist in resolving it.
• Reduced Guesswork: Eliminate confusion and unnecessary back-and-forth when configurations behave unexpectedly.
• Operational Control: Maintain a clear, chronological record of important WhatsApp setup changes over time.

Actions Tracked for WhatsApp

The following WhatsApp-related actions are logged at the sub-account level:

• Phone Number: Added WhatsApp Business Account (WABA), Deleted, Deactivated, Default Phone Number Updated
• Template: Created, Updated, Deleted
• Phone Number Profile: Updated
• Flow: Created, Published, Deprecated, Deleted

Each event generates a timestamped entry, allowing you to reconstruct changes that may impact your WhatsApp conversations or workflows.

How to Access WhatsApp Audit Logs

WhatsApp Audit Logs are accessible within each sub-account where WhatsApp is configured.

1. Open the desired sub-account and navigate to Settings → Audit Logs.
2. Use the search bar and Module filter to narrow down results to WhatsApp-related activity.
3. Click any row to open a details panel showing the user, action, timestamp, and entity affected.

Using WhatsApp Audit Logs for Troubleshooting

Common scenarios where audit logs are helpful:

• If a WhatsApp phone number disappears or changes unexpectedly, check for events like phone number additions, default number updates, or WABA deletions/deactivations.
• If templates stop sending or are modified without notice, look for Template – Created, Updated, or Deleted events to identify the user involved.
• If flows behave differently, filter for Flow – Created, Published, Deprecated, or Deleted events to review recent configuration changes.

By examining the user, action, time, and entity details, you can resolve issues faster and assign follow-up tasks accurately.

Scope and Retention

WhatsApp Audit Logs are recorded only at the sub-account level. Log entries are retained for 60 days before being automatically removed, consistent with other audit logs in the CRM.

Frequently Asked Questions

Are Audit Logs available in every sub-account?

Yes, access is provided at the sub-account level. Open the sub-account where WhatsApp is configured to view its logs.

I don't see WhatsApp events. What should I check?

Confirm you are in the correct sub-account, expand the date range, and remove restrictive filters (such as specific users or entities) to broaden your results.

How long are WhatsApp audit events kept?

Audit events are retained for 60 days. Plan your review schedule accordingly.

Can I get alerts when certain events happen?

Built-in notifications are not currently available. Consider scheduling regular log reviews during important projects.

Who can view Audit Logs?

Visibility depends on sub-account roles and permissions. If you cannot access Settings → Audit Logs, contact a sub-account administrator.