WhatsApp History Sync

WhatsApp History Sync

Overview

WhatsApp History Sync allows you to import your previous WhatsApp Business data into Flovoo when history sync is available for the channel.

The data that can be imported includes:

• Contacts.
• One-to-one conversations from the last 6 months.
• Sent and received messages.
• Available media files from the last 14 days.

This feature is available only for WhatsApp API Coexistence channels, which allow you to continue using the WhatsApp Business App alongside the API connection.

Important: WhatsApp History Sync is a one-time import process and is different from Contact Sync settings, which control ongoing synchronization of new contact changes.

When Is WhatsApp History Sync Available?

After connecting a WhatsApp API Coexistence channel, History Sync is available for 24 hours.

When sync is available, the Start Sync button appears in the channel row.

You can click the information icon next to the option to see how much time remains to start the sync.

Note: If the 24-hour window expires before you start the sync, the status changes to Expired, and History Sync is no longer available through the current channel.

Start WhatsApp History Sync

When the Start Sync button appears next to your WhatsApp channel, you can use it to start the sync process.

After clicking Start Sync, the Choose what to import window appears, allowing you to select the data you want to import.

Choose What to Import

The window includes three options:

Import all contacts & conversations
Imports all contacts, along with one-to-one conversations from the last 6 months.

Import conversations with their contacts
Imports one-to-one conversations from the last 6 months, along with the contacts associated with those conversations.

Import contacts only
Imports contacts only, without conversations.

Select the option that best fits your needs, then click Start Sync to begin the sync process.

What Data Is Synced?

Depending on the option you select, the sync can include:

• Contacts.
• One-to-one conversations from the last 6 months.
• Sent and received messages.
• Media files such as photos, videos, documents, and voice messages, available only from the last 14 days.

Important: Only one-to-one conversations are synced. Group conversations are not included.

Track the Sync Progress

After starting the sync, the process runs in the background, so you can continue using Flovoo while it completes.

The sync status appears on the Channels page as Syncing X%, along with a mini progress bar.

A floating Sync Progress Panel also lets you track the sync while navigating through the platform.

The panel can contain multiple sync jobs, with each job showing its own status, such as:

• Queued
• Running
• Completed
• Failed

After the Sync Is Completed

When the sync is complete, the Completed status appears next to the channel.

You can click the status or the information icon to open View Details and see a summary of the sync, including:

• Number of imported contacts.
• Number of imported conversations.
• Completion time.
• Sync duration.

If the Sync Fails

If the sync cannot be completed, the Failed status appears with the information icon.

You can open the details to see the reason for the failure. A Contact Support option may also be available to contact the support team.

Note: A Retry option is not currently shown in the sync experience according to the PRD.

If History Sync Is Unavailable

The Unavailable status may appear if WhatsApp chat history was not shared during channel setup.

In this case, the sync button does not appear.

To enable History Sync, you need to offboard the channel and connect it again with history sharing enabled during setup.

If the Sync Window Expires

If the 24-hour window passes before you start the sync, the status changes to Expired.

In this case, you cannot start History Sync through the current channel. To enable sync, you need to offboard the channel and connect it again with history sharing enabled during setup.

Frequently Asked Questions