> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jiminny

> Upload every recorded Allo call to Jiminny, on the rep who handled it

Connect Jiminny and every recorded call your team makes or takes in Allo is uploaded to Jiminny, as a new call in the library of the teammate who handled it. Jiminny transcribes the recording on its side, so your team can review and coach the call there, like any other call.

## How to connect

### Get your Jiminny API key

Only a Jiminny **Admin** or **Owner** can generate the API key. If you don't see the API key option, ask your Jiminny customer success manager to enable API access for your organization.

**1. Open the API key settings**

In Jiminny, go to **Settings** > **Organization Settings** > **Integrations** > **API Key**.

**2. Generate the key**

Click **Generate** and copy the key right away. Jiminny shows it only once.

**3. Note your region**

Look at the address you use to log in to Jiminny: **app.jiminny.eu** means the Europe region, **app.jiminny.com** means the United States region.

> [!WARNING]
>
> The API key belongs to your whole Jiminny organization. If someone generates a new one later, the old key stops working, and so does every tool that used it, Allo included. Reconnect Jiminny in Allo with the new key.

### Connect in Allo

**1. Open integrations**

Go to [**web.withallo.com**](https://web.withallo.com) and navigate to **Settings** > **Integrations**.

**2. Find Jiminny**

Find **Jiminny** in the list and click **Connect**.

**3. Paste your key and pick your region**

Paste the API key, then pick the region that matches your Jiminny address: **Europe (app.jiminny.eu)** or **United States (app.jiminny.com)**.

**4. Save and connect**

Click **Save & Connect**. One connection covers your whole Allo team.

### Before your first call

Allo uploads each call to the Jiminny user with the same email as the teammate in Allo. Check this for every teammate whose calls should reach Jiminny:

1. **Same email in both tools.** Each teammate needs a Jiminny user with the email they use in Allo. If their Jiminny email is different, add their Allo email to their Jiminny user as a secondary email.
2. **A Recorder licence.** Jiminny may refuse calls for a user without the Recorder role. Make sure each of these teammates has one.

## What gets sent to Jiminny

After each recorded call, Allo uploads to Jiminny:

* The call recording, which Jiminny downloads and processes on its side
* The teammate who handled the call, as the Jiminny user who owns it
* The date and time the call ended
* The call's language, so Jiminny transcribes it in the right language
* A title with the direction, the other person and your Allo call tags

Jiminny has no field for the direction, the phone number or tags on an uploaded call, so Allo puts them in the title. For example, **Allo · Outbound call with Jane Prospect · +14155550123 · Demo** or **Allo · Inbound call with +14155550123**. A call from a hidden number is named **Allo · Inbound call with Unknown caller**.

Retrying a call never creates a second copy in Jiminny.

**Sync direction:** One-way (Allo → Jiminny). Nothing comes back from Jiminny into Allo.

### Limits of an uploaded call

Jiminny treats these calls as uploaded recordings, not as calls from a connected phone system:

* **No contact or CRM link.** The upload carries no phone number or contact, so Jiminny doesn't link the call to a contact, account or opportunity in your CRM. The number is only in the title.
* **Unnamed speakers.** Jiminny shows the voices as **Speaker 1** and **Speaker 2** until someone names them in Jiminny.

### What is not sent

* Calls without a recording, such as missed calls
* Calls from numbers that match no contact in Allo
* Calls with a contact you marked as favorite in Allo
* Allo's call summary and transcript: Jiminny works from the recording
* SMS and contacts

### Changes after the upload

Jiminny doesn't let Allo edit a call once it's uploaded. If you add or change tags on a call after it reached Jiminny, the change stays in Allo.

## Troubleshooting

Check the sync status of any call from the **call list on [web.withallo.com](https://web.withallo.com)**. Each call has an integration indicator showing its sync state.

> [accordion] I cannot connect my integration
>
> Only **admins** and **managers** of an Allo workspace can connect integrations. If you don't see the option, ask your workspace admin or manager to set it up.
>
> If Allo refuses the API key, check that:
>
> * You copied the whole key, and it's the latest one generated in Jiminny.
> * You picked the region that matches your Jiminny address (**app.jiminny.eu** or **app.jiminny.com**).
> * API access is enabled for your Jiminny organization. If not, ask your Jiminny customer success manager.

> [accordion] A call is not in Jiminny
>
> Check the integration indicator on the call in the web app. The most common causes:
>
> * **No Jiminny user for this teammate.** The teammate's Allo email doesn't match any Jiminny user. Add them to Jiminny with the same email, or add their Allo email to their Jiminny user as a secondary email.
> * **No Recorder licence.** A Jiminny admin must give the teammate the Recorder role.
> * **The call has no recording.** Jiminny only takes calls with audio, so missed or unrecorded calls are never sent.
> * **The number matches no contact in Allo.** Add the caller as a contact in Allo.
> * **The API key no longer works.** Someone generated a new key in Jiminny. Disconnect Jiminny in Allo and connect it again with the new key.
>
> Once you fix the cause, retry the sync from the call in the web app.

> [accordion] The call is in Jiminny but the transcript isn't there yet
>
> Jiminny downloads the recording and processes it on its side. The transcript appears once Jiminny has finished with the call.

> [accordion] The call isn't linked to the contact in my CRM
>
> This is expected. Jiminny's upload has no field for the phone number or the contact, so Jiminny can't match the call to a CRM record. The direction and the number are in the call title, so you can find the call by searching for the number.

> [accordion] The call is on the wrong person in Jiminny
>
> Allo picks the Jiminny user from the teammate who handled the call, matched by email. Make sure each teammate's Allo email belongs to their own Jiminny user, and not to a shared or admin account.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.