Neste artigo, vai aprender como criar uma conta Twilio necessária, como ligar um número empresarial do WhatsApp à sua conta Twilio, que vai utilizar para comunicar com os clientes, e como ligar um número WhatsApp ao RemOnline.
​

O Twilio é uma plataforma API de comunicação que permite aos programadores e às empresas integrar facilmente ferramentas de comunicação como telefonia, SMS, conversas e vídeo nas suas aplicações e sites. Com o Twilio, é possível enviar mensagens de texto, fazer chamadas telefónicas, configurar respostas automáticas e muito mais. O Twilio vai ajudar-nos a integrar o WhatsApp no RemOnline.
​

Antes de começar a usar este guia, você precisará de:

Se estiver a utilizar o seu próprio número de telefone, o número deve poder receber SMS ou chamadas telefónicas. Se o número só puder receber chamadas telefónicas, não pode estar a utilizar um IVR (resposta de voz interactiva).

Depois de ter a versão paga do Twilio, é necessário registar um WhatsApp sender, que permitirá enviar e receber mensagens WhatsApp da marca da sua empresa utilizando as APIs Twilio. Algumas restrições são impostas pela Meta (a empresa proprietária do WhatsApp) e é provável que tenha de concluir a Verificação Comercial da Meta antes de colocar a sua aplicação em produção ou de integrar outros WhatsApp sender.
​

Para criar um WhatsApp sender:
​

1. Comece por iniciar sessão na Console do Twilio.
​

2. Navegue até Messaging > Senders > WhatsApp senders Isto irá levá-lo para a secção WhatsApp sender da consola, onde irá criar o seu WhatsApp sender.
​

3. Reveja as informações nesta página e clique em Get Started.
​

4. Veja os Termos de Serviço do WhatsApp e selecione a caixa se concordar com os mesmos. Em seguida, clique em Confirm.
​

5. Em seguida, selecione o número de telefone que pretende ligar à API comercial do WhatsApp. Pode utilizar o seu número Twilio ou o seu próprio número de telefone. Clique em Continue.
​

Este passo abre uma janela pop-up que conduz ao Facebook.com. Não feche a janela pop-up nem navegue para uma página diferente na Consola Twilio. Irá precisar da janela da Consola Twilio para os passos seguintes deste guia.
​

1. Faça login no Facebook, se ainda não o fez, ou clique em Continue as [ seu nome ] se já estiver conectado. Depois de iniciar sessão, ser-lhe-á apresentada uma visão geral do processo para ligar o seu número ao WhatsApp.
​

2. Depois de iniciar sessão, verá os passos seguintes no processo de ligação do seu número ao WhatsApp. Clique em Get started.

3. O Facebook pedir-lhe-á então que autorize o Twilio a gerir a sua conta WhatsApp Business. Clique em Continue para continuar.

4. No ecrã seguinte, selecione na lista a conta Meta Business da sua empresa. Se não tiver uma, pode criar uma nova selecionando a opção Create a Business Account.

5. Em seguida, poderá selecionar uma Conta WhatsApp Business (WABA) ou criar uma nova.
​

Quando registar o primeiro WhatsApp sender numa conta Twilio, crie uma nova WABA para ser utilizada apenas com essa conta Twilio específica. Quando integrar remetentes adicionais na mesma conta Twilio, terá de selecionar a mesma WABA que criou durante o processo de integração do primeiro WhatsApp sender. Quando uma WABA estiver ligada à sua conta Twilio, a ID será apresentada na página WhatsApp sender.
​

Importante: se já tiver um número do WhatsApp aprovado com outro fornecedor, siga os passos deste artigo.

6. No ecrã seguinte, terá de introduzir as seguintes informações:
​

WhatsApp Business Account Name - Este nome é usado apenas para fins internos e não é voltado para o consumidor. Se tiver selecionado uma WABA no ecrã anterior, não poderá alterar o nome aqui.
​

WhatsApp Business Profile Display Name - É o que os seus clientes verão. Deve cumprir os requisitos definidos pelo WhatsApp.
​

Category - Selecione a categoria que melhor descreve a sua empresa. Esta é mostrada aos consumidores quando visualizam o seu perfil.
​

Business Description - Também é apresentada aos consumidores quando visualizam o seu perfil na aplicação WhatsApp.
​

Website - Também é apresentado aos consumidores quando visualizam o seu perfil na aplicação WhatsApp. Depois de registar o seu WhatsApp sender, poderá adicionar outro site, se assim o desejar.
​

Recomendamos vivamente a utilização do nome da empresa como nome de apresentação ao registar os WhatsApp sender, uma vez que o WhatsApp rejeitará tudo o que não corresponda ao nome da empresa no Business Manager ligado.
​

