WhatsApp Business API

O WhatsApp Business API (WABA) é uma interface de conexão desenvolvida pelo Meta (proprietária do WhatsApp) para permitir que as empresas se comuniquem com seus clientes de forma mais eficiente e automatizada.

1 - Introdução

Ao migrar para WhatsApp Business API algumas coisas serão diferentes do Aplicativo WhatsApp ou WhatsApp Business. Preparamos um resumo com os principais pontos que diferem um do outro.

• Aplicativo

A primeira e grande diferença é que ao migrar para WhatsApp Business API não haverá mais aplicativo no celular. As mensagens serão processadas pela Cloud API e serão enviadas diretamente para a plataforma Evotrix.

Para migrar seu número, você precisará excluir sua conta no aplicativo, bem como seu histórico de conversas, mídias e grupos a que fizer parte.

• Restrições

Ao migrar para WABA outra diferença são as restrições de envio de mensagem. Se um contato não te enviar mensagem você só poderá enviar uma mensagem a ele através de um modelo. Esse modelo deve ser enviado e aprovado pela Meta.

Além disso, WhatsApp API também não dá suporte a grupos ou comunidades, ligações e também status, sendo direcionado ao envio e recebimento de mensagens.

• Cobranças

Para utilizar a Cloud API é preciso pagar. A Meta cobra por janelas de 24 horas, onde a primeira mensagem é cobrada e as demais mensagens dentro dessa janela não são cobradas.

Quando um cliente inicia a conversa é considerada mensagem de Serviço e quando a conversa é iniciada pela empresa ela pode ser considerada como Utilidade ou Marketing.

Todas as mensagens de serviço são gratuítas, isso é quando o cliente manda a primeira mensagem, já conversas niciadas pela empresa sempre serão cobradas.

2 - Integração Meta

Vamos realizar os passos necessários para conectar seu número à Meta

2.1 - Facebook Developer

Acesse https://developers.facebook.com/apps com sua conta do Facebook e clique em Criar Aplicativo

Digite o nome do aplicativo (Sugestão: WABA Nome da Empresa), adicione um e-mail para contato e clique em Avançar

Selecione o tipo Outro e clique em Avançar

Agora selecione o tipo Business e clique em Avançar

Confirme os dados e clique em Criar Aplicativo

Digite sua senha e clique em Enviar

Após concluir a criação selecionaremos os produtos do aplicativo. Role a página até aparecer o WhatsApp.

Clique em configurar

Selecione o portfólio empresarial e clique em Continuar. Será solicitada autenticação de dois fatores, confirme seu código para continuar.

Agora com WhatsApp Ativo na barra superior mude o Modo do aplicativo para Ao vivo

Caso seja solicitada política de privacidade, você pode adicioná-la em Configurações do App > Básico.

2.3 - Adicionando Telefone

Volte ao menu WhatsApp > Guia Rápido e clique em Começar a usar a API

Agora clique em + Adicionar telefone para criar um perfil do WhatsApp Business.

Preencha o nome do perfil (Esse será o nome exibido no seu perfil do WhatsApp)

Selecione a categoria, opcionalmente preencha a descrição da empresa e clique em Avançar

Digite o número de seu telefone com DDD e escolha o modo de verificação SMS ou Ligação.

Nota

O número a ser adicionado não pode estar conectado no aplicativo do WhatsApp.

Digite o código de verificação recebido por SMS ou Ligação e clique em Avançar

Agora copie a Identificação do número de telefone, vamos precisar dela para a integração.

2.3 - Gerando Token

Abra uma nova aba e acesse https://business.facebook.com e clique em Configurações

Agora clique em Usuários do sistema

Verifique se você possui um usuário com Acesso Administrador

Caso não tenha clique em Adicionar

Coloque um nome de sua preferência e selecione a função Administrador

Agora com usuário administrador selecionado clique em Atribuir ativos

Clique na aba Apps, selecione o aplicativo que acabou de criar e atribua a permissão Gerenciar app.

Agora ainda com usuário administrador selecionado clique em Gerar novo token

Selecione Nunca para a Expiração do token.

Selecione as permissões whatsapp_business_management e whatsapp_business_messaging e clique em Gerar token

Será exibido o token de integração, copie-o, pois vamos utilizá-lo na integração. Se preferir salve em um bloco de notas, pois não poderá copiá-lo novamente se essa aba for fechada.

2.4 - Criando Canal

Acesse a plataforma no menu WhatsApp > Canais e clique em Novo Canal.

Selecione o tipo Meta Cloud API, coloque um nome de sua preferência e clique em Salvar

Clique na aba Meta Cloud API para configurarmos a integração.

Coloque o número do telefone (Apenas números e com DDI) Ex.: 5543988076866

O ID do número do WhatsApp que copiou após cadastrar o número.

