# Como configurar o WhatsApp no Skyone Studio?

Esta documentação foi criada para auxiliar na configuração do WhatsApp Business no Skyone Studio, garantindo que você siga todas as etapas necessárias para a integração correta.

### Etapas de configuração

Para configurar o WhatsApp Business, você precisará estar simultaneamente em dois produtos:[ ](https://studio.skyone.cloud/)[Skyone Studio ](https://studio.skyone.cloud/)e [Meta for Developers](https://developers.facebook.com/apps).

Para executar esta configuração, é necessário:

* Conta de desenvolvedor no Meta for Developers;
* Acesso ao **Skyone Studio**;
* Espaço compatível com o pacote AI 01 ou superior, que permita a criação de agentes de IA.

A configuração desta integração será realizadas em etapas, passando pela criação do aplicativo no Meta for Developers, geração do Token de Acesso temporário, Definir Token de acesso permanente e utilização dos dados do WhatsApp no Skyone Studio e finalização das definições no Meta Developers.

Cada passo é essencial para que a integração funcione corretamente e sem interrupções.

Passos:

* [\[ Passo 01 \] Crie aplicativo no Meta for Developers:](#passo-1-crie-aplicativo-no-meta-for-developers) Crie o aplicativo que será a base da integração e fornecerá as credenciais do WhatsApp.
* [\[ Passo 02 \] Gere o Token de acesso](#passo-2-gere-o-token-de-acesso-temporario): Gere o token temporário.
* [\[ Passo 03 \] Gere o Token de acesso](#passo-2-gere-o-token-de-acesso): Gere o token que será usado pelo Skyone Studio para autenticar a conexão.
* [\[ Passo 03 \] Use os dados do WhatsApp no Skyone Studio](#passo-3-use-os-dados-do-whatsapp-no-skyone-studio): Insira no Skyone Studio as informações obtidas no Meta for Developers.
* [\[ Passo 04 \] Finalize a configuração no Meta Developers](#passo-4-finalize-a-configuracao-no-meta-developers): Conclua a configuração e valide a integração com o WhatsApp.

***

#### <mark style="color:blue;">Passo 1: Crie aplicativo no Meta for Developers</mark>

Antes de criar o aplicativo, certifique-se de que você possui uma **conta de desenvolvedor no Meta for Developers** ativa.&#x20;

1. Acesse [Meta for Developers](https://developers.facebook.com/apps) e clique em “**Criar aplicativo**”.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FfaC7FbPUcQWeZqwuRnb8%2FCaptura%20de%20tela%202025-04-07%20155209.png?alt=media&#x26;token=33c56f0b-4929-4064-8bcc-783fa3be8f5c" alt=""><figcaption></figcaption></figure>

2. Em **Detalhes do app**, informe um **nome** para o aplicativo e um **e-mail de contato**, depois, clique em '**Avançar'**.

   \
   O nome definido será exibido na página **Meus Apps** e ficará associado ao **ID do aplicativo**, podendo ser alterado posteriormente nas configurações.\
   \
   Utilize um **endereço de e-mail** que você acesse regularmente, pois ele será usado pelo Meta para entrar em contato sobre políticas, restrições ou para auxiliar na recuperação do aplicativo, caso ele seja excluído ou comprometido.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FYHaS2hHkm8Yw3ug3V6vY%2FA22820DE-CA69-416C-847D-9C4B1BF2C024.png?alt=media&#x26;token=783ac8ca-289d-4dfb-9da7-e9f23f9dbbdf" alt=""><figcaption></figcaption></figure>

3. Em **Casos de Uso**, selecione a opção "**Outro"** e clique em “**Avançar**”.&#x20;

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FAbAx6mZ8jJYm7TJAAJnO%2FCaptura%20de%20tela%202025-04-07%20161854.png?alt=media&#x26;token=a472fd58-3f4a-452b-92bb-59a8d2ba049d" alt=""><figcaption></figcaption></figure>

4. Na etapa **Tipo de empresa**, selecione "**Empresa**”, clique em “**Avançar**”.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FOK7GeUCOCFVa7FKKNIXs%2FCaptura%20de%20tela%202025-04-07%20163415.png?alt=media&#x26;token=b14b4df9-eda1-4070-bc0e-6b8c2562f74c" alt=""><figcaption></figcaption></figure>

5. Escolha o [portfólio empresarial](https://pt-br.facebook.com/business/help/1710077379203657) desejado e clique em “**Criar aplicativo**”.&#x20;

No Meta for Developers, o portfólio reúne ativos da conta de negócios, como aplicativos, páginas e números do WhatsApp. Escolha o portfólio correto para garantir que o aplicativo seja vinculado aos recursos adequados.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FEEKVWiwh0mfhg0IyiD6e%2F53986182-2BF2-4EA5-8E82-68FA439667C1.png?alt=media&#x26;token=6bc699b0-7b57-491c-ad53-3b0acfb43250" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Passo 2: Gere o Token de acesso temporário.</mark>&#x20;

1. No menu lateral na opção **WhatsApp,** clique em “**Configurar**”.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FmUBpPahR1GJwewQzZc8r%2F206F28A6-1E5B-4002-903A-493F40D46A82.png?alt=media&#x26;token=eb2314ab-be71-4a0d-9278-913397c136a4" alt=""><figcaption></figcaption></figure>

2. Na tela de configuração, clique em “**Configuração da API**”.
3. Clique em “**Continuar**”.&#x20;

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FVYzZS9fFLc9QwwGzLy9E%2F0443A47D-2B3D-4DD6-AF93-3EB694C8F15C.png?alt=media&#x26;token=eb40438c-4771-4a8e-9a5f-1d622eb046c3" alt=""><figcaption></figcaption></figure>

4. Selecione “**Gerar token de acesso**”.

* Ecolha a conta de **WhatsApp** disponibilizada para testes pelo **Meta**.\
  Nesta etapa, utilizamos a conta de teste fornecida pelo **Meta**; porém, também é possível inserir o número de telefone da empresa.\
  Para isso, basta configurá-lo, observando que:
  * O número não pode estar vinculado a nenhum **WhatsApp** existente.
  * Ele deve ser novo e dedicado exclusivamente a essa configuração.
  * É necessário que seja um número **Business** (**WhatsApp Business**).
* Clique em “**Continuar**” e, ao final, em “**Salvar**”.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FgcLfabzLleTDlsSpIvyd%2FA57E726C-6134-4AF4-B10B-13642F747681.png?alt=media&#x26;token=3a0a453a-130d-4dd8-839c-2ca54905bab0" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Importante: O token gerado em ambiente de desenvolvimento tem validade de apenas 1 hora.
{% endhint %}

5. Após a criação do token, clique em “**Entendi**” para finalizar esta etapa.

#### <mark style="color:blue;">Passo 4: Gere o token que será usado pelo Skyone Studio para autenticar a conexão.</mark>&#x20;

Aprendemos a gerar um token temporário e agora precisamos aprender a criar um token permanente para que suas configurações estejam completas. Para isso, siga as instruções:&#x20;

1. Acesso ao [business.facebook](https://business.facebook.com/business/loginpage/?next=https%3A%2F%2Fbusiness.facebook.com%2Fsettings)
2. Acesse as configurações de negócios.&#x20;
3. Selecione a conta comercial à qual seu aplicativo está associado.
4. Abaixo de **Usuários,** clique em "**Usuários do sistema"**.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FJzfRIMzcfuqeKCbKKghz%2FVmFVeGY4mh.png?alt=media&#x26;token=c515020b-53ec-4cba-b42a-6a0653650810" alt=""><figcaption></figcaption></figure>

1. Clique em "**Adicionar**".
2. Nomeie o usuário do sistema, selecione "Administrador" como função e clique em "Criar usuário do sistema".

{% hint style="info" %}
O número máximo de usuários administradores do sistema possível é 1.
{% endhint %}

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FSCAH6FFn7UU2XIg90ca8%2FqhabuDNPeJ.png?alt=media&#x26;token=2feea182-9533-4459-a564-01a5d4d6ec14" alt=""><figcaption></figcaption></figure>

1. Selecione a permissão whatsapp\_business\_messaging.
2. Clique em Gerar novo token.
3. Copie e salve seu token.

***

#### <mark style="color:blue;">Passo 3: Use os dados do WhatsApp no Skyone Studio</mark>

1. Acesse o **Skyone Studio**.
2. No menu **Integrações**, clique em “**Publicar**”, localizado na lateral direita da tela.
3. Selecione a opção **"WhatsApp".**

{% hint style="info" %}
Antes de seguir para o **Skyone** **Studio**, anote todos os códigos fornecidos pelo **Meta**, como ID, número de telefone e demais informações necessárias para a configuração.
{% endhint %}

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FTr9FV9ZaB19aZQmXu1lY%2F4B27EA1F-AFC4-4B0D-9FD6-472BA0F18A28.png?alt=media&#x26;token=603c780b-2d8e-422b-84a8-2463d31fbcfb" alt=""><figcaption></figcaption></figure>

### Selecione e preencha os campos exibidos no Studio.

1. Selecione o Fluxo de agente&#x20;
2. Selecione a conta que deseja usar para acessar suas configurações ou dados

***

#### Criação da conta

1. Clique em gerenciar conta;&#x20;

2. No modal exibido, clique em "**criar conta**";

3. Preecha os campos de:&#x20;
   1. **Nome:** Defina um nome para a publicação.
   2. **ID do número:** O ID pode ser identificado na Etapa 2, através da URL apresentada no início do código, por exemplo: Na URL <https://graph.facebook.com/v22.0/123456789/messages> , o ID é o 123456789.
   3. **Número:** Utilize o número configurado (exemplo: número de teste).
   4. **Token:** Insira o token gerado.
   5. **API Secret:**&#x20;
      1. Acesse “**Configurações**” do app no menu lateral do Meta.
      2. Selecione a opção “**Básico**”.
      3. Clique em “**Mostrar**” na opção **Chave Secreta do Aplicativo**.

4. Flag **Conta Pública:** Dentro do modal de conta terá disponível a flag de "**Conta Pública**". Caso deseje deixar com que a sua conta seja pública, ative a flag.&#x20;

Marque esta opção se desejar que o WhatsApp permita acesso público, sem autenticação do usuário.

{% hint style="info" %}
Uma conta pública pode ser vinculada apenas a uma publicação.
&#x20;Se a conta for privada, continua sendo possível vincular múltiplas publicações normalmente.
{% endhint %}

5. Clique em "**Criar**".&#x20;

***

3. Selecione os usuários e grupos que poderão interagir com o seu projeto.&#x20;
4. Após preencher todos os campos, clique em “**Salvar publicação**”. O **Skyone Studio** exibirá os detalhes da conexão estabelecida.

***

#### <mark style="color:blue;">Passo 4: Finalize a configuração no Meta Developers</mark>

1. No menu lateral da plataforma **Meta Developers**, selecione "**WhatsApp"** e clique em “**Configuração**”.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FQ6rYqfXKwGtb3kfe8nTM%2F68C22493-7D85-49CE-8EF5-4DF824C864FE.png?alt=media&#x26;token=fdd5c36e-7a38-4d14-8b35-2a6e5762430c" alt=""><figcaption></figcaption></figure>

2. Preencha os seguintes campos com os dados do **Skyone Studio**:

* **URL de callback:** Cole o valor do campo Webhook.
* **Token de verificação:** Cole o valor do campo Token de verificação.

3. Em “**Campos do webhook**”, confirme que a opção **Messages** esteja marcada como “**Assinado**”.
4. Clique em “**Verificar e salvar**".

Pronto! A configuração do WhatsApp Business no **Skyone Studio** está completa e pronta para uso.

***

#### Vídeo Demonstrativo

Para facilitar a compreensão, assista ao vídeo abaixo com a demonstração prática de todas as etapas apresentadas nesta documentação. O vídeo mostra cada tela, clique e configuração necessária para concluir a integração do WhatsApp Business no Skyone Studio.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FVjQ9MClgbI6AvgkKQCsg%2FConfiigurac%CC%A7a%CC%83o%20Whatsapp%20Business%20no%20Skyone%20Studio%20(1).mp4?alt=media&token=0b99fc7b-4ae0-490d-8615-c9e3ee229037>" %}

***

### FAQ – Configuração do WhatsApp no Skyone Studio

<details>

<summary>Preciso de alguma conta específica para fazer a configuração?</summary>

Sim. É necessário ter uma conta de desenvolvedor no **Meta for Developers** e acesso ao **Skyone Studio**.

</details>

<details>

<summary>Como eu posso criar a conta de desenvolvedor no <strong>Meta for Developers?</strong></summary>

Você pode encontrar o guia passo a passo e a documentação oficial para criar uma conta de desenvolvedor no Meta na seguinte página:

[Inscrição - Meta for Developers](https://developers.facebook.com/docs/development/register/?locale=pt_BR)

Essa página contém o processo oficial de inscrição, incluindo as etapas para iniciar o registro, concordar com os termos, verificar sua conta e selecionar sua profissão.

</details>

<details>

<summary>Posso fazer a configuração em modo de teste?</summary>

Sim. O **Modo de Desenvolvimento** é indicado para validação e testes, mas o token gerado terá validade de apenas 1 hora.

</details>

<details>

<summary>Onde encontro o ID do número de WhatsApp?</summary>

O ID pode ser identificado na **Etapa 2**, na URL da API apresentada. Exemplo:\
`https://graph.facebook.com/v22.0/123456789/messages` → O ID é **123456789**.

</details>

<details>

<summary>É obrigatório finalizar a configuração no Meta Developers?</summary>

Sim. Essa etapa é necessária para vincular o aplicativo ao número do WhatsApp e validar o webhook.

</details>