# Zoho Bigin

> Connect Bigin by Zoho to Allo, sync your contacts and companies, and log every call as a Bigin call and every SMS as a note on the contact

Allo logs every call as a **Call** on the matching Bigin contact, with the summary and a link to the recording, and adds every SMS to the contact as a **Note**. Your Bigin contacts and companies sync into Allo every 5 minutes.

<Note>
  The Bigin API is available on every Bigin plan, including the Free plan, so any Bigin account can connect to Allo.
</Note>

## How to connect

The Bigin integration connects with your Zoho account: there is no key to copy. You need an Allo admin or manager to connect the integration.

<Steps>
  <Step title="Open integrations">
    Go to [**web.withallo.com**](https://web.withallo.com) and navigate to **Settings** > **Integrations**.
  </Step>
  <Step title="Connect Zoho Bigin">
    Find **Zoho Bigin** in the list and click **Connect**.
  </Step>
  <Step title="Choose your region">
    Pick the region your Bigin account is hosted in: **Europe**, **United States**, **Australia** or **India**, then click **Connect**. The region is in the address of your Bigin account, for example `bigin.zoho.eu` for Europe or `bigin.zoho.in` for India.
  </Step>
  <Step title="Authorize">
    Sign in to Zoho if needed, then click **Accept** to give Allo access to your Bigin data.
  </Step>
  <Step title="Done">
    You're redirected back to Allo. Allo imports your Bigin contacts and companies.
  </Step>
</Steps>

## What syncs

**From Bigin to Allo:**
- Contacts, with their first and last name, email, mobile, phone and home phone numbers, title, company, tags, owner, and a link to the contact in Bigin
- Companies, with their name, website, phone number, billing address, description and owner, and a link to the company in Bigin

The owner is the Bigin user the record is assigned to, matched to your Allo users by email.

**From Allo to Bigin:**
- Calls, logged as Bigin calls on the matching contact
- SMS, logged as notes on the matching contact
- New contacts, created as Bigin contacts only when **Create lead for unknown calls** is enabled. Allo creates the contact with the name, email, phone number (in **Mobile**) and title known in Allo.

Allo only fills in empty fields on an existing contact, and adds a phone number the contact doesn't have yet in the first empty phone field. Allo never overwrites what is already set in Bigin.

Contacts and companies sync every 5 minutes, only the records that changed. Pipelines are not synced. Deleting a record in Bigin does not remove the contact from Allo. Contacts without a phone number are not synced to Allo.

When a call comes in or goes out, Allo finds the Bigin contact by its mobile, phone or home phone number, however it is formatted in Bigin (for example `(415) 555-0123` or `06 12 34 56 78`).

## How calls are synced

After each call, Allo adds a **Call** to the matching contact. The call shows in the contact's activities and in Bigin's call list, dated to when the call happened, with its duration. The call type is **Outbound** for calls you make, **Inbound** for answered incoming calls, and **Missed** for incoming calls nobody answered.

The call subject shows the direction and the result, for example `Allo Outbound Call - Answered`. The call description contains:

- The Allo user who took the call and the duration
- The call summary
- A link to the call recording

The call tags are added as Bigin tags on the call. Outbound calls also carry the number that was dialled. The call transcript is not added.

When you change a call's result or tags in Allo, Allo updates the same call in Bigin: the subject shows the new result, and a missed call that is marked as answered becomes an **Inbound** call.

Allo assigns the call to the Bigin user whose email matches the Allo user who took the call. If no Bigin user matches, the call belongs to the Bigin user who connected the integration.

Calls logged by Allo do not trigger your Bigin workflows.

If your Bigin account does not let Allo create calls (for example when the Calls module is turned off), Allo logs the call as a **Note** on the contact instead.

## How SMS are synced

Allo adds each SMS to the matching contact as a **Note**, titled for example `Allo Outbound SMS to Jane Doe - Sent by Leo Martin`. The note contains who sent the SMS to whom, the date and time, and the message.

## Click-to-call

Bigin has no built-in click-to-call for Allo. Install the [Allo Chrome extension](/help/integrations/chrome-extension): it adds an Allo icon next to the phone numbers in Bigin, and one click starts the call in the Allo app.

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

    On the Bigin side, check these points:

    - **Region**: pick the region your Bigin account is hosted in. If you pick another region, Zoho cannot find your Bigin account and the connection fails.
    - **Consent**: click **Accept** on the Zoho screen. If you close it or click **Reject**, Allo stays disconnected.
  </Accordion>

  <Accordion title="Call not synced to my integration">
    Check the integration indicator on the call in the web app. The error will be one of these:

    - **Contact not found**: the contact doesn't exist in your CRM. By default, Allo only syncs calls to existing contacts. To auto-create contacts, go to your integration settings and enable **Create lead for unknown calls**.
    - **Contact deleted**: the contact was removed from your CRM. Allo is additive and won't sync calls for deleted contacts. Re-create the contact in your CRM, then retry the sync.
    - **Integration disconnected**: the access Allo was given in Zoho was revoked. Allo still appears connected but requests fail. Disconnect and reconnect the integration in Allo.
    - **Call pending (spinner icon)**: Allo is still matching the contact. This can take up to 24 hours before being marked as an error. Once the contact exists in your CRM, you can retry manually.
    - **Contact is a favorite**: by default, calls with a favorite contact are not synced to your CRM. Remove the contact from your favorites if you want these calls to sync.
  </Accordion>

  <Accordion title="Calls show as Notes instead of Calls">
    Bigin refused to create the call, most often because the **Calls** module is turned off or hidden for the user who connected the integration. Turn the Calls module back on in Bigin: the next calls are logged as Bigin calls.
  </Accordion>

  <Accordion title="Contacts not syncing">
    The first sync can take up to **15 minutes** for large contact databases. After that, contacts and companies sync incrementally every **5 minutes**, not in real time.

    Bigin limits how many API calls an account can make per day (5,000 on the Free plan, more on paid plans). On a busy Free account, Allo can reach this limit: syncs and calls then wait until Bigin allows new calls.

    Allo only syncs contacts that have at least one phone number.

    If contacts still don't appear after 15 minutes, disconnect and reconnect the integration.
  </Accordion>

  <Accordion title="SMS not synced">
    Each SMS is added as a note on the contact. Look for the note in the contact's **Notes** in Bigin.

    If the note is missing, verify the integration is connected in **Settings** > **Integrations** and check the integration indicator on the call list at [web.withallo.com](https://web.withallo.com) for error details. If SMS still don't appear, disconnect and reconnect the integration.
  </Accordion>

  <Accordion title="Duplicate contacts">
    Allo mirrors your integration exactly. If your CRM has duplicate contacts with the same phone number, they appear as separate contacts in Allo.

    Clean up duplicates in your CRM. Allo will reflect the change on the next sync.
  </Accordion>

  <Accordion title="Call synced to the wrong contact">
    When multiple contacts share the same phone number, Allo logs the call on the matching contact updated most recently in Bigin. Before reporting a missing sync, check all contacts that share that phone number: the call may already be synced to another one. Click the integration indicator on any call in the web app to see exactly which contact it was synced to.
  </Accordion>
</AccordionGroup>
