WhatsApp Coexistence & History Import
Keep using your existing WhatsApp Business mobile app while connecting to Omni Chat Stack—with 6-month 1:1 chat history sync, two-way mirroring, and manual chat imports.
Keep your number and your mobile app
Traditional WhatsApp Business API onboarding forces you to disconnect the WhatsApp Business mobile app. With WhatsApp Coexistence, you connect the exact same phone number to Omni Chat Stack while continuing to read and reply from your phone whenever you want.
Keep replying from your phone on the exact same number
6 months 1:1 text backfill + real-time two-way sync
Multi-agent assignment, AI chatbot & broadcasts
What syncs vs. what stays local
| Item | Coexistence Behavior |
|---|---|
| 1:1 Text History (last 6 months) | Automatically backfilled into Omni Chat Stack during onboarding or via manual trigger (POST /api/v1/whatsapp/coexistence/sync). |
| Ongoing 1:1 Messages | Mirrored two-way in real time between the mobile WhatsApp Business App and the Shared Team Inbox. |
| Contacts | Synced automatically into your Omni Chat Stack Customers directory. |
| Photos, Videos, Locations & Groups | Not synced via Meta’s automated Coexistence backfill (individual media can be imported manually via Export Chat). |
Resetting Coexistence backfill
Admins can inspect sync status at GET /api/v1/whatsapp/coexistence/status or clear only the one-time backfill via DELETE /api/v1/whatsapp/coexistence/history without disturbing ongoing live message mirroring.
Manual WhatsApp Chat Export import
Need transcripts older than 6 months or media from specific customer chats? Export the conversation from WhatsApp ("Export Chat" with or without media) and upload the .txt or .zip archive in Settings → WhatsApp Import (/settings/whatsapp-import).
- Full audit & rollback: Every import run is logged with message and media counts. Admins can delete a specific import run cleanly without affecting live conversations.
- Rate limit: Up to 10 history import requests per minute per workspace; max upload size is 10 MB per archive.