# Redtail CRM

> Connect Redtail CRM to Allo, sync your Redtail contacts, and log every call and SMS as a note on the matching contact

Allo logs every call and every SMS as a note on the matching Redtail CRM contact. Your Redtail contacts sync into Allo every 15 minutes, with a full refresh once a day. You connect once with a Redtail CRM username and password, and Allo never stores the password.

## How to connect

### Before you start

- **Which login:** Redtail CRM has no API keys for its customers. Allo signs in with a Redtail username and password and sees exactly the contacts that Redtail user can see. Connect a Redtail user who can see all your clients.
- **Who writes the notes:** every note Allo adds shows the connected Redtail user as its author. The Allo user who took the call is written in the note.
- **In Allo:** you need to be an Allo admin or manager to connect the integration.

There is nothing to turn on in the Redtail CRM settings.

### 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 Redtail CRM">
    Find **Redtail CRM** in the list and click **Connect**.
  </Step>
  <Step title="Enter your Redtail login">
    Enter the Redtail CRM username and password of the user who can see all your clients.
  </Step>
  <Step title="Save and connect">
    Click **Save & Connect**. Allo imports your Redtail contacts.
  </Step>
</Steps>

<Note>
  Allo uses the username and password once, to get a permanent Redtail user key for that user. Allo never stores the password. The Redtail user key does not expire, so changing the Redtail password later does not disconnect the integration. To stop the integration, disconnect Redtail CRM in Allo.
</Note>

## What syncs

**From Redtail CRM to Allo:**
- Contacts of every type: individuals, and businesses, trusts, associations and unions. A contact that is not an individual appears in Allo under its company name.
- For each contact: name, email, phone numbers (fax numbers excluded), job title, company or employer, status (for example **Active Client** or **Prospect**), category, and owner

The owner of the contact in Allo is the Redtail **servicing advisor**, or the **writing advisor** when no servicing advisor is set. Companies are not synced as separate records.

**From Allo to Redtail CRM:**
- Calls and SMS, logged as notes on the matching contact
- New contacts, only when **Create lead on unknown calls** is enabled in the integration settings. This setting is off by default.

When Allo creates a contact for an unknown caller, Allo creates an **Individual** contact with the phone number and the email known in Allo. Allo sets the status to **Prospect** and the source to **Allo** when your Redtail database has them.

Contacts you create or edit in Allo are not pushed to Redtail CRM by default. To push them, enable **Create contacts in your CRM** in the integration settings. Allo only fills in empty fields on an existing Redtail contact and never overwrites a value already set in Redtail CRM.

Changes in Redtail CRM reach Allo within 15 minutes. A contact deleted in Redtail CRM, or left without a phone number, is removed from Allo. Contacts without a phone number are not synced to Allo. Activities, calendar entries and opportunities are not synced.

When a call or an SMS comes in or goes out, Allo finds the Redtail contact by phone number, for US and international numbers. A call or an SMS with a number that matches no Redtail contact is not logged, unless **Create lead on unknown calls** is enabled.

## How calls are synced

After each call, Allo adds a note to the matching contact in Redtail CRM. Allo files the note under a note category named **Phone Call** or **Client Contact** when your Redtail database has one, otherwise under **General Information**. The note contains:

- A title with the direction, the result, the Allo user and the duration, for example `Allo Inbound Call - Answered - Jane Doe (5:12)`
- The Allo line and the contact's number
- The date and time of the call, in UTC
- The Allo user's name and email
- The call tags
- The call summary
- A link to the recording

The call transcript is not added to the note.

Redtail CRM dates the note to when Allo writes it and shows the connected Redtail user as its author: Redtail does not let an integration set either one. The time of the call and the Allo user are written in the note.

Redtail notes can't be edited. When the call summary arrives later, or when you change a call's result or tags in Allo, Allo adds a comment to the same note that starts with `Allo update:`.

## How SMS are synced

Each SMS is logged as its own note on the matching contact, titled `Allo Text Message`, with the Allo line, the date in UTC, the direction, the Allo user and the message content.

## Click-to-call

When Redtail CRM shows a phone number as a phone link, clicking it opens the call in the Allo app, which handles phone links on your device. The Allo app must be installed. You can also call any synced Redtail contact from Allo directly.

## 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 says the username or password is incorrect, sign in to Redtail CRM with the same username and password to check them, then connect again.
  </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 phone number doesn't belong to any contact the connected Redtail user can see. By default, Allo only syncs calls to existing contacts. To auto-create contacts, go to your integration settings and enable **Create lead on unknown calls**.
    - **Contact deleted**: the contact was removed from Redtail CRM. Allo is additive and won't sync calls for deleted contacts. Re-create the contact in Redtail CRM, then retry the sync.
    - **Integration disconnected**: the connected Redtail user was deactivated in Redtail CRM. Allo still appears connected but requests fail. Disconnect the integration in Allo and connect again with the login of an active Redtail user who can see all your clients.
    - **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 Redtail 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="Contacts not syncing">
    Allo syncs changes from Redtail CRM every **15 minutes**, with a full refresh once a day. The first sync can take longer for large databases.

    Allo only syncs contacts that have at least one phone number other than a fax number. Contacts without a phone number will not appear in Allo.

    Allo only sees the contacts the connected Redtail user can see. If some clients are missing, check that this Redtail user can see them in Redtail CRM, or reconnect with a Redtail user who can see all your clients.

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

  <Accordion title="SMS not synced">
    Each SMS is a separate `Allo Text Message` note on the contact in Redtail CRM.

    If the note is missing, verify the integration is connected in **Settings** > **Integrations** and that **Push text messages to your CRM** is enabled in the integration settings. Then 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 Redtail CRM has several contacts with the same phone number, they appear as separate contacts in Allo.

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

  <Accordion title="Call synced to the wrong contact">
    Family members often share a home phone number in Redtail CRM. When several contacts have the same number, Allo logs the call on an individual rather than a business or a trust, then on the contact whose primary phone is that number, then on the contact for whom the number is a mobile number, then on the most recently updated contact. Click the integration indicator on any call in the web app to see exactly which contact it was synced to.
  </Accordion>
</AccordionGroup>
