Auto Installer of Intercom Activity Logs

Overview

A lightweight, dependency-free Bash collector that polls the Intercom Admin Activity Logs API on an hourly schedule, flattens each event to a dot-notation NDJSON record, rotates output files at a configurable size, and automatically purges old archives — all running as a systemd user service with no root access required.

Prerequisites

Intercom API token
Intercom API Version

Steps to generate an Intercom API Token

Go to the official Intercom Developer Hub:
Intercom Developer Hub
Log in to your Intercom workspace.
Open your workspace’s Developer Hub:
- In Intercom, go to:
  Settings → Developer Hub → Your Apps
Click New App (or “Create App”).
Enter:
- App name
- Description (optional)
After creating the app:
- Open the app
- Go to Configure → Authentication
You’ll see your Access Token there.
Copy the token and store it securely.
You can also find the API Version and copy as well.

Creating the setup installer

Linux:

Login to the Log Collector.
Open Terminal and type the following commands.
- ```
cd Documents
```
- ```
nano setup.sh
```

Paste this Script *Contact Aquila Tech Support for the full source code.

Please Contact "Aquila Platform Defence and Technical Enablement" for the source code. Thank you!.

Save the Script and change it to executable file.
- ```
chmod +x setup.sh
```
Now execute the file.
- ```
./setup.sh
```
Follow the on screen instruction to fully integrate the system.

Provide the "activity_logs.ndjson" Directory to Cytech Support for Integration.
Example: /home/user/intercom/activity_logs.ndjson

For the Back-end add this to Custom configurations:

processors:
  - decode_json_fields:
      fields: ["message"]
      target: ""
      overwrite_keys: true
      add_error_key: true
  - add_fields:
      target: event
      fields:
        module: intercom
  - add_fields:
      target: component
      fields:
        id: intercom-logs

If you need further assistance, kindly contact our support at support@cytechint.com for prompt assistance and guidance.