How to set up WhatsApp in Skyone Studio

This documentation was created to assist with the configuration of WhatsApp Business in Skyone Studio, ensuring that you follow all the necessary steps for proper integration.

Key Terms (Glossary)

  • Meta for Developers: Meta’s (Facebook’s) official tool for creating and configuring applications and integrations, including WhatsApp Business.

  • Access Token: Code used to authenticate communication between Skyone Studio and WhatsApp Business.

  • Webhook: URL used to receive events and messages from WhatsApp Business.

Configuration Steps

To configure WhatsApp Business, you will need to be simultaneously working in two products: Skyone Studio and Meta for Developers.

To complete this configuration, you will need:

  • A developer account in Meta for Developers;

  • Access to Skyone Studio;

  • A workspace compatible with the AI 01 package or higher, which allows the creation of AI agents.

This integration setup will be carried out in 4 main steps, covering the creation of the application in Meta for Developers, generation of the Access Token, use of WhatsApp data in Skyone Studio, and final adjustments in Meta for Developers.

Each step is essential to ensure the integration works properly and without interruptions.

Steps:

  1. [ Step 01 ] Create an app in Meta for Developers: Create the application that will serve as the foundation of the integration and provide the WhatsApp credentials.

  2. [ Step 02 ] Generate the Access Token: Generate the token that Skyone Studio will use to authenticate the connection.

  3. [ Step 03 ] Use the WhatsApp Data in Skyone Studio: Enter into Skyone Studio the information obtained from Meta for Developers.

  4. [ Step 04 ] Finalize the configuration in Meta for Developers: Complete the setup and validate the integration with WhatsApp.

Step 1: Create an app in Meta for Developers

Before creating the application, make sure you have an active developer account in Meta for Developers.

  1. Go to Meta for Developers and click "Create App".

  1. In App Details, enter a name for the application and a contact email, then click “Next.”

The chosen name will be displayed on the My Apps page and will be associated with the application ID. It can be changed later in the settings.

Use an email address that you check regularly, as Meta will use it to contact you regarding policies, restrictions, or to help recover the application if it is deleted or compromised.

  1. Under Use Case, select Other and click "Next".

  1. In the Business Type step, select Business and click "Next".

  1. Select the desired business portfolio and click “Create App.”

In Meta for Developers, the portfolio brings together business account assets such as applications, pages, and WhatsApp numbers. Choose the correct portfolio to ensure that the application is linked to the appropriate resources.

Step 2: Generate the Access Token

There are two configuration modes:

  • Development Mode: Ideal for validation and testing. We recommend using this mode to perform tests before publishing to production. This allows you to validate the system’s functionality without affecting real users.

  • Live Mode: For final use in a production environment. Use this mode only after ensuring that everything is working correctly in tests, so the service is available to end users.

  1. In the side menu, go to WhatsApp and click “Set Up.”

  1. On the configuration screen, click "API Setup".

  2. Click "Continue".

  1. Select “Generate Access Token.”

  • Choose the WhatsApp account provided for testing by Meta. At this stage, we use the test account provided by Meta; however, it is also possible to enter the company’s phone number. To do this, simply configure it, keeping in mind that:

    • The number cannot be linked to any existing WhatsApp account.

    • It must be new and dedicated exclusively to this setup.

    • It must be a Business number (WhatsApp Business).

  • Click “Continue” and, at the end, “Save.”

Important: The token generated in development mode is valid for only 1 hour.

  1. After creating the token, click "Got it to complete this step.

Step 3: Use the WhatsApp Data in Skyone Studio

  1. Access Skyone Studio.

  2. In the Integrations menu, click "Publish", located on the right side of the screen.

  3. Select "WhatsApp".

Before proceeding to Skyone Studio, make sure to record all the codes provided by Meta, such as the ID, phone number, and other information required for the configuration.

  1. Fill in the fields with the information obtained from Meta for Developers:

  • Agent Flow: Select a flow previously created in Skyone Studio.

  • Name: Enter a name for this publication.

  • Number ID: You can find this in Step 2, in the URL shown at the beginning of the code. Example: In the URL https://graph.facebook.com/v22.0/123456789/messages, the ID is 123456789.

  • Number: Use the configured number (for example, the test number).

  • Token: Enter the generated token.

  • API Secret:

    • In the app menu, go to "Settings".

    • Select "Basic.

    • Click "Show next to App Secret to reveal the value.

After filling in all the fields, click "Save publication". The platform will display the details of the established connection.

Step 4: Finalize the configuration in Meta for Developers

  1. In the Meta Developers menu, select WhatsApp and click "Configuration".

  1. Fill in the following fields with the data from Skyone Studio:

  • Callback URL: Paste the value from the Webhook field.

  • Verification Token: Paste the value from the Verification Token field.

  1. In Webhook Fields, confirm that the Messages option is checked as Subscribed.

  2. Click “Verify and Save.”

Done! The WhatsApp Business configuration in Skyone Studio is now complete and ready for use.

FAQ – WhatsApp Configuration in Skyone Studio

Do I need a specific account to complete the configuration?

Yes. You need a developer account in Meta for Developers and access to Skyone Studio.

How can I create a developer account in Meta for Developers?

You can find the step-by-step guide and official documentation for creating a developer account on the following page:

Sign Up – Meta for Developers

This page contains the official registration process, including the steps to start the sign-up, agree to the terms, verify your account, and select your profession.

Can I run the configuration in test mode?

Yes. Development Mode is recommended for validation and testing, but the token generated will only be valid for 1 hour.

Where can I find the WhatsApp number ID?

The ID can be found in Step 2, in the API URL provided. Example: https://graph.facebook.com/v22.0/123456789/messages → The ID is 123456789.

Is it mandatory to finalize the configuration in Meta for Developers?

Yes. This step is required to link the application to the WhatsApp number and validate the webhook.

PreviousPublishing Agent FlowsNextHow to Set Up Slack in Skyone Studio

Last updated