How to use Audit Logs?

Last updated on Jul 30, 2024

Audit Logs is an Enterprise feature. This keeps a record of the activities occurring in your account, which you can track to audit your account, team, or services. Essentially, audit logs answer the four W's for you:

  • Who

  • What

  • When

  • Where

Or, who did whatwhen and from where?

Where to find the Audit Logs within Chatwoot?

Step 1. If the feature is available to you, you can find it by going to 'Settings' -> 'Audit Logs'.

Step 2. Browse through your logs. Scroll down to find your desired entries or use the navigation to switch pages.

Pro tip: Use cmd/ctrl + F to quickly search for a desired entry.

You will find the entries under three headers: Activity, Time and IP Address.

Activities tracked through Audit Logs

Whenever any of the following activities occurs within your account, an entry is created along with the date and timestamp, and the IP address. See the full list below.

User activity logs

  • <Name | Email> changed self status to online, offline, busy

  • <Name | Email> signed in

  • <Name | Email> signed out

  • <Name | Email> changed the availability status of <Name | Email> to <online | offline | busy>

  • <Name | Email> invited the user as an <agent | admin>

  • <Name | Email> changed the role of the user to <agent | admin>

Account activity logs

  • <Name | Email> updated the account configuration.

Automation rule logs

  • <Name | Email> created a new automation rule (#rule-id)

  • <Name | Email> updated an automation rule (#rule-id)

  • <Name | Email> deleted an automation rule (#rule-id)

Macro logs

  • <Name | Email> created a new macro (#macro-id)

  • <Name | Email> updated a macro (#macro-id)

  • <Name | Email> deleted a macro (#macro-id)

Inbox logs

  • <Name | Email> created a new inbox (#inbox-id)

  • <Name | Email> updated an inbox (#inbox-id)

  • <Name | Email> deleted an inbox (#inbox-id)

  • <Name | Email> added <Name1 | Email1>, <Name2 | Email 2> to the inbox (#inbox-id)

  • <Name | Email> removed <Name1 | Email1>, <Name2 | Email 2> from the inbox (#inbox-id)

Webhooks logs

  • <Name | Email> created a new webhook (#webook-id)

  • <Name | Email> updated a webhook (#webhook-id)

  • <Name | Email> deleted a webhook (#webhook-id)

Team logs

  • <Name | Email> created a new team (#team-id)

  • <Name | Email> updated a team (#team-id)

  • <Name | Email> deleted a team (#team-id)

  • <Name | Email> added <Name1 | Email1>, <Name2 | Email 2> to the team (#team-id)

  • <Name | Email> remove <Name1 | Email1>, <Name2 | Email 2> from the team (#team-id)