Mudanças entre as edições de "Integracao WhatsApp Cadastro Configurações Meta"

De Tek-System Wiki
Ir para navegação Ir para pesquisar
Etiqueta: Reversão manual
 
(26 revisões intermediárias por 2 usuários não estão sendo mostradas)
Linha 1: Linha 1:
==Introdução==
WhatsApp sempre foi focado no usuário para levar a ele uma experiência segura e de qualidade. Então, ficar de olho em todos e controlar o acesso é a melhor estratégia.
Para poder usar a integração whatsApp é necessário possui uma conta como desenvolvedor da Meta(Facebook). Essa conta pode ser uma conta existente do Facebook ou pode cadastrar uma conta especifica.
É Necessário se cadastrar pois cada pessoa/Empresa que optar a usar a integração não ficara vinculada a Tek-System, ela apenas usará uma biblioteca disponibilizada.


Após realizar o acesso como desenvolvedor da Meta(Facebook), será necessário criar um App(Aplicativo) para gerenciamento de envio de mensagens.  
Mais informações em https://developers.facebook.com/docs/whatsapp/business-management-api/get-started/


Tipos de Mensagens:


'''- Mensagens Iniciadas pela empresa:''' Para uma empresa iniciar uma conversa usando a integração do WhatsApp ela precisa criar templates. Esses templantes são mensagens cadastradas no aplicativo do whatsApp para serem enviadas de acordo com alguma programação.
==Habilitação da Conta==
Exemplo: Ao cadastrar um pedido novo no sistema, será disparado uma mensagem para o cliente informando alguns dados do pedido.
Nesse caso poderíamos cadastrar uma Template : '''Pedido_Cadastrado''' com a seguinte mensagem: '''Seu pedido foi cadastrado com Sucesso em nosso sistema! Obrigado pela preferencia...
No exemplo a cima, toda vez que for registrado um pedido novo, será enviado essa mensagem para o cliente.


'''- Mensagens Iniciadas pelo Cliente:''' Mensagens iniciadas pelo cliente, não precisa do uso do Templates para respostas. ''Esse processo não será gerenciado pela Tek-System''
Para poder utilizar a integração WhatsApp a empresa necessita possui uma conta como desenvolvedor na Meta.


Por ultimo deve cadastrar um token do tipo permanente. Esse token será usado somente para gerar os tokens de acesso rápido para realizar os envios das mensagens aos clientes.  
Essa conta pode ser uma conta já existente do Facebook ou pode cadastrar uma conta nova especifica.


Devido os tokens padrões possuírem durabilidade de 24 horas e podendo no máximo serem prorrogados para 60 dias, por segurança a Meta indica usar esses tokens para realizar o envio de mensagens aos clientes e usar um token do tipo permanente somente para gerar esses tokens de durabilidades pequenas.  
Instruções: https://developers.facebook.com/docs/development/register


==Criação da conta na Meta(Facebook)==
===Etapas a seguir===
Para acessar a área de desenvolvedor com conta existente ou criar uma conta Meta(Facebook) especifica, acesse o link abaixo.
* Acesse a área de desenvolvedor com conta existente através do link https://developers.facebook.com/
* Realize o logIn para habilitar uma conta como desenvolver.


Link: https://developers.facebook.com/ e clique na opção de log in.


Após habilitar uma conta como desenvolver Meta, precisa criar um Aplicativo para gerenciar os tipos de mensagens que serão usadas.
==Criação e Configuração de um App==


==Criar um App(Aplicativo) Meta.==
Necessário criar um aplicativo para gerenciar o envio de mensagens, bem como os tipos que serão usadas e vinculação ao número de telefone.  
    - Utilizado para realizar envio de mensagens iniciadas pela empresa.
    - Nesse aplicativo que se vincula o número de telefone.
    - Acesse developers.facebook.com > Meus aplicativos > Criar aplicativo. Selecione o tipo "Empresa" e siga as instruções na tela).
    - Após Criar o App, procure no app criado whatsApp e acesso as configurações e escolha entre Criar conta empresarial(Produção) ou teste business(Homologação).
      - caso opte por criar conta de teste, pode criar conta empresarial futuramente para uso em produção.
 
==Cadastrar os Templates==
    - Os Templates cadastrados em testes não ficam disponivel para uso em produção.
    - No App criado, acesse no menu do lado esquerdo opção de WhatsApp e Começar.
    - Na Opção Etapa 2, em clique aqui abre opção para cadastrar os templates.
    - Para a empresa iniciar uma conversa com um cliente a meta exige que seja usado um template, esse template é uma mensagem padrão que pode possuir parâmetros que serão substituídos por alguma informação do sistema ou alguma mídia.
  - Exemplo:  Template : Pedido cadastrado no sistema sobre o código {{1}), no valor de {{2}) reais.
  - A informação {{1}) e {{2}), são 2 parâmetros que podem ser adicionado através da opção Adicionar variáveis conforme imagem a baixo, onde de dentro do sistema será trocado pelo código do pedido e pelo valor do pedido.
  - Esses templates podem não possuir cabeçalhos, ou possuir do tipo texto ou de mídia, onde se pode vincular imagem, vídeo e documentos.
    [[Arquivo:WhatsAppTela1.jpg|1200px|thumb|center]]


    [[Arquivo:Tamplates.jpg|1600px|thumb|center]]
Instruções: https://developers.facebook.com/docs/development/create-an-app


==Gerar um token do tipo permanente.==  
===Etapas para criação===
  - Para gerar um token permanente precisa cadastrar um usuário de acesso ao sistema.
* Acesse https://developers.facebook.com/
    - Link: https://www.facebook.com/business/help/503306463479099?id=2190812977867143  
* No menu > Meus aplicativos > Criar aplicativo.
  - Para funcionar não se esqueça de atribuir essas 2 permissões da lista.
* Selecione o tipo "Empresa" e siga as instruções na tela.
    - whatsapp_business_messaging
* Você precisará das informações "ID do Aplicativo" e "Chave Secreta do Aplicativo"
    - whatsapp_business_management
 
  - OBS: Salve esse token, pois ele não fica salvo na Meta.
    [[Arquivo:WhatsAppTela2.png]]
 
===Para configurar===
* No menu lateral, selecione WhatsApp > Configurações
* Escolha entre "Criar conta empresarial(Produção)" ou "teste business(Homologação)".
Caso opte por criar conta de teste, pode criar conta empresarial futuramente para uso em produção.
 
====Importantes====
* Depois de migrar um número de telefone para o WhatsApp Business Platform, você não poderá usar esse número no WhatsApp Business App simultaneamente. Seu número deve ser usado na Plataforma de Negócios ou no Aplicativo de Negócios. Para migração acesso https://developers.facebook.com/docs/whatsapp/cloud-api/get-started/migrate-existing-whatsapp-number-to-a-business-account
 
 
==Criar usuário==
 
Os usuários do sistema representam servidores ou um software que faz chamadas de API para ativos gerenciados por um Gerenciador de Negócios.
 
São representados por um Token do tipo permanente, será usado somente para gerar os Tokens de acesso rápido para realizar os envios das mensagens aos clientes.
 
Devido os Tokens padrões possuírem durabilidade de 24 horas e no máximo poderem ser prorrogados para 60 dias, a Meta por segurança indica usar esses Tokens para realizar o envio de mensagens aos clientes e usar o Token do tipo permanente para gerar esses Tokens de acesso rápido.
 
 
Siga as instruções https://www.facebook.com/business/help/503306463479099?id=2190812977867143  
 
Não deixe de atribuir as duas permissões:
** whatsapp_business_messaging
** whatsapp_business_management
Guarde o Token gerado
 
 
 
==Configurar o HSM: Template com Modelos de Mensagens==
 
Os templates do WhatsApp, ou também conhecidos como modelos de mensagem (HSM), são formatos para mensagens reutilizáveis comuns que podem ser enviados por uma empresa através do seu WhatsApp Business API.
 
Siga as instruções:
  https://developers.facebook.com/docs/whatsapp/message-templates/guidelines
  https://business.facebook.com/business/help/2055875911147364
  https://developers.facebook.com/docs/whatsapp/api/messages/message-templates?locale=pt_BR
 
===Criação dos modelos de mensagem===
 
* Abra o Gerenciador Gerenciador de Negócios do Facebook, acesse o "Ferramentas de contas" > "Modelos de Mensagem" https://business.facebook.com/wa/manage/message-templates
* Clique em "Criar modelo".

Edição atual tal como às 16h44min de 11 de maio de 2023

WhatsApp sempre foi focado no usuário para levar a ele uma experiência segura e de qualidade. Então, ficar de olho em todos e controlar o acesso é a melhor estratégia.

Mais informações em https://developers.facebook.com/docs/whatsapp/business-management-api/get-started/


Habilitação da Conta

Para poder utilizar a integração WhatsApp a empresa necessita possui uma conta como desenvolvedor na Meta.

Essa conta pode ser uma conta já existente do Facebook ou pode cadastrar uma conta nova especifica.

Instruções: https://developers.facebook.com/docs/development/register

Etapas a seguir

  • Acesse a área de desenvolvedor com conta existente através do link https://developers.facebook.com/
  • Realize o logIn para habilitar uma conta como desenvolver.


Criação e Configuração de um App

Necessário criar um aplicativo para gerenciar o envio de mensagens, bem como os tipos que serão usadas e vinculação ao número de telefone.

Instruções: https://developers.facebook.com/docs/development/create-an-app

Etapas para criação

  • Acesse https://developers.facebook.com/
  • No menu > Meus aplicativos > Criar aplicativo.
  • Selecione o tipo "Empresa" e siga as instruções na tela.
  • Você precisará das informações "ID do Aplicativo" e "Chave Secreta do Aplicativo"
   WhatsAppTela2.png

Para configurar

  • No menu lateral, selecione WhatsApp > Configurações
  • Escolha entre "Criar conta empresarial(Produção)" ou "teste business(Homologação)".

Caso opte por criar conta de teste, pode criar conta empresarial futuramente para uso em produção.

Importantes


Criar usuário

Os usuários do sistema representam servidores ou um software que faz chamadas de API para ativos gerenciados por um Gerenciador de Negócios.

São representados por um Token do tipo permanente, será usado somente para gerar os Tokens de acesso rápido para realizar os envios das mensagens aos clientes.

Devido os Tokens padrões possuírem durabilidade de 24 horas e no máximo poderem ser prorrogados para 60 dias, a Meta por segurança indica usar esses Tokens para realizar o envio de mensagens aos clientes e usar o Token do tipo permanente para gerar esses Tokens de acesso rápido.


Siga as instruções https://www.facebook.com/business/help/503306463479099?id=2190812977867143

Não deixe de atribuir as duas permissões:

    • whatsapp_business_messaging
    • whatsapp_business_management

Guarde o Token gerado


Configurar o HSM: Template com Modelos de Mensagens

Os templates do WhatsApp, ou também conhecidos como modelos de mensagem (HSM), são formatos para mensagens reutilizáveis comuns que podem ser enviados por uma empresa através do seu WhatsApp Business API.

Siga as instruções:

 https://developers.facebook.com/docs/whatsapp/message-templates/guidelines
 https://business.facebook.com/business/help/2055875911147364
 https://developers.facebook.com/docs/whatsapp/api/messages/message-templates?locale=pt_BR

Criação dos modelos de mensagem