feat(whoami): add whoami endpoint for intercom (#206)

## Describe your changes

## Issue ticket number and link

## Checklist before requesting a review (skip if just adding/editing
APIs & templates)

-   [ ] I added tests, otherwise the reason is:
-   [ ] External API requests have `retries`
-   [ ] Pagination is used where appropriate
- [ ] The built in `nango.paginate` call is used instead of a `while
(true)` loop
- [ ] Third party requests are NOT parallelized (this can cause issues
with rate limits)
- [ ] If a sync requires metadata the `nango.yaml` has `auto_start:
false`
-   [ ] If the sync is a `full` sync then `track_deletes: true` is set
- [ ] I followed the best practices and guidelines from the [Writing
Integration
Scripts](/NangoHQ/integration-templates/blob/main/WRITING_INTEGRATION_SCRIPTS.md)
doc

flows.yaml

@@ -6122,6 +6122,15 @@ integrations:
                     path: /contact
                 output: SuccessResponse
                 input: IdEntity
+            whoami:
+                description: Fetch current user information
+                output: UserInformation
+                endpoint:
+                    method: GET
+                    path: /whoami
+                    group: Users
+                scopes:
+                    - Read admins
         syncs:
             conversations:
                 runs: every 6 hours
@@ -6295,6 +6304,9 @@ integrations:
                 last_seen_at?: number
                 owner_id?: string
                 unsubscribed_from_emails?: boolean
+            UserInformation:
+                id: string
+                email: string
     jira:
         syncs:
             issues:

integrations/intercom/actions/whoami.md

@@ -0,0 +1,43 @@
+<!-- BEGIN GENERATED CONTENT -->
+# Whoami
+
+## General Information
+
+- **Description:** Fetch current user information
+- **Version:** 0.0.1
+- **Group:** Users
+- **Scopes:** `Read admins`
+- **Endpoint Type:** Action
+- **Code:** [github.com](https://github.com/NangoHQ/integration-templates/tree/main/integrations/intercom/actions/whoami.ts)
+
+
+## Endpoint Reference
+
+### Request Endpoint
+
+`GET /whoami`
+
+### Request Query Parameters
+
+_No request parameters_
+
+### Request Body
+
+_No request body_
+
+### Request Response
+
+```json
+{
+  "id": "<string>",
+  "email": "<string>"
+}
+```
+
+## Changelog
+
+- [Script History](https://github.com/NangoHQ/integration-templates/commits/main/integrations/intercom/actions/whoami.ts)
+- [Documentation History](https://github.com/NangoHQ/integration-templates/commits/main/integrations/intercom/actions/whoami.md)
+
+<!-- END  GENERATED CONTENT -->
+

integrations/intercom/actions/whoami.ts

@@ -0,0 +1,19 @@
+import type { NangoAction, ProxyConfiguration, UserInformation } from '../../models';
+import type { WhoAmIResponse } from '../types';
+
+export default async function runAction(nango: NangoAction): Promise<UserInformation> {
+    const config: ProxyConfiguration = {
+        // https://developers.intercom.com/docs/references/1.1/rest-api/admins/viewing-the-current-admin
+        endpoint: 'me',
+        retries: 10
+    };
+
+    const { data } = await nango.get<WhoAmIResponse>(config);
+
+    const user: UserInformation = {
+        id: data.id,
+        email: data.email
+    };
+
+    return user;
+}

integrations/intercom/nango.yaml

@@ -22,6 +22,15 @@ integrations:
                     path: /contact
                 output: SuccessResponse
                 input: IdEntity
+            whoami:
+                description: Fetch current user information
+                output: UserInformation
+                endpoint:
+                    method: GET
+                    path: /whoami
+                    group: Users
+                scopes:
+                    - 'Read admins'
         syncs:
             conversations:
                 runs: every 6 hours
@@ -195,3 +204,6 @@ models:
         last_seen_at?: number
         owner_id?: string
         unsubscribed_from_emails?: boolean
+    UserInformation:
+        id: string
+        email: string

integrations/intercom/types.ts

@@ -435,3 +435,26 @@ export interface IntercomAdminUser {
     team_ids: string[];
     team_priority_level: unknown;
 }
+
+export interface WhoAmIResponse {
+    type: 'admin';
+    id: string;
+    email: string;
+    name: string;
+    email_verified: boolean;
+    app: {
+        type: 'app';
+        id_code: string;
+        name: string;
+        created_at: number;
+        secure: boolean;
+        identity_verification: boolean;
+        timezone: string;
+        region: string;
+    };
+    avatar: {
+        type: 'avatar';
+        image_url: string;
+    };
+    has_inbox_seat: boolean;
+}