Whatsapp ChatBot Installation

This documentation explains step-by-step how to configure the Meta WhatsApp Business API and integrate it into the Autom Mate platform. Each step is detailed and supported with warnings, tips, and recommendations where critical.


πŸ”Ή 1. Creating a Meta Developer Account

  • Log in with your Facebook account.

  • Click β€œGet Started” or β€œMy Apps” in the top-right corner of the page to activate your developer account.

πŸ’‘ Tip: You may be required to verify your email and answer a few basic questions to activate the developer account.


πŸ”Ή 2. Creating a Meta Business (Business Portfolio)

  • Create a new Business Account by entering a name, business type, and address details.

  • Connecting a business portfolio to your app is only necessary for certain products and permissions. When you request access to these, you will be asked to link a business portfolio.

  • You may need to verify your business.

⚠️ Warning: A verified Business Account may be required to use the WhatsApp Business API. However, verification is not mandatory for initial setup and testing.

🟑 Note: After this step, you will be able to link your app to this Business account (see Step 3).


πŸ”Ή 3. Creating an App

A screenshot of a computer AI-generated content may be incorrect.
  • Enter the App Name and Contact Email.

A screenshot of a computer AI-generated content may be incorrect.
  • In the Use Case selection screen, set the filter to All and select Other at the bottom of the list.

A screenshot of a computer AI-generated content may be incorrect.
A screenshot of a computer AI-generated content may be incorrect.
  • Choose Business as the App Type.

  • Once you proceed, the Business Account you created in Step 2 will be listed β€” select it to connect the app to your Business account.

A screenshot of a computer AI-generated content may be incorrect.
A screenshot of a computer AI-generated content may be incorrect.

πŸ’‘ Tip: All future permission and access operations will be managed through this Business account. Make sure to select the correct one.


πŸ”Ή 4. Creating a System User and Granting Permissions

  • In Business Manager, go to the left menu: Users > System Users.

  • Click Add to create a new System User and assign the Admin role.

  • Select the created user and click Assign Assets to link the previously created app to this user.

A screenshot of a computer AI-generated content may be incorrect.
A screenshot of a computer AI-generated content may be incorrect.

⚠️ Warning: A system user cannot be created without an app. Therefore, app creation comes before this step.


πŸ”Ή 5. Creating a Permanent Access Token

  • On the System User page, click Generate Token.

A screenshot of a computer AI-generated content may be incorrect.
  • Select your app.

  • Set Token Expiry to Never.

  • Be sure to select the following permissions:

    • whatsapp_business_management

    • whatsapp_business_messaging

    • whatsapp_business_manage_events

A screenshot of a computer AI-generated content may be incorrect.

πŸ’‘ Tip: Select only the required permissions. Unnecessary ones may cause your app to be rejected or flagged by Meta.

⚠️ Warning: Save this token! You won’t be able to view it again. It will be used inside the Autom Mate Vault.


πŸ”Ή 6. Setting the Privacy Policy URL

  • In the developer panel, go into your app.

  • Go to Settings > Basic on the left menu.

  • Paste a valid privacy policy URL into the Privacy Policy URL field.

A screenshot of a computer AI-generated content may be incorrect.

🟑 Note: Leaving this field empty may prevent your app from accessing certain permissions as per Meta’s policies.


πŸ”Ή 7. Starting WhatsApp API Setup

  • On your developer app’s homepage, go to Set Up > WhatsApp tab.

A screenshot of a computer AI-generated content may be incorrect.
  • Click the Start Using the API button.

A screenshot of a computer AI-generated content may be incorrect.

πŸ”Ή 8. Adding and Verifying a Phone Number

  • The system will direct you to the API Setup screen.

  • Add a new phone number here.

A screenshot of a computer AI-generated content may be incorrect.
A screenshot of a computer AI-generated content may be incorrect.

⚠️ Warning: The number must not have been used in any other WhatsApp account. If it has, that account must be deleted first.

  • Complete the number verification process.


πŸ”Ή 9. Retrieving the Phone Number ID

  • The verified number will be listed in the dropdown menu under the From field.

  • The Phone Number ID listed under the number will be used in the Autom Mate Vault.

A screenshot of a computer AI-generated content may be incorrect.

πŸ’‘ Tip: This ID won’t work with test numbers. It must be a verified, real number.


πŸ”Ή 10. Creating App Credentials in Autom Mate Vault

Required fields:

  • Token: The permanent token created in Step 5.

  • Phone Number ID: The number ID obtained in Step 9.

🟒 Result: You’re now ready to connect WhatsApp Business API with Autom Mate via the connector.

A screenshot of a computer AI-generated content may be incorrect.

πŸ”Ή 11. Setting Up the Webhook

  • In the developer panel, go to your application and navigate to the Webhooks section.

A screenshot of a computer AI-generated content may be incorrect.
  • For Callback URL, select the webhook trigger type in Autom Mate and paste the webhook URL.

image
  • Create a Verify Token and use the same value both in Meta and Autom Mate.

  • Click Verify and Save.

  • Finally, subscribe to the messages topic.

A screenshot of a computer AI-generated content may be incorrect.

⚠️ Warning: The Callback URL must work over HTTPS and be publicly accessible.


πŸ”Ή 12. Adding Payment Information

  • In Business Manager, go to the WhatsApp Accounts section.

  • Select your registered phone number.

  • Under Payment Methods at the bottom, enter a valid payment method.

A screenshot of a computer AI-generated content may be incorrect.

🟑 Note: Meta allows test usage in some regions, but for live usage, a payment method is mandatory.


πŸ”Ή 13. Registering the Number via Autom Mate

  • Create an Autom in Autom Mate.

  • Add a Restful Web Services > POST action.

πŸ”§ Settings:

URI: https://graph.facebook.com/vXX.X/<PhoneNumberID>/register

Headers:

Body:

  • Run the Autom to successfully register your number to the Meta system.

A screenshot of a computer AI-generated content may be incorrect.

🧩 Post-Integration Checklist

βœ… Token is permanent and securely stored βœ… Phone Number ID obtained correctly βœ… App Credentials added to Autom Mate βœ… Webhook and message topics activated βœ… Payment information completed βœ… Register process completed successfully


After completing all configuration steps, test your WhatsApp connection as shown in the video below. This ensures that the integration has been successfully established.

πŸ§ͺ If you encounter any errors during the test or experience issues such as messages not being delivered, please let us know in the comments section. Our community and support team will be happy to assist you.

πŸ“Œ Note: Make sure your API keys are correctly configured, your app is live in the Meta Developer Console, and all required permissions have been granted.


WhatsApp Business API Integration Test – Hello World Message via Autom Mate

This video demonstrates a basic integration test using the Meta WhatsApp Business API within the Autom Mate platform. It showcases the process of sending a simple β€œHello World” message and receiving a response through the integration.

πŸ“Ί Click to watch on YouTube: WhatsApp Guidearrow-up-right

https://youtu.be/rhBeK5VVwc8?si=L-zf_169Gsvk1uLmarrow-up-right

Last updated

Was this helpful?