# Modjo

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

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

## How to connect

### Get your Modjo API key

Only a Modjo **Administrator** or **Manager** can create an API key.

<Steps>
  <Step title="Open the Public API settings">
    In Modjo, go to **Settings** > **Integrations** and open the **Public API** card.
  </Step>
  <Step title="Create the key">
    Create a key and copy it right away. Modjo shows it only once.
  </Step>
</Steps>

<Warning>
The API key belongs to your whole Modjo workspace. If someone deletes it later, Allo stops sending calls to Modjo. Reconnect Modjo in Allo with a new key.
</Warning>

### Connect in Allo

<Steps>
  <Step title="Open integrations">
    Go to [**web.withallo.com**](https://web.withallo.com) and navigate to **Settings** > **Integrations**.
  </Step>
  <Step title="Find Modjo">
    Find **Modjo** in the list and click **Connect**.
  </Step>
  <Step title="Paste your key">
    Paste the API key.
  </Step>
  <Step title="Save and connect">
    Click **Save & Connect**. One connection covers your whole Allo team.
  </Step>
</Steps>

### Before your first call

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

1. **Same email in both tools.** Each teammate needs a Modjo user with the email they use in Allo.
2. **A Modjo licence.** Modjo only takes calls owned by a user who holds one of your workspace's licences. A Modjo admin assigns them.

## What gets sent to Modjo

After each recorded call, Allo uploads to Modjo:

- The call recording, which Modjo downloads and processes on its side
- The teammate who handled the call, as the Modjo user who owns it
- The date and time the call started, and its duration
- The direction: inbound or outbound
- The other person's phone number, plus their email when the contact has one in Allo, so Modjo can match them with its contacts
- A title: **Allo call with** the contact's name, or their number when the contact has no name. A call from a hidden number is named **Allo call with Unknown caller**
- Your Allo call tags that already exist in Modjo, matched by name

Allo never creates tags in Modjo. To see a tag on your calls in Modjo, create a tag with the same name in Modjo first.

Before each upload, Allo checks whether the call is already in Modjo (same teammate, same start time, same number), so retrying a call doesn't upload it a second time.

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

### 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: Modjo writes its own from the recording
- SMS and contacts

### Changes after the upload

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

<Note>
Modjo can log the calls it receives in your CRM. If Allo is also connected to that CRM, check that the same call doesn't appear twice there, and turn off call logging on one side if it does.
</Note>

## 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.

<AccordionGroup>
  <Accordion title="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 that it still exists in Modjo, under **Settings** > **Integrations** > **Public API**.
  </Accordion>

  <Accordion title="A call is not in Modjo">
    Check the integration indicator on the call in the web app. The most common causes:

    - **No Modjo user for this teammate.** The teammate's Allo email doesn't match any Modjo user. Add them to Modjo with the same email.
    - **No Modjo licence.** A Modjo admin must give the teammate a licence.
    - **The call has no recording.** Modjo 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 deleted it in Modjo. Disconnect Modjo in Allo and connect it again with a new key.

    Once you fix the cause, retry the sync from the call in the web app.
  </Accordion>

  <Accordion title="The call is in Modjo but the transcript isn't there yet">
    Modjo downloads the recording and processes it on its side, which usually takes 5 to 30 minutes. The transcript and the summary appear once Modjo has finished with the call.
  </Accordion>

  <Accordion title="A tag is missing on the call in Modjo">
    Allo only adds the tags that already exist in Modjo. Create the tag in Modjo with the same name as in Allo. Calls uploaded after that carry it.
  </Accordion>

  <Accordion title="The call is on the wrong person in Modjo">
    Allo picks the Modjo user from the teammate who handled the call, matched by email. Make sure each teammate's Allo email belongs to their own Modjo user, and not to a shared or admin account.
  </Accordion>
</AccordionGroup>
