# 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="/files/UKw1pj2mZCA5UJ5ksJYx" 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="/files/QsvQuH6B1VzEMTkiebAZ" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/mfVtlJQVce6dx5vrf8jm" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/DSxS56npbNBimep5ObMe" 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="/files/P6qBLJIsuQJhyMgTEYyN" 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="/files/lAH0Jl5vDyqiR1QVZOkn" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/7r4ZQ1C0Uo64qGcoOZMb" 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="/files/kmHtfnz0AxWXlfTRAndi" 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="/files/KGbaTGXbcHTNs0vc4MJa" 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="/files/vriP78By54uEOuuICPFB" 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="/files/g9PC8dEgsTtOcduN2858" 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="/files/atNDd7TU7APMradDjKVR" 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/agentes/canais-de-publicacao-de-agentes-de-ia/como-configurar-o-whatsapp-no-skyone-studio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.