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

# Front

> Import every Allo call and SMS into a Front inbox, in one conversation per contact and Allo line, and sync your Front contacts and accounts to Allo

The Front integration imports each Allo call and SMS into the Front inbox you choose. Calls and SMS between one contact and one Allo line share one Front conversation, so your team reads them next to the contact's emails and chats. A call arrives as a message with the call details, the AI summary, a link to the recording and the transcript. An SMS arrives as a plain SMS bubble.

Your Front contacts and accounts sync to Allo, so callers show up with their Front name and account.

> [!NOTE]
>
> SMS are one-way in Front: Allo logs them in Front, but a reply typed in Front is not sent to your customer. Reply from Allo instead.

## How to connect

The Front integration connects with a Front API token. You need an Allo admin or manager to connect the integration, and a Front admin to create the API token.

### Create a Front API token

**1. Open the API tokens settings**

In Front, click the gear icon, then go to **Company settings** > **Developers** > **API Tokens**. Only Front admins see this page.

**2. Create the token**

Click **Create API token** and name it "Allo".

**3. Choose the scopes**

Give the token access to **Global resources** (contacts and accounts) and **Shared resources** (your shared inboxes). Add **Private resources** only if you want Allo to write to a private inbox. Allo reads contacts, accounts, inboxes, teammates, conversations and messages, and writes contacts, messages and comments.

**4. Copy the token**

Copy the API token. You paste it into Allo in the next step.

The token belongs to your Front company, not to one teammate, so the connection keeps working when people leave.

> [!TIP]
>
> Create a dedicated shared inbox in Front, for example "Allo calls", before you connect. Allo then writes to that inbox only, and your other inboxes stay as they are. This is optional: Allo can write to any inbox the token can reach.

### Connect in Allo

**1. Go to Integrations**

In Allo, go to **Settings** > **Integrations**.

**2. Find Front**

Find **Front** in the **Support** section and click **Connect**.

**3. Paste the API token**

Paste the token in the **API token** field and click **Save & Connect**.

**4. Choose the inbox**

Go to **Settings** > **Integrations** > **Front**, choose the Front inbox Allo writes to in **Inbox**, and click **Save**.

> [!WARNING]
>
> Allo sends nothing to Front until an inbox is chosen. Calls and SMS made before you choose one are not sent.

### Choose your support lines (optional)

Support lines decide which Allo lines send calls and SMS to Front. Only calls and SMS on the selected lines are sent. Calls and SMS on any other line are not sent at all, so sales or personal conversations never reach your Front inbox.

To send every call and SMS, leave the selection on **All lines**.

To choose support lines, go to **Settings** > **Integrations** > **Front**, open **Support lines**, select the lines and click **Save**.

> [!NOTE]
>
> For an inbound call or SMS, the line is the number the customer dialed or texted. For an outbound call or SMS, the line is the number shown to the customer.

### Conversation settings (optional)

Three settings in **Settings** > **Integrations** > **Front** decide how the conversations Allo creates behave in Front:

* **Leave new Allo conversations open:** on by default. Turn it off to archive the conversations Allo creates, so they do not add to your team's open queue.
* **Run Front rules on Allo messages:** on by default. Turn it off if your Front rules should ignore the calls and SMS Allo imports.
* **Assign conversations to the Allo user:** off by default. Turn it on to assign each conversation to the Front teammate whose email matches the Allo user's email.

### Create unknown callers in Front (optional)

The **Create unknown callers in Front** setting decides what happens when a caller or SMS sender is not a Front contact yet.

* **On:** Allo creates the caller as a new Front contact, named after the Allo contact (or after the phone number if the Allo contact has no name), with its phone numbers and emails. Allo then logs the call or SMS.
* **Off:** calls and SMS from numbers that are not Front contacts are not sent to Front.

The setting is off by default.

## What syncs

**From Front to Allo:**

* Contacts that have a phone number, with their name, first email, phone numbers, description, contact lists, avatar, custom fields and account
* Accounts, with their name, website (from the first domain), description, logo and custom fields

**From Allo to Front:**

* Calls and SMS, imported as messages in the inbox you chose
* Updates to a call's summary, result or tags, as an internal comment
* New contacts, when **Create unknown callers in Front** is on

