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.

Termos importantes (Glossário)

  • Meta for Developers: Ferramenta oficial da Meta (Facebook) para criação e configuração de aplicativos e integrações, incluindo WhatsApp Business.

  • Token de Acesso: Código utilizado para autenticar a comunicação entre o Skyone Studio e o WhatsApp Business.

  • Webhook: URL utilizada para receber eventos e mensagens do WhatsApp Business.

Etapas de configuração

Para configurar o WhatsApp Business, você precisará estar simultaneamente em dois produtos: Skyone Studio e Meta for Developers.

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 1: Crie aplicativo no Meta for Developers

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

  1. Acesse Meta for Developers e clique em “Criar aplicativo”.

  1. 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.

  1. Em Casos de Uso, selecione a opção "Outro" e clique em “Avançar”.

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

  1. Escolha o portfólio empresarial desejado e clique em “Criar aplicativo”.

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.

Passo 2: Gere o Token de acesso temporário.

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

  1. Na tela de configuração, clique em “Configuração da API”.

  2. Clique em “Continuar”.

  1. 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”.

Importante: O token gerado em ambiente de desenvolvimento tem validade de apenas 1 hora.

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

Passo 4: Gere o token que será usado pelo Skyone Studio para autenticar a conexão.

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:

  1. Acesso ao business.facebook

  2. Acesse as configurações de negócios.

  3. Selecione a conta comercial à qual seu aplicativo está associado.

  4. Abaixo de Usuários, clique em "Usuários do sistema".

  1. Clique em "Adicionar".

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

O número máximo de usuários administradores do sistema possível é 1.

  1. Selecione a permissão whatsapp_business_messaging.

  2. Clique em Gerar novo token.

  3. Copie e salve seu token.

Passo 3: Use os dados do WhatsApp no Skyone Studio

  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".

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.

Selecione e preencha os campos exibidos no Studio.

  1. Selecione o Fluxo de agente

  2. Selecione a conta que deseja usar para acessar suas configurações ou dados

Criação da conta

  1. Clique em gerenciar conta;

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

  3. Preecha os campos de:

    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:

      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.

  1. 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.

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

Uma conta pública pode ser vinculada apenas a uma publicação. Se a conta for privada, continua sendo possível vincular múltiplas publicações normalmente.

  1. Clique em "Criar".

  1. Selecione os usuários e grupos que poderão interagir com o seu projeto.

  2. Após preencher todos os campos, clique em “Salvar publicação”. O Skyone Studio exibirá os detalhes da conexão estabelecida.

Passo 4: Finalize a configuração no Meta Developers

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

  1. 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.

  1. Em “Campos do webhook”, confirme que a opção Messages esteja marcada como “Assinado”.

  2. 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.

FAQ – Configuração do WhatsApp no Skyone Studio

Preciso de alguma conta específica para fazer a configuração?

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

Como eu posso criar a conta de desenvolvedor no Meta for Developers?

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

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.

Posso fazer a configuração em modo de teste?

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

Onde encontro o ID do número de WhatsApp?

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.

É obrigatório finalizar a configuração no Meta Developers?

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

PreviousCanal de publicaçãoNextComo configurar o Slack no Skyone Studio?

Last updated