---
title: "Rippling"
description: "サインインまたはAPIキーでRipplingから従業員を同期し、展開する関連データを選び、必要なときは新しいキーで再接続します。"
sidebar:
  label: 概要
  order: 0
area: integrations
feature: rippling
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-09"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
  - directory/employees
translation:
  source: integrations/rippling/index.mdx
  sourceSha: 53003e676cf6adaf8084fa890f830e37d20ba3c9
---

Rippling連携はRipplingのAPIからワーカーを読み取り、Directoryを最新に保ちます。対象は名前、勤務先と個人のメールアドレス、入社日と退職日、役職、部署、マネージャー、雇用形態とワーカー種別です。Pynは読み取るだけで、何も書き戻しません。

## 始める前に

- あなたがPynの管理者またはオーナーであること。**Connect**と**Reconnect**は他のロールでは無効になっています。
- Ripplingに管理者としてサインインしてPynを承認できるか、Ripplingの管理者がPyn用の**API key**を作成していること。

![Connect to Rippling redirects you to Rippling, or takes an API key instead.](https://support.pyn.ai/media/integrations/rippling/integrations-rippling-connect.png)

## 接続する

1. Pynで左のナビゲーションの**Settings**を開き、**Integrations**の下の**Available**を開きます。

2. **Rippling**のタイルを選びます。**Connect to Rippling**ダイアログが開き、「You will be redirected to Rippling to authorize Pyn to access your company's employee data.」と表示されます。

3. サインインするには、「**API Key (optional)**」を空のままにして**Connect**を選びます。RipplingでPynを承認して戻ります。

4. 代わりにキーを使うには、**API Key (optional)**（「Connect with a Rippling API key instead」）にキーを貼り付けて**Connect**を選びます。

5. パネルには「You're connected. Syncing can take a few minutes. Check the journey map then!」と表示されます。

## 同期されるもの

PynはRipplingから約1時間に1回更新し、各実行を**History**に記録します。**Details**タブには**Expanded Data**が表示されます。Pynが各ワーカーとともに要求する関連レコードで、**Department**、**Employment Type**、**Manager**、**Teams**です。選択はそこで変えられます。

| Pynのプロパティ | Ripplingでの元 |
| --- | --- |
| 表示名、正式名、呼び名 | ワーカーの名前 |
| 勤務先メールアドレス、個人メールアドレス | Workとhomeのメールアドレス。ユーザーのメールアドレスにフォールバック |
| 入社日、在籍起算日 | Start date（在籍起算日も同じ値になります） |
| 退職日 | Termination dateまたはend date |
| 役職、部署、勤務地 | Title、departmentの名前、work location |
| 従業員種別、雇用形態、ワーカー種別、勤務時間種別、exempt | Employment typeとclassification |
| マネージャー | Manager。**Manager**を展開している場合 |
| アバター、誕生日、国、郵便番号、タイムゾーン | プロフィール写真と住所。タイムゾーンはRipplingユーザー自身のタイムゾーンから、なければ国と郵便番号から |

マトリクスは[HRISフィールド](https://support.pyn.ai/ja/integrations/hris-fields/)を参照してください。

## テストする

**Installed**でRipplingのタイルを開き、メニュー（**...**）を開いて**Test Connection**を選びます。「Successfully tested the connection to Rippling.」なら成功です。「An error occurred connecting to Rippling. Please Reconnect or contact support if the issue persists.」は認証情報がもう使えないことを意味します。続いて[従業員](https://support.pyn.ai/ja/directory/employees/)を確認します。

## 再接続または切断する

- **Reconnect**を選ぶと**Reconnect to Rippling**が開き、「Enter a new Rippling API key to reconnect this integration.」と表示されます。キーを**API Key**に貼り付けて**Reconnect**を選びます。再接続は常にキーを使います。サインインの流れは最初の接続のためのものです。
- **Deactivate**は同期を止め、**Activate**で再開します。**Archive**は連携をInstalledから取り除きます。操作が完了しなかった場合は、**Could not deactivate the integration**または**Could not archive the integration**というトーストが表示されます。

## トラブルシューティング

| 表示されるもの | 意味 |
| --- | --- |
| History：「Error: Authentication failed, please reconnect」 | キーが取り消されたか、承認が取り下げられました。新しいキーで再接続してください。 |
| History：「Error: Insufficient permissions to access Rippling」 | キーがワーカーまたは展開レコードのいずれかを読めません。Ripplingでスコープを広げてください。 |
| History：「Could not connect to Rippling, please reconnect」 | Ripplingが接続を拒否しました。再接続し、繰り返すならサポートに連絡してください。 |
| マネージャーがいない | **Manager**が**Expanded Data**にありません。Detailsタブでチェックを入れてください。 |

## 関連ページ

- [連携](https://support.pyn.ai/ja/integrations/)：カタログについてです。
- [HRISフィールド](https://support.pyn.ai/ja/integrations/hris-fields/)：フィールドのマトリクスについてです。
- [同期の頻度とマッチング](https://support.pyn.ai/ja/integrations/sync-and-matching/)：スケジュールと照合についてです。
- [従業員](https://support.pyn.ai/ja/directory/employees/)：同期されたレコードを確認するにはこちらです。
