Migration

​

Migrate Contacts & Custom Fields

XpressBot One includes a built-in migration tool that allows you to import your existing data from the previous version of XpressBot. Using your API key from the old platform, you can securely migrate:

• Contacts
• Labels
• Custom Fields
• Teams

​

Step 1: Open XpressBot One

Visit the new platform and log in to your account. 👉 https://one.xpressbot.org

​

Step 2: Go to Settings → Migration

From the left sidebar, navigate to Settings and select Migration.

​

Step 3: Select Migration Source

Choose XpressBot as the migration source.

​

Step 4: Enter Your Old API Key

Paste the API key from your previous XpressBot account. 👉 https://app.xpressbot.org/api/developer/console

​

Step 5: Select Data to Import

Choose the data types you want to migrate. You can import all available data or select only the items you need.

​

Step 6: Start the Migration

Click Start Import to begin the migration process. Your selected data will be transferred automatically to XpressBot One.

---

​

Update Your Permanent Access Token

If you connected your WhatsApp number directly using the official WhatsApp Cloud API (without using Embedded Signup), you must manually update your Permanent Access Token in XpressBot One. For security reasons, access tokens are encrypted and are not migrated automatically. You will need to retrieve your token from your existing setup and update it in the new platform. Follow the steps below to update your permanent access token and verify that your WhatsApp Business channel is configured correctly.

​

Step 1: Log in to Your XpressBot Account

Sign in to your XpressBot workspace using your account credentials.

​

Step 2: Open the Channels Page

Click the Channels icon from the left-hand navigation menu.

​

Step 3: Select Your WhatsApp Channel

Locate your WhatsApp channel and click on it to open the channel details.

​

Step 4: Open Channel Settings

Click the Settings icon to access your WhatsApp channel configuration.

​

Step 5: Update Your Permanent Access Token

In the settings popup, locate the Access Token field and paste your latest permanent access token from the Meta for Developers portal.

Important: If your token has expired, your WhatsApp channel will stop sending and receiving messages until a new token is added.

​

Step 6: Run the Health Check

Click the Refresh icon to run a health check and validate your configuration.

​

Understanding Health Check Results

• ✅ No Red Errors — Your WhatsApp channel is configured correctly.
• 🟡 Yellow Warnings — Informational messages only and can usually be ignored.
• ❌ Red Errors — Configuration issues that must be resolved before messaging will work.

---

​

Configure Webhook in Facebook Developer Dashboard

​

Step 1: Adding webhook to developer Account

Go to WhatsApp → Configuration → Webhooks in the Facebook Developer Dashboard.

​

Step 2: Paste the following details:

Click Verify and Save.

​

Step 4: Subscribe specifically to the following field:

Under Webhook Fields, click Manage.

---

​

Completion

You have successfully configured the WhatsApp Business API webhook integration. This permanent access token and webhook configuration ensure secure, stable, and continuous API communication for WhatsApp messaging within your environment. Once the health check completes successfully, your WhatsApp Business channel is ready to:

• Send and receive WhatsApp messages
• Run automation workflows
• Send template broadcasts
• Manage conversations in the shared team inbox

---

If your WhatsApp channel stops working unexpectedly, the first thing to verify is whether your permanent access token is still valid.

🔐 Access tokens are sensitive credentials and are intentionally not migrated automatically to protect your WhatsApp Business Account.

🚀 We recommend migrating to XpressBot One as soon as possible, as the legacy version of XpressBot will be discontinued in the near future.