**Sync direction:** Two-way. Calls and SMS are sent to Front as they happen. The first sync imports all your Front contacts and accounts. After that, Allo checks for changed contacts every 10 minutes and for changed accounts every hour. Once a day, Allo reads every contact again to refresh the account each contact belongs to.

Contacts without a phone number are not imported, because Allo cannot match them to a call or SMS. A contact whose last phone number is removed in Front is removed from Allo at the next sync. Contacts and accounts deleted in Front are not removed from Allo.

When Allo finds an existing Front contact for an Allo contact, it only fills in what is missing: phone numbers and emails the contact does not have yet, and the name if it is empty. Allo never overwrites what your team typed in Front.

Allo matches the Front contact by phone number. Allo looks the number up in its international format first, such as `+14155551234`, then in a few national formats, then among the recipients of your Front conversations.

## How calls are synced

After each call on a support line, Allo imports the call as a message into your Front inbox. Front puts it in the conversation for that contact and that Allo line, so all calls and SMS between them stay together. Importing a message never sends anything to your customer.

The call message has:

* A subject with the call details, for example `Allo Inbound Call to US Support (+18885550100) - Answered - Leo (2m 03s)`
* The call direction and result, the duration, and the from and to numbers with names
* The Allo line and the Allo user who handled the call, and the call tags
* The AI summary
* A link to the call recording, or to the call in Allo when there is no recording
* The call transcript, with speaker names when available. A very long transcript is replaced by a link to the call in Allo.
* The tag `allo-call` on the conversation

The message shows the real start time of the call. For an outbound call, the message is written as the Front teammate whose email matches the Allo user's email.

If the same call is sent to Front twice, Front keeps one message.

### When a call is updated

A message imported into Front cannot be edited. When the call's summary, result or tags change in Allo after it was sent, Allo adds an internal comment, **Allo call updated**, to the call's conversation with the new values. Comments are only visible to your team.

## How SMS are synced

After each SMS sent or received on a support line, Allo imports it as an SMS message in the same Front conversation as the calls with that contact on that Allo line. The message holds the SMS text only, so it reads like a real SMS, inbound or outbound. The conversation gets the tag `allo-sms`.

SMS are one-way: replies typed in Front are not sent to your customer. Reply from Allo.

## Click-to-call

Click-to-call is not available for this integration.

## 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 rejects your API token, check that it was copied in full and that it was not revoked in Front. Only Front admins can create API tokens.

> [accordion] Call or SMS not synced to Front
>
> Check these causes, in this order:
>
> * **No inbox is chosen.** Allo sends nothing until you choose an inbox in **Settings** > **Integrations** > **Front**.
> * **The call or SMS was not on a support line.** Only calls and SMS on your selected support lines are sent to Front. Check **Support lines**, or select **All lines** to send everything.
> * **The caller is not a Front contact.** With **Create unknown callers in Front** off, calls and SMS from unknown numbers are not sent. Add the phone number to the Front contact, or turn the setting on.
> * **The token is missing a scope.** The token needs Global resources and Shared resources (or Private resources for a private inbox), with write access to messages. Create a new token with the scopes in [Create a Front API token](#create-a-front-api-token), then disconnect Front in Allo and connect again.
> * **The token was revoked.** Allo still appears connected but requests fail. Disconnect Front in Allo and connect again with a new token.
> * **Front rate limits.** Front limits API calls per minute for the whole company, shared by every token (50 per minute on the Starter plan). If the limit is reached, the call or SMS may fail: wait a minute and sync it again from the call list.

> [accordion] A Front contact does not appear in Allo
>
> Check these causes:
>
> * **The contact has no phone number in Front.** Allo only imports contacts with a phone number. Add the number in Front; Allo imports the contact at the next sync.
> * **The sync has not run yet.** Allo checks Front every 10 minutes for changed contacts.

> [accordion] The contact's company is missing in Allo
>
> Front gives the account of a contact only from the account side, so Allo refreshes the link once a day. A contact added to an account today shows its company in Allo after the next daily refresh.

> [accordion] I replied to an SMS in Front and the customer did not receive it
>
> SMS imported by Allo are one-way. Front has no channel to send a reply through, so replies typed in Front are not sent. Reply from Allo.

> [accordion] Allo conversations fill my team's queue
>
> Turn off **Leave new Allo conversations open** to archive the conversations Allo creates, or choose a dedicated inbox for Allo. You can also filter on the `allo-call` and `allo-sms` tags in Front views and rules.


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