WhatsApp Cloud API

Set up

To set up the integration of your assistant in WhatsApp Cloud API, you will need the following:

  • A Facebook account registered in the developers console.

  • A Facebook page connected to Meta Business.

  • An available phone number.

Create a Meta app

  1. Click on 'Create application', select 'Other', and then click on 'Continue'.

  2. Select 'Business' in the next step.

  3. In the form, fill in all fields and click on 'Create application'.

  4. Access the application you just created, go to the 'Dashboard' section, find the WhatsApp module, and click on 'Configure'.

  5. Select your Meta Business account or click 'Create a business account' to continue.

Add your phone number

  1. Go to the WhatsApp > Quickstart menu section.

  2. In step 5, click on 'Add a phone number', fill in the details, and validate the link with the WhatsApp Business API account through the confirmation SMS.\

Generate a Permanent Access Token

  1. Navigate to Facebook Business.

  2. From the side menu, select Users > System Users.

  3. Add a new user with administrator privileges.

  4. In the side menu, go to Accounts > WhatsApp Accounts.

  5. Grant full control permissions to the newly created user.

  6. Return to the System Users section and click on Assign Assets.

  7. Choose the desired application and assign admin permissions.

  8. Once saved, click on Generate New Token.

  9. Select the application, set the expiry to Never, and enable WhatsApp permissions.

  10. Copy the generated authentication token for future use.

Obtain the Phone Number ID

  1. Access to the created application.

  2. Go the WhatsApp > Quickstart menu section.

  3. Select the linked phone and copy the ID displayed below it (Phone Number ID).

Obtain the application secret key

  1. Access to the created application.

  2. Go the Settings > Basic Information menu section.

  3. Click show and copy the application secret key.

Connect your app with your assistant

Activate integration in 1millionbot platform

  1. Go to the Channels section on the platform.

  2. Activate WhatsApp and click on 'Settings'.

  3. Enter the previously obtained data: Application Secret Key, Permanent Access Token and Phone Number ID

  4. Click on 'Save'.

Activate integration in Meta

Obtain the Callback URL

  1. Go to the 1millionbot platform and click on the 'Info' button in the WhatsApp Cloud channel to get the callback URL.

Configure the Meta Webhook

  1. In the WhatsApp > Settings menu section of the Meta developers console, click on 'Edit' in the Webhook section.

  2. Paste the callback URL obtained from the 1millionbot platform and enter the Permanent Authentication Token.

  3. Click 'Save' to apply the changes.

Set permissions

  1. In the WhatsApp > Settings menu section, click on 'Manage' to activate the necessary Webhook permissions: - messages

  2. Click 'Save' to apply the changes.

Publish Meta app

  1. Now, your application is in development mode, so you can test the assistant's operation as long as the phone number you use to interact with the assistant belongs to one of the users with access to the application.

  2. To publish the assistant for public interaction, change the mode from development to production and provide all the necessary information (found at the top of the Meta developer console).

  3. Done! Once published, perform tests to verify the operation of your assistant on the provided phone number in WhatsApp. 🎉

Limitations

  • Initial limit of 1000 conversations per day (+ info).

  • Maximum of 3 buttons per message.

  • Each button can have a maximum of 20 characters.

Last updated