No entanto, pode ter um nome de marca que pretenda utilizar como nome de apresentação para o seu Perfil comercial do WhatsApp que seja diferente do nome da sua empresa. Se for esse o caso, deve existir uma associação clara e publicada externamente entre a sua empresa e a marca. Esta associação entre a marca e a sua empresa tem de ser apresentada no seu site e no próprio Nome de Exibição.
​

Por exemplo, se a sua empresa é a Johnny Mobile e a sua marca é “PizzaApp”, então recomendamos a utilização do Nome de Apresentação “PizzaApp by Johnny Mobile”. Esta associação deve ser publicada no seu site, para que o WhatsApp a possa verificar. Isto significa que, algures no site, deve existir uma relação visível entre os dois nomes. Se pretender manter o nome “PizzaApp”, geralmente é necessário recorrer ao WhatsApp e pode prolongar o processo de registo.
​

Para obter mais informações, pode consultar as regras do nome de apresentação do WhatsApp.

1. Se estiveres a utilizar um número Twilio com capacidades de SMS, muda para a janela da Consola Twilio que deixaste aberta no passo 1 e clica para copiar o teu número Twilio.
​

2. Em seguida, cole o número na janela pop-up do Facebook. Mantenha o método de verificação Mensagem de texto selecionado e, em seguida, clique em Send Code.
​

Se não estiveres a utilizar um número Twilio, introduz o número que pretendes utilizar e escolhe o teu método de verificação.

Não continue se receber uma mensagem de aviso sobre o facto de o seu número estar a ser movido. Em vez disso, abra um ticket de suporte e indique que precisa que o seu número seja migrado da Meta ou da empresa anterior (ou seja, do Business Solution Provider) com a qual trabalhou.
​

3. O código de verificação será então apresentado na consola Twilio, sob o título Verification code. Clique em Copy e cole-o na janela pop-up do Facebook.
​

4. Pode clicar em OK no ecrã seguinte para fechar a janela pop-up.
​

Parabéns! A sua conta WhatsApp Business está agora ligada à sua conta Twilio. O Twilio iniciará o processo de registo do seu número no WhatsApp. Este processo pode demorar até 2 minutos.
​

Após o registo bem sucedido, o seu número será apresentado. Pode clicar em Edit Sender para utilizar um serviço de mensagens e atualizar o resto do seu perfil do WhatsApp Business, incluindo a sua imagem de perfil.
​

Se ainda não tiver concluído a verificação do Meta Business, o seu acesso ao WhatsApp será limitado no início. Se já tiver concluído a verificação do negócio, terá acesso total ao WhatsApp.
​

Para integrar números adicionais, é necessário repetir este processo, tendo o cuidado de selecionar a mesma conta Meta Business Manager e a mesma conta WhatsApp Business. O Meta Business Manager e a conta WhatsApp Business atualmente ligados à sua conta Twilio são apresentados na Consola Twilio.
​

Nota: até concluir a verificação do Meta Business, alguns números podem permanecer num estado pendente e não podem ser utilizados para enviar mensagens. Depois de concluir a verificação do Meta business, poderá ser necessário eliminar os WhatsApp sender e repetir o processo para os integrar completamente.
​

Para criar um Serviço de mensagens, aceda a Messaging > Serviços e clique em Create Messaging Service.
​

Passo 1. Preencha os seguintes campos:
​

Messaging Service friendly name - invente um nome para o seu Messaging Service (por exemplo, Conversas sobre ordens)
​

Select what you want to use Messaging for - escolha o objetivo que melhor se adequa às suas conversas.
​

Clique em Create Messaging Service.
​

Passo 2. Clique em Add senders, selecione WhatsApp Number e escolha o número para o qual pretende ativar o Serviço de Mensageiros. Pode personalizar ainda mais o número selecionado.
​

Sticky Sender - assegura a consistência para os destinatários das mensagens, selecionando o mesmo número de telefone De que utilizou anteriormente na conversa com um determinado cliente.
​

Area Código Geomatch - Utiliza números de telefone locais com códigos de área que correspondem ou sobrepõem o número de telefone do destinatário quando envia mensagens para os EUA e Canadá.
​

Estas funcionalidades estão activadas por predefinição. Para as desativar, clique no botão de alternância.
​

Também pode adicionar mais números se não tiver selecionado vários números no passo anterior, clicando no botão Add Senders, ou eliminar um número já adicionado, clicando em Remove junto ao mesmo.
​

Selecione os números que pretende configurar e clique em Passo 3. Set up integration.
​

