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á realizada em 4 etapas principais, passando pela criação do aplicativo no Meta for Developers, geração do Token de Acesso, 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

Há duas formas de configuração:

  • Modo de Desenvolvimento: Ideal para validação e teste. Recomendamos o uso deste modo para a execução de testes antes da publicação em produção. Isso permite validar o funcionamento do sistema sem impactar usuários reais.

  • Modo Ativo: Para uso definitivo, em ambiente de produção. Use este modo apenas após garantir que tudo está funcionando corretamente nos testes, para que o serviço esteja disponível para os usuários finais.

  1. No menu lateral, na opção WhatsApp e 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 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.

  1. Preencha os campos com as informações obtidas no Meta Developers:

  • Fluxo do Agente: Selecione um fluxo previamente criado no Studio.

  • Nome: Defina um nome para a publicação.

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

  • Número: Utilize o número configurado (exemplo: número de teste).

  • Token: Insira o token gerado.

  • API Secret:

    • Acesse “Configurações” do app no menu lateral do Meta.

    • Selecione a opção “Básico”.

    • Clique em “Mostrar” na opção Chave Secreta do Aplicativo.

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