O token que acabamos de gerar e clique em Salvar

2.5 - Criando Webhook

Após salvar irá aparecer as informações do Webhook. Vamos voltar ao Facebook para configurar essas informações.

Na aba do Facebook Developers onde confirmamos o número, clique em Configurações.

Agora na sessão do Webhook clique em Editar

Adicione a URL e o Token gerados após salvar as configurações do canal na plataforma e clique em Verificar e salvar.

Com o endereço configurado, clique em Gerenciar

Clique para assinar message_template_status_update, messages e messaging_handover e clique em Concluir.

UFAA TERMINAMOS!!! Agora seu número está registrado na Cloud API e conectado à Plataforma.

3 - Modelos de Mensagem

Os modelos são usados em mensagens para iniciar conversas de marketing, utilidade e autenticação com os clientes. Ao contrário das mensagens em formato livre, os modelos são o único tipo de mensagem que pode ser enviado a clientes que ainda não iniciaram uma conversa com você ou não enviaram uma mensagem nas últimas 24 horas.

Os modelos precisam ser aprovados antes do envio. Além disso, eles podem ser desabilitados automaticamente pela Meta com base no engajamento e no feedback dos clientes.

3.1 - Modelos no Sistema

Para cadastrar um modelo acesse o menu WhatsApp > Modelos

Aqui no cadastro do modelo nós temos informações importantes.

• Nome: Nome de sua preferência para localizar o template no sistema
• Template: Esse é o nome do template usado na Meta
• Destino: Onde esse template será utilizado (Notificações Agendadas, Manuais ou no Atendimento)
• Status: Se o template está ativo para utilizar no sistema.
• Cabeçalho: Tipo do cabeçalho da mensagem, que pode ser nenhum, texto, arquivo, foto ou vídeo
• Conteúdo Cabeçalho: Conteúdo caso seja um texto estático.
• Mensagem: Mensagem do template
• Conteúdo Rodapé: Conteúdo exibido no rodapé da mensagem.

Esses são exemplos de Cabeçalho, o primeiro é Texto, segundo Imagem, terceiro vídeo e por último um PDF.

O texto pode ser fixo ou variável e os arquivos de mídia sempre serão variáveis a cada mensagem.

Escolha o Cabeçalho da mensagem conforme sua preferência e preencha o Conteúdo Cabeçalho apenas se ele for Fixo.

Ao escrever a mensagem você pode utilizar variáveis, elas devem ser representadas por números e chaves {{1}}, {{2}} e assim por diante.

No modelo você também pode adicionar botões de ações que o cliente pode clicar, de modo a facilitar ele abrir um link ou enviar uma resposta direcionada.

Os botões podem ser de 4 tipos:

• Resposta: Responde o chat com uma resposta predefinida assim que clicar no botão.
• Ligar p/ Telefone: Atalho com número de telefone que o cliente pode ligar
• URL Estática: URL Fixa, como por exemplo, site ou link da central.
• URL Dinâmica: URL Dinâmica, como por exemplo link da fatura que muda o final conforme o cliente.

Esses são exemplos de mensagens com botões configurados.

Esses templates são modelos que usaremos para enviar cada mensagem iniciada pela empresa e eles precisam ser aprovados pela Meta.

Dessa forma precisaremos enviar esse template para aprovação deles. Em breve a plataforma irá enviar de forma automática. 🤩🤩

3.2 - Modelos na Meta

Acesse https://business.facebook.com/wa/manage/home

Em sua conta do WhatsApp clique em Modelos de mensagem

Isso irá abrir sua lista de modelos já cadastrados. Para criar um novo clique no botão Criar Modelo

3.2.1 - Tipos de Modelo

Selecione a categoria Utilidade depois Personalizada e clique em Avançar

Agora coloque o nome de seu modelo (Utilize letras minúsculas e _ no lugar dos espaços) e escolha o idioma Portuguese (BR).

Na opção Variável, mantenha selecionado Número

3.2.2 - Cabeçalho

Agora nós estamos na tela de edição do template. O primeiro item é o Cabeçalho da mensagem, ele pode ser definido como nenhum, texto ou mídia. Se ele for texto, é possível adicionar uma única variável.

3.2.3 - Corpo

Depois vem o corpo da mensagem. Nela podemos utilizar a formatação do WhatsApp, emojis e também as variáveis.

Para cada variável, você deve informar um valor de exemplo que será utilizado nesse campo. Por exemplo na variável {{1}} que será o nome do cliente, um exemplo é Eduardo.

Conforme for editando a mensagem ela vai aparecendo na prévia do lado direito da página.

3.2.4 - Dica

Abaixo uma dica que pode utilizar para aviso de vencimento.

Olá {{1}} tudo bem?

Aqui é da Empresa Telecom.

Sua fatura de Internet no valor de *{{2}}* {{3}} *{{4}}*