Passo 3. Neste passo, tem de configurar webhooks para automatizar processos e sincronizar dados entre as suas contas Twilio e RemOnline.
​

Selecione a opção Use webhooks e cole as ligações necessárias nos campos seguintes:

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp/status
​

A opção HTTP Post deve ser activada junto aos campos Request URL e Fallback URL.
​

Recomendamos que deixe o valor predefinido de 14400 no campo Validity period. O período de validade refere-se ao número de segundos durante os quais as mensagens enviadas a partir do seu serviço de mensagens permanecerão na plataforma do Twilio. Se o tempo necessário para enviar a mensagem exceder o Período de validade, o Twilio falha a mensagem e envia um pedido para o seu URL de retorno de chamada de status para notificar a sua aplicação da falha.
​

Para continuar, clique em Passo 4: Add compliance info.
​

Passo 4. Adicionar informações de conformidade. Isto pode ser feito através do registo no A2P 10DLC (Código de 10 dígitos) nos Estados Unidos.
​

Trata-se de um sistema nos Estados Unidos que permite às empresas enviar mensagens de aplicação a pessoa (A2P) utilizando números de telefone de 10 dígitos (10DLC). O registo para mensagens A2P melhorará a qualidade da entrega e reduzirá a filtragem.

Para concluir a criação do serviço de mensagens, clique em Complete Messaging Service Setup.
​

Um passo importante na configuração da sua conta Twilio é configurar a Autenticação Básica HTTP na sua conta Twilio para que a receção de media funcione corretamente.
​

Para tal, vá a Messaging > Settings > General > HTTP Basic Authentication for media access, selecione a opção Disabled e clique em Save na parte inferior da página para guardar as alterações.
​

Já está feito! O último passo é ligar-se ao RemOnline, após o que poderá utilizar o WhatsApp para comunicar com os seus clientes.
​

1. No painel do Twilio, vá para a secção Account Info. Aqui encontra o Account SID e o Auth Token de que necessita para se ligar às conversas do RemOnline. Copie essas informações.
​

2. De seguida, vá a Messaging > Services e encontre o Messaging Service que criou. Copie o seu Sid.
​

3. No RemOnline, vá a Configurações > Conversas e clique em + Canal. Selecione o recurso WhatsApp by Twilio.
​

4. Preencha todos os campos:
​

Nome do canal - crie um nome para o seu canal WhatsApp que irá utilizar para comunicar com os clientes.
​

Account SID - cola o código Account SID copiado da tua conta Twilio.
​

Importante: se um canal com um SID de conta idêntico já estiver ligado por outra empresa, o sistema não permite ligar um novo canal com o SID de conta no RemOnline. Para resolver este problema, é necessário eliminar a integração existente noutra empresa e, em seguida, adicionar um canal com este SID de conta ao RemOnline.
​

Token de autenticação - cole aqui o código do Token de autenticação copiado da sua conta Twilio.
​

Número de telefone - introduza o número de telefone que registou no Twilio e que irá utilizar para comunicar com os clientes.

Sid do serviço de mensagens - aqui tens de colar o código Sid do serviço de mensagens copiado da página do serviço de mensagens.
​

5. Configure o Acesso ao canal:
​

Todos - todos os funcionários da empresa terão acesso às Configurações da conversa, desde que esse acesso seja permitido pelo sistema;
​

Selecionados - apenas os funcionários selecionados terão acesso às Configurações da conversa, desde que autorizados pelo sistema;
​

Proprietário - somente o proprietário da empresa terá acesso às configurações.
​

Para alterar as definições de acesso dos funcionários às definições da Conversa e do Chat, aceda a Configurações > Funcionários > Funções e edite as definições necessárias.
​

6. Clique em Criar.
​

Já está feito! Agora já pode conversar com os clientes através do WhatsApp diretamente no RemOnline. Mais informações sobre como usar os modelos do WhatsApp no RemOnline podem ser encontradas aqui.
​

O preço do WhatsApp é calculado com base na taxa de preço baseada em conversação do Meta e na taxa por mensagem do Twilio.
​

As primeiras 1000 conversas por mês são gratuitas, desde que ocorram nas primeiras 24 horas após a receção de uma mensagem de um utilizador. Quaisquer conversas iniciadas após esse período são cobradas.
​

Por exemplo, $0,015 por cada conversa e $0,005 por cada mensagem de um número dos EUA.
​

Assim, o custo total da utilização do WhatsApp inclui a taxa por conversação da Meta e a taxa por mensagem da Twilio. Para obter mais informações sobre os preços do WhatsApp da Twilio, clique aqui.