Integration with WhatsApp


Step 1: Getting Started with WhatsApp Integration

  1. Go to shopify and install HeiChat

Step 2: Setting Up Meta (Facebook) Business Account and App

  1. Create a Meta (Facebook) Business Account:
  • Visit here.
  • Enter your business name, your name, and work email address. Click "Next".
  • Provide your business details and click "Submit".
  • Enter your business details and click Submit.


2. Create a new Meta (Facebook) App at https://developers.facebook.com/.

  • "Log in" to your Meta (Facebook) Developer Account.
  • Choose User Case: "Other" and click "Next".
  • Choose App Type: "Business" and click "Next".
  • Provide app details: App Name, App Contact Email, Business Account (Optional), and click "Create app".

Step 3: Setting Up Meta (Facebook) App for WhatsApp Integration


1. Add WhatsApp to your Meta (Facebook) App.

  • In the "Developers Dashboard", choose your app.
  • Locate "Add products to your app" in your app's dashboard tab.
image.png
  • Choose "WhatsApp" for setup.
image.png
  • Select your Meta (Facebook) Business Account (if not selected in step 2).
  • Navigate to App settings > Basic from the sidebar

image.png

Set the Privacy Policy URL to https://heichat.net/help-center/privacy-policy
image.png

  • Save changes.
  • Set App Mode to Live.
image.png

Step 4: Generate WhatsApp Token


To obtain a permanent WhatsApp Access Token, follow 1 to 3 steps:
1. Create a "System User":

  • Visit the Meta Business Suite.
  • Find your business account in the top-left dropdown menu and click its Settings (gear) icon.
  • Click Business Settings.
image.png
image.png
  • Add an Admin system user.
    image.png
  1. Add Assets.
  • After creating the system user, click on Add Assets.
image.png
  • Navigate to Apps > "Your app name".
  • Select your app and grant full control to manage the app.
    image.png
  1. Generate System User Access Tokens.
  • Click the Generate New Token button on the system user.
    image.png

Choose the app that will use the token and set the token expiration to never.

image.png

  • Select "whatsapp_business_messaging" and "whatsapp_business_management" permissions.
image.png
  • Generate the token.
  • Copy the access token and store it securely.
    image.png
  1. Add a new Business Number for WhatsApp
  • You can use your own business number or utilize the provided test number for your WhatsApp chatbot.
  • In WhatsApp Developer Dashboard, navigate to WhatsApp > API Setup from the sidebar.
    image.png
  • Proceed to "Step 5: Add a Phone Number," click Add phone number.
image.png
  • Provide details required in the following form.
image.png
  • Verify your number using the received code.
  • Once successfully added, select your phone number in Step 1 of API Setup.

image.png

5. Add a Payment Method

  • To send messages via WhatsApp, you need a valid payment method. Visit here for details.
  • After adding your business phone number, click "Add payment method" to address the "Missing valid payment method" alert.
image.png
  • You'll be directed to your WhatsApp account settings. Click "Payment Methods" > "Add business payment method" and follow the prompts to add your card info.

image.png

6. Test your new Business Number for WhatsApp

  • Return to WhatsApp Developer Dashboard, navigate to API Setup > Step 1.
  • Enter a testing "To" number.
  • Click "Send message" to verify successful message delivery.
image.png

Step 5: Configure WhatsApp API Webhook settings

  1. Verify WhatsApp Webhook Callback.
  • In WhatsApp Developer Dashboard, navigate to Configuration.
  • Under Webhook, click edit
image.png
  • Copy the Callback URL and Verification Token from HeiChat WhatsApp Integration page(or HeiChat email) to your WhatsApp Developer Dashboard.
image.png
  • Click Verify and save
  1. Configure Webhook Subscription Field
  • Under "Webhook Fields," click Manage.
image.png
  • Find the "messages" field and subscribe to it by checking the box.
image.png

Step 6: Connect your Whatsapp account with HeiChat


1. Retrieve WhatsApp Account Information

  • In WhatsApp Developer Dashboard, navigate to App Settings > Basic
  • Copy App secret in **Facebook App Secret **
  • Copy the permanent access token generated from Step 4.3
  • Copy your Phone Number,Paste them to HeiChat backend and save

If you have any problems feel free to contact HeiChat's email(heicarbook@gmail.com)