Pague via PIX clicando na opção pagar com PIX

Ou se preferir baixar o boleto clique na opção baixar boleto.

Caso já tenha realizado o pagamento, por favor desconsidere essa mensagem!

3.2.5 - Rodapé

Por último, vem o rodapé, ele aparece no final da mensagem de forma mais discreta. O rodapé não pode ter variáveis nem mídia ou emojis.

3.2.6 - Botões

Os botões podem ser estáticos e também dinâmicos. Um exemplo de botão estático é o de resposta rápida que ao ser clicado enviará uma resposta automaticamente com o texto do botão.

E um de botão dinâmico é o de chamada para ação utilizando URL dinâmica. Ele permite definir uma URL e enviar um parâmetro do final. Dessa forma conseguimos usar o mesmo modelo para enviar a fatura de todos os clientes mudando apenas o ID.

Nota

Para utilização da URL dinâmica no botão é obrigatório informar a URL utilizada, de modo que a parte variável será adicionada ao final da URL previamente cadastrada. Para consultar seu padrão de URL, entre em contato com nosso suporte.

Para o botão com URL dinâmica também é preciso enviar um exemplo com a variável no final.

Você pode acompanhar como os botões irão aparecer na prévia ao lado.

Ao concluir clique em Enviar para análise na parte inferior direita. Deixe a opção período de validade desativada.

Confirme o idioma Português(BR) e clique em confirmar.

3.2.7 - Análise

Você será direcionado para lista de modelos e ele aparecerá com status Em análise. Normalmente a análise demora menos de um minuto.

Ao ser aprovado ele aparecerá como Ativo - Qualidade Pendente

3.2.8 - Categoria

Caso a Meta discorde do tipo da notificação, ela irá solicitar para mudar para Marketing. Se esse for o caso, é só mudar e continuar, se não terá que solicitar uma análise na página do suporte.

Se tiver dúvida da categoria do modelo, consulte nossa equipe.

IMPORTANTE O nome do modelo, precisa ser o mesmo do campo template cadastrado na plataforma.

Agora com template aprovado e cadastrado já conseguimos utilizar ele.

3.3 Modelos na Prática

Veja no vídeo abaixo como criar modelos na prática.

4 - Atendimento

Na API Oficial pela Meta, você só pode iniciar uma conversa com um contato através de um modelo de mensagem. Essa é a única diferença no atendimento, as demais opções continuam da mesma forma.

Ao iniciar um atendimento para enviar a primeira mensagem ao cliente o chat ficará bloqueado para digitar.

Você deverá clicar em mensagem de sessão para enviar um modelo.

Na janela que abrir escolha o modelo que deseja utilizar para iniciar a conversa.

Se o modelo tiver variáveis, irá aparecer campos abaixo da mensagem para você digitar.

A mensagem será completada com os valores que digitar. Depois disso é só enviar.

As mensagens de modelo têm um tempo maior para serem entregues, mesmo que o contato esteja online.

Importante

Mesmo com a mensagem enviada o chat continuará bloqueado até que o cliente responda.

Importante

Ele respondendo, você já pode conversar com ele de forma livre com mensagens de texto, arquivos e áudios. Porém se ele ficar 24h sem enviar nenhuma mensagem, o chat será bloqueado novamente.

Essas são as mudanças do chat quando utilizado API da Meta. Qualquer dúvida entre em contato com nossa equipe.

5 - Notificações Agendadas

Para as notificações agendadas também temos mudanças utilizando a Cloud API. Uma vez que na maior parte dos casos uma notificação será enviada sem que o cliente tenha interagido com a empresa, ela só poderá ser enviada se for um template.

O processo para configuração é o mesmo, porém é preciso usar um template e passar as variáveis.

Assim que fizer isso ao invés de digitar a mensagem de forma aberta, deverá selecionar um template previamente cadastrado.

Assim que selecionar a mensagem irá aparecer automaticamente junto com as variáveis para serem configuradas.

Configure as variáveis de acordo com a mensagem, elas serão atualizadas automaticamente na mensagem e ficarão configuradas para o template.

No caso de Botões para link de pagamento utilize sempre a variável %idfatura%

O envio do PDF em anexo será habilitado automaticamente caso o header de seu template seja do tipo documento.

De modo geral é isso, as outras opções continuam as mesmas. Qualquer dúvida entre em contato com nossa equipe.

6 - Notificações Manuais

Similar às notificações automáticas, ao enviar uma notificação manual você deverá mudar o modo para Template.

Selecione o template para a mensagem que deseja enviar. Ele irá exibir a mensagem para pré-visualização.

Preencha as variáveis para completar a mensagem. Agora só adicionar os números e enviar.

Finalizamos por aqui as diferenças para a Cloud API. Qualquer dúvida entre em contato com nossa